Commit graph

210 commits

Author SHA1 Message Date
srinivasreddy
9bf73d24d0 Explained the difference between ownership iteration and reference iteration 2016-03-02 09:36:30 +05:30
bors
d56677a187 Auto merge of #31931 - Luke-Nukem:master, r=steveklabnik
Refinement of paragraph referenced by [this issue](https://github.com/rust-lang/rust/issues/31927).

The paragraph in question had been adjusted already, but I've made some further clarifications which should help with readability and not leave the reader any `dangling pointers`.
2016-02-27 20:26:59 +00:00
Kevin Stock
9eda98a587 Resolve ambiguous documentation
See http://www.ietf.org/rfc/rfc2119.txt
2016-02-27 08:26:42 -05:00
Luke Jones
edd5f3328b Refinement of paragraph referenced by [this
issue](https://github.com/rust-lang/rust/issues/31927)
2016-02-27 14:41:38 +13:00
Manish Goregaokar
4cfa2ee2f1 Rollup merge of #31827 - teoryn:patch-1, r=brson 2016-02-25 15:06:06 +05:30
Manish Goregaokar
b660ca59ff Rollup merge of #31870 - ivan:filter-explain, r=steveklabnik
As a Rust newbie, I found the book's explanation for why the `filter` closure gets a reference very confusing, and tried to figure out why `filter` is somehow less consumptive than `map` -- but it isn't; that's controlled by `iter`/`into_iter`.  I flailed around for a while until @habnabit explained it to me, and in retrospect it is quite obvious :-)
2016-02-25 04:21:11 +05:30
Ivan Kozik
7042c8ef8d book: Explain better why the filter closure gets a reference 2016-02-24 20:09:01 +00:00
Florian Hahn
145190bd2a Capitalize some occurences of Rust in documentation 2016-02-24 19:56:28 +01:00
Kevin Stock
b49ce1a599 Fix warn(unused_mut) in example 2016-02-22 22:37:02 -05:00
Chad Shaffer
6e985934bd Fix number of lines and methods in guessing game 2016-02-20 17:00:54 -08:00
Steve Klabnik
9f0e39ba16 Rollup merge of #31565 - SDX2000:docfixes4, r=steveklabnik
See title and diff for more information.
2016-02-17 18:14:35 -05:00
Sandeep Datta
1536195ce6 Made v2 mutable so that we can actually truncate it. 2016-02-17 20:47:24 +05:30
Dirk Gadsden
f2bea1cb70 Clarify contiguous memory array structure of vectors in documentation
Closes #31554.

Contributes to #29380.
2016-02-16 04:10:30 +05:30
Steve Klabnik
fb09a441c6 Rollup merge of #31658 - felgru:master, r=steveklabnik
In the Rust code above this block of compiler output, the function is called print_sum, so use the same function name in the error message.
2016-02-14 18:02:32 -05:00
Felix Gruber
3eebec697c doc: fix compiler output
In the Rust code above, the function is called print_sum, so use the
same function name in the error message.
2016-02-14 20:50:12 +01:00
fbergr
310ab5ea74 doc: Remove trailing whitespace 2016-02-14 14:31:20 +02:00
Manish Goregaokar
34d95f498c Rollup merge of #31612 - raindev:grammar, r=steveklabnik
I feel sorry for bothering you with such a literally one character changes. If it is counter productive feel free to point it out in the comments, that would be totally understandable. I could try to pack such a changes together in one PR to make them less distractive.

r? @steveklabnik
2016-02-14 05:06:35 +05:30
Manish Goregaokar
8873732585 Rollup merge of #31610 - Manishearth:doc-clarify-txrx, r=steveklabnik
Not everyone knows this convention. We could just rename the variables in the
example, but since this notation is commonly used it's a good opportunity to
introduce it.

r? @steveklabnik
2016-02-14 05:06:35 +05:30
Manish Goregaokar
1598995766 Rollup merge of #31563 - SDX2000:docfixes1, r=steveklabnik
This is a minor change. Please see title. IMO this is important since this is the first instance when we talk about allocating a vector. Not saying that it is allocated on the stack here leaves room for speculation and this might put off some people (they might not even read the later sections which go into more detail about this).
2016-02-14 05:06:33 +05:30
Sandeep Datta
37a952a672 Fixed build error as per steveklabnik's suggestion and expanded on the ills of doing out of bounds accesses. 2016-02-13 18:40:24 +05:30
Andrew Barchuk
eb0f9f81f0 Remove unnecessary article 2016-02-12 21:40:02 +02:00
Manish Goregaokar
9ec112749b Clarify what tx/rx mean in concurrency docs 2016-02-13 00:57:52 +05:30
Sandeep Datta
a6fedc85bf Minor change. 2016-02-11 19:55:45 +05:30
Sandeep Datta
a8fd1bbd2f Minor change. 2016-02-11 19:44:33 +05:30
Sandeep Datta
50d179e062 Explained the data race with an example. 2016-02-11 19:40:19 +05:30
Sandeep Datta
62b3b40ade Clarified move semantics in "the details" section. 2016-02-11 12:30:53 +05:30
Sandeep Datta
8f61a4b34c Added a few words to indicate where the vector object is created. 2016-02-11 11:16:47 +05:30
Oliver Middleton
cff81d724f Fix documentation example in the book
The code sections shouldn't be inside a ```text block.
2016-02-10 17:19:27 +00:00
Steve Klabnik
6571ae28a8 Rollup merge of #31514 - cgar:spelling, r=alexcrichton 2016-02-09 16:58:59 -05:00
Carlos E. Garcia
02aa0aff2f Minor spelling fixes 2016-02-09 11:52:39 -05:00
Andrew Barchuk
422cf2d34a Clean up Error Handling case study examples
Remove unnecessary cloning and conversions. Expand tabs left in examples.
2016-02-07 23:08:46 +02:00
Simonas Kazlauskas
432460a6fc Synthesize calls to box_free language item
This gets rid of Drop(Free, _) MIR construct by synthesizing a call to language item which
takes care of dropping instead.
2016-02-04 15:56:01 +02:00
Manish Goregaokar
1a21dabf27 Rollup merge of #31366 - paulsmith:patch-1, r=steveklabnik
The context of the link is `Result` but it points to the docs on `Option`'s `expect`.
2016-02-03 02:54:25 +05:30
Manish Goregaokar
86650211a9 Rollup merge of #31352 - steveklabnik:gh31154, r=nikomatsakis
Fixes #31154
2016-02-03 02:54:25 +05:30
Steve Klabnik
6c907212b4 Add note about temporaries 2016-02-02 11:15:45 -05:00
Paul Smith
b2e887f0aa Fix reference to expect
The context of the link is `Result` but it points to the docs on `Option`'s `expect`.
2016-02-02 08:47:23 -06:00
Steve Klabnik
c3f6122215 Rollup merge of #31348 - alexcrichton:shuffle-tiers, r=steveklabnik
Some other shufflings as well:

* Three powerpc triples for Linux have been added recently
* An armv7 linux triple was added recently
* The 64-bit Solaris triple is now mentioned in tier 3

We are currently now also building nightlies for iOS, powerpc triples, and
armv7, but there hasn't been much vetting of the triples themselves so I've left
them in tier 3 for now.
2016-02-02 00:32:20 -05:00
Steve Klabnik
5f0d8ea1bd Rollup merge of #31345 - kamalmarhubi:book-docs-special-section-errors, r=steveklabnik
This matches the usage in the standard library's documentation.
2016-02-02 00:32:19 -05:00
Steve Klabnik
9eb417b17f Rollup merge of #31344 - steveklabnik:gh31334, r=alexcrichton
Fixes #31334

This is just a quicker fix for this issue; since I'm working on the next draft of the book, I don't want to put a huuuge amount of work into improving it here.
2016-02-02 00:32:19 -05:00
Steve Klabnik
0b8c71379c Rollup merge of #31340 - pra85:patch-1, r=alexcrichton
Spelling mistake -
`familliar` > `familiar`
2016-02-02 00:32:19 -05:00
Steve Klabnik
78afc78d9d Rollup merge of #30971 - SDX2000:docfixes, r=steveklabnik
Updated documentation to clarify the difference between `and_then` and `map`. This also explains why we need `and_then` in addition to `map`. Please look at the diff for more information.

r?  @alexcrichton
2016-02-02 00:32:17 -05:00
Steve Klabnik
dc3a39d807 Explain behavior of _
Fixes #31154
2016-02-01 18:49:47 -05:00
Alex Crichton
0574b395ef doc: Move 32-bit MSVC to a tier 1 platform
Some other shufflings as well:

* Three powerpc triples for Linux have been added recently
* An armv7 linux triple was added recently
* The 64-bit Solaris triple is now mentioned in tier 3

We are currently now also building nightlies for iOS, powerpc triples, and
armv7, but there hasn't been much vetting of the triples themselves so I've left
them in tier 3 for now.
2016-02-01 12:53:38 -08:00
Kamal Marhubi
49fe519791 book: Change "Failures" to "Errors" in doc special sections chapter
This matches the usage in the standard library's documentation.
2016-02-01 12:26:51 -05:00
Steve Klabnik
7df3bf1860 make this example more obvious
Fixes #31334
2016-02-01 12:19:33 -05:00
Prayag Verma
2043cd8623 Fix typo in doc/book/getting-started.md
Spelling mistake -
`familliar` > `familiar`
2016-02-01 12:15:33 +05:30
Manish Goregaokar
f66d3c5566 Rollup merge of #31296 - steveklabnik:gh31249, r=alexcrichton
Rustdoc will automatically wrap things in main, but this doesn't work
here.

Fixes #31249
2016-01-30 17:57:17 +05:30
Manish Goregaokar
cf0f7a30f4 Rollup merge of #31295 - steveklabnik:gh31266, r=alexcrichton
These are free functions in the text, but methods in the standard
library.

Fixes #31266
2016-01-30 17:57:17 +05:30
Sandeep Datta
0922d7e68f Ignoring demo code with compilation error. 2016-01-30 13:43:02 +05:30
Steve Klabnik
919ea47356 Add main() so that examples work
Rustdoc will automatically wrap things in main, but this doesn't work
here.

Fixes #31249
2016-01-29 17:53:35 -05:00