1224 Commits

Author SHA1 Message Date
Alex Crichton
07132b499f doc: Add a link to LLVM's new inline assembly docs
Hot off the press, we've now got some nice documentation to link to in LLVM
officially!
2015-07-13 10:08:09 -07:00
Frank McSherry
d673bdef0f minor grammatical update
Grammatical update (and passive -> active, but I'm not sure if "Rust" is often used as a subject in the book; feel free to revert that part for style, but keep the subject-verb agreement)
2015-07-13 17:22:08 +02:00
Pavel Pravosud
49e45833f8 Clean up trailing whitespaces 2015-07-12 11:23:09 -07:00
Pavel Pravosud
6e1d01f79e Fix multi-threading example in dining-philosophers 2015-07-12 11:22:52 -07:00
Steve Klabnik
1ae7702681 TRPL: make version constraits explicit
We weren't explicit enough about Cargo's default version behavior.

For rust-lang/rust at least,

Fixes #26482
2015-07-08 13:09:22 -04:00
Steve Klabnik
b6c7dff728 Rollup merge of #26855 - steveklabnik:gh26344, r=alexcrichton
Fixes #26344
2015-07-07 09:49:56 -04:00
Steve Klabnik
743a9e6cae Rollup merge of #26854 - steveklabnik:gh26345, r=alexcrichton
I am not mentioning #[unsafe_drop_flag] because it should go away
eventually, and also because it's just an attribute, it's not
really a use of the `unsafe` keyword.

Fixes #26345
2015-07-07 09:49:56 -04:00
Steve Klabnik
10c795a6ea Rollup merge of #26853 - steveklabnik:gh26346, r=Gankro
This incorrectly implied that doing things is fine in unsafe code

Fixes #26346
2015-07-07 09:49:55 -04:00
Steve Klabnik
bc28e64fb3 Re-word UB in unsafe guide
This incorrectly implied that doing things is fine in unsafe code

Fixes #26346
2015-07-07 12:52:20 -04:00
Steve Klabnik
4b19be3631 Not literally all of concurrency is a library
Fixes #26344
2015-07-07 09:29:04 -04:00
Steve Klabnik
73df19a206 There are four uses of unsafe, actually
I am not mentioning #[unsafe_drop_flag] because it should go away
eventually, and also because it's just an attribute, it's not
really a use of the `unsafe` keyword.

Fixes #26345
2015-07-07 09:26:23 -04:00
Steve Klabnik
f29b565e2d Describe lifetime syntax for impl
Fixes #26375
2015-07-07 09:19:26 -04:00
Steve Klabnik
015441bd5d Rollup merge of #26827 - steveklabnik:gh25786, r=alexcrichton
Fixes #25786
2015-07-06 18:06:30 -04:00
Steve Klabnik
aef38ef819 Rollup merge of #26761 - steveklabnik:actually_ub, r=alexcrichton
I incorrectly stated that it's an abort.

r? @Gankro
2015-07-06 18:06:29 -04:00
Steve Klabnik
ee43c5e2f0 FFI panic is UB
I incorrectly stated that it's an abort.
2015-07-06 16:00:31 -04:00
Steve Klabnik
fb6eeb6ce8 Document _ in bindings
Fixes #25786
2015-07-06 12:27:32 -04:00
Liigo Zhuang
03afbf93ed book: introduce //! doc comment in comments section
Closes #26801
2015-07-06 14:55:06 +08:00
Vladimir Rutsky
dbaaa2c6a4 remove terminating dot from caption 2015-07-01 02:34:01 +03:00
Vladimir Rutsky
aacb5f68bf add missing colon 2015-07-01 02:31:49 +03:00
Steve Klabnik
bac361558e Rollup merge of #26580 - adamheins:master, r=steveklabnik
I found a sentence that felt a bit awkward to read in its current form, so I added a comma to break it up.
2015-06-30 15:37:44 -04:00
Steve Klabnik
96dd82ff9c Rollup merge of #26506 - tshepang:doc-fix, r=steveklabnik 2015-06-30 15:37:44 -04:00
bors
f39df49bcd Auto merge of #26662 - steveklabnik:gh26661, r=alexcrichton
This is his own mirror, so it shouldn't go down, unlike the previous one.

Fixes #26661
2015-06-30 10:26:09 +00:00
Steve Klabnik
b1907a04e4 Update link to Ousterhout
This is his own mirror, so it shouldn't go down, unlike the previous one.

Fixes #26661
2015-06-29 17:06:23 -04:00
bors
f9b6929f46 Auto merge of #26623 - Saser:master, r=steveklabnik
In Chapter 5.9 (References and Borrowing), there is an example [at the very end](https://doc.rust-lang.org/stable/book/references-and-borrowing.html#use-after-free) which shows that declaring a reference before declaring the variable that it points to results in a compilation error. The book does not really mention why this happens though -- in the sections before, it has described how different scopes affects the lifetime of resources, but there is no mention of how resources within the same scope work.

This confused me a little, so I asked on #rust and got the answer that the resources are destroyed in the reverse order that they are declared, but the book makes no mention of it (as far as I can find) -- except in Chapter 5.21 (Drop), where it says:

> When `x` goes out of scope at the end of `main()`, the code for `Drop` will run. `Drop` has one method, which is also called `drop()`. It takes a mutable reference to `self`.
> 
> That’s it! The mechanics of `Drop` are very simple, but there are some subtleties. For example, values are dropped in the opposite order they are declared. [...]

---

I feel like Chapter 5.9 (References and Borrowing) is probably the best place to put this information (as I have done in my additions), since it deals with other types of referencing and borrowing. However, since English is not my native language, the wording of my additions perhaps are a little "off" -- any feedback on them is appreciated.
2015-06-29 19:19:31 +00:00
Christian Persson
d6159b7fe0 Clarifying deallocation order of resources within same scope 2015-06-27 16:58:18 +02:00
Alexis Beingessner
9001da658a make book match reference 2015-06-26 12:06:05 -07:00
Adam Heins
35abf86a1b Improve sentence flow. 2015-06-25 19:29:23 -04:00
Brody Holden
165a2817a4 Replace std::comm reference with std::sync::mpsc.
The FFI documentation references std::comm. Replace with
std::sync::mpsc.

Also wrap the line.
2015-06-24 20:08:55 -07:00
bors
d278632fef Auto merge of #26528 - brson:papers, r=alexcrichton
This adds all papers that mention Rust that I'm aware of. Includes some undergrad work.
2015-06-24 10:29:26 +00:00
bors
eeeda89e55 Auto merge of #26526 - djc:patch-1, r=steveklabnik
In particular, I found that the disclaimer (promised in the second paragraph) doesn't stand out right now. I think the extra headers help with scanning this document, and making it easier to discern which steps are relevant to my particular flow through the options.
2015-06-24 05:53:19 +00:00
bors
2d0cbf3e3e Auto merge of #26509 - tshepang:4-and-not-3, r=bluss 2015-06-24 02:51:13 +00:00
Brian Anderson
913c51ab17 doc: Add newest Rust papers 2015-06-23 13:59:43 -07:00
Dirkjan Ochtman
5027c9f0d1 Add some more headers to installation documentations
In particular, I found that the disclaimer (promised in the second paragraph) doesn't stand out right now. I think the extra headers help with scanning this document, and making it easier to discern which steps are relevant to my particular flow through the options.
2015-06-23 21:31:07 +02:00
bors
27ecbba388 Auto merge of #26508 - tshepang:stray-code-block, r=bluss 2015-06-23 17:27:07 +00:00
Jake Hickey
deee268015 Use a more descriptive variable name.
I'm currently reading the rust book and this variable name tripped me up.
Because it was called "input", I thought at first it might contain the line
read by read_line(). This new variable name will be more instructive to rust
beginners.
2015-06-22 18:48:50 -04:00
Tshepang Lekhonkhobe
f8158122c5 book: there are 4 special sections 2015-06-22 20:32:56 +02:00
Tshepang Lekhonkhobe
7a0a69f801 book: remove a stray code block 2015-06-22 20:14:27 +02:00
Tshepang Lekhonkhobe
e13077f7f0 book: whitespace 2015-06-22 19:29:34 +02:00
Tshepang Lekhonkhobe
0adda45c04 book: fix sentence 2015-06-22 19:29:29 +02:00
Steve Klabnik
24c1e109cc TRPL: FFI: address panics
Fixes #26443
2015-06-20 14:18:28 -04:00
bors
37cc79f81c Auto merge of #26315 - steveklabnik:gh26287, r=alexcrichton
The font can make this hard to read, and we don't even strictly need
the annotation, so let's just remove it

Fixes #26287
2015-06-17 18:09:10 +00:00
bors
4806210db9 Auto merge of #26318 - steveklabnik:gh26268, r=alexcrichton
Fixes #26268
2015-06-16 08:20:57 +00:00
bors
00382a592b Auto merge of #26317 - steveklabnik:gh25956, r=alexcrichton
It isn't really neccesary, but is pretty dense.

Fixes #25956
2015-06-16 06:44:56 +00:00
bors
906ad72462 Auto merge of #26311 - jooert:fix25855, r=steveklabnik
Use result of the computation to prevent the compiler from optimising
too much. Change `_x` to `x` and therefore remove the paragraph about
the underscore.

Fixes #25855.

r? @steveklabnik
2015-06-15 23:48:39 +00:00
Steve Klabnik
1792ef6ae4 Clarify that the following will error
Fixes #26268
2015-06-15 13:18:07 -04:00
Steve Klabnik
75ffcd8e59 Remove confusing paragraph from Trait Objects
It isn't really neccesary, but is pretty dense.

Fixes #25956
2015-06-15 13:16:16 -04:00
Johannes Oertel
3e7ab1b5cb Update example in "Rust Inside Other Languages"
Use result of the computation to prevent the compiler from optimising
too much. Change `_x` to `x` and therefore remove the paragraph about
the underscore.

Fixes #25855.
2015-06-15 19:12:34 +02:00
Steve Klabnik
3db26db24a remove confusing 1i32
The font can make this hard to read, and we don't even strictly need
the annotation, so let's just remove it

Fixes #26287
2015-06-15 12:42:07 -04:00
Manish Goregaokar
e7c10d5d31 Rollup merge of #26257 - Tonkpils:patch-1, r=alexcrichton 2015-06-13 18:03:55 +05:30
Manish Goregaokar
2b8e80914a Rollup merge of #26256 - steveklabnik:gh25915, r=alexcrichton
Fixes #25915
2015-06-13 18:03:55 +05:30