bors
26a5c9768b
auto merge of #7077 : SiegeLord/rust/new_css, r=pnkfelix
...
I was making documentation for my own little Rust project, and I was somewhat unhappy with how the documentation looked. While many of the issues are endemic to how rustdoc generates its output, you can get pretty far in making the documentation readable by using a better CSS style.
This commit alters the CSS style used in Rust's documentation in order to make the various sections stand out more. You can see an example of its usage in my own project's documentation: http://siegelord.github.io/RustGnuplot/#implementation-for-figureself-where-self . I showed it to some people on IRC and they suggested that I make a pull request here. I tested it on the only browser that matters, but also Chrome and Opera.
2013-06-12 15:31:39 -07:00
Huon Wilson
3ac00a9489
std: remove substr & str::count_*, methodise char_len, implement slice_chars.
...
The confusing mixture of byte index and character count meant that every
use of .substr was incorrect; replaced by slice_chars which only uses
character indices. The old behaviour of `.substr(start, n)` can be emulated
via `.slice_from(start).slice_chars(0, n)`.
2013-06-12 12:21:04 +10:00
SiegeLord
d641b0b575
Alter rust.css to make the documentation look more appealing
2013-06-11 20:43:26 -04:00
Huon Wilson
7e6a5940cb
std: convert pow, hypot, atan2, log to take arguments by reference.
2013-06-11 11:36:03 +10:00
Huon Wilson
e8782eeb63
fix tests, remove some warnings
2013-06-11 02:34:14 +10:00
Huon Wilson
a64e886e3c
std: remove str::contains in favour of the method
2013-06-10 23:02:55 +10:00
Huon Wilson
c32fb53cf9
std: remove str::{len, slice, is_empty} in favour of methods.
2013-06-10 23:02:54 +10:00
Daniel Micay
de367157b5
remove deprecated vec::{is_empty, len} functions
2013-06-08 23:19:30 -04:00
Huon Wilson
513d2292e5
std: remove foldr and alli methods in vec
2013-06-09 02:22:23 +10:00
Huon Wilson
ed299af625
std: remove fold[lr] in favour of iterators
2013-06-09 02:22:23 +10:00
bors
1cf57f7b67
auto merge of #7003 : alco/rust/tutorial-block-expr, r=bstrie
...
This is something that's only been briefly mentioned in the beginning of
the tutorial and all of the closure examples within this subsection
include only one expression between { and }.
2013-06-07 23:40:25 -07:00
Alexei Sholik
93b2ddfc88
A reminder that a block is a single expr in closures
...
This is something that's only been briefly mentioned in the beginning of
the tutorial and all of the closure examples within this subsection
include only one expression between { and }.
2013-06-08 04:10:50 +03:00
Alexei Sholik
83b68a2f69
Mention for
in the section on loops
...
The "4.3 Loops" section only describes `while` and `loop`. We then see `for`
used in a code sample at the end of the "13. Vectors and strings" section,
but it's explained for the first time only in the next section --
"14. Closures".
It is worth mentioning it in "4.3 Loops".
2013-06-08 03:17:56 +03:00
Ramkumar Ramachandra
dd923e3831
tutorial: fix for-loop example
...
Although in the example function `each` works as expected with
rust-0.6 (the latest release), it fails to even compile with `incoming`
rust (see test/compile-fail/bad-for-loop-2.rs). Change the function to
return a `bool` instead of `()`: this works fine with both versions of
rust, and does not misguide potential contributors.
Signed-off-by: Ramkumar Ramachandra <artagnon@gmail.com>
2013-06-06 19:43:16 +05:30
Alexei Sholik
c7b19b04cb
Fix duplicate words in the docs
2013-06-06 10:43:58 +03:00
Patrick Walton
8114d0e950
librustc: Disallow multiple patterns from appearing in a "let" declaration.
...
You can still initialize multiple variables at once with "let (x, y) = (1, 2)".
2013-06-04 21:45:42 -07:00
Tim Chevalier
5b09dca90b
docs: Mention recently-added rustpkg features in the rustpkg manual
2013-06-02 17:21:01 -07:00
Daniel Micay
ed93cc1987
fix tutorial lint warnings
2013-05-31 18:20:09 -04:00
Daniel Micay
29aba8033a
mv the raw pointer {swap,replace}_ptr to std::ptr
2013-05-31 10:31:26 -04:00
Gábor Horváth
0d9ea4e2d1
Minor grammar fix.
2013-05-30 15:26:25 +02:00
Gábor Horváth
9fd18a93b7
Minor style fix.
2013-05-30 15:24:08 +02:00
Gábor Horváth
e583d5a6b6
Minor documentation addition.
2013-05-30 15:20:30 +02:00
bors
31b2804fda
auto merge of #6825 : caitp/rust/issue-6824, r=Aatch
...
Show `int_suffix_size` to appear 0 or 1 times
Show `exponent | . dec_lit` to appear 0 or 1 times, to show why `3f;` is a valid number
2013-05-29 22:58:35 -07:00
Caitlin Potter
bfe141c4e1
Fixes #6824 - Correct scan_number() grammar
...
Show `int_suffix_size` to appear 0 or 1 times
Show `exponent | . dec_lit` to appear 0 or 1 times, to show why `3f;` is a valid number
2013-05-30 00:51:16 -04:00
Patrick Walton
206ab89629
librustc: Stop reexporting the standard modules from prelude.
2013-05-29 19:04:53 -07:00
Olivier Saut
dea6677251
Add a short section on ARC
2013-05-26 19:10:16 +02:00
bors
5787bf3093
auto merge of #6711 : catamorphism/rust/issue-5700, r=thestinger
...
r? @nikomatsakis
2013-05-24 01:04:40 -07:00
Tim Chevalier
248a669381
docs: Don't mention obsolete move operator, as per #5700
2013-05-23 20:27:56 -07:00
Erick Tryzelaar
cc4fabcb43
Fix some std/extra language in the tutorial
2013-05-23 17:58:30 -07:00
Ted Horst
34cfd2183b
more testing fallout from core->std/std->extra move
2013-05-23 15:06:29 -05:00
Corey Richardson
acf920fe4b
Add static_assert doc blurb
2013-05-22 13:13:29 -04:00
John Clements
b71a1ecea2
added and rewrote text for 'do' and 'for' loops
2013-05-20 11:49:21 -07:00
bors
9f671698e6
auto merge of #6106 : thestinger/rust/iter, r=bstrie
...
I don't have a strong opinion on the function vs. method, but there's no point in having both. I'd like to make a `repeat` adaptor like Python/Haskell for turning a value into an infinite stream of the value, so this has to at least be renamed.
2013-05-19 08:13:30 -07:00
Daniel Micay
d953a5ce43
replace old_iter::repeat with the Times trait
2013-05-18 04:57:21 -04:00
Olivier Saut
3e41639a5e
Add a small section on futures to the tutorial
2013-05-17 23:11:49 +02:00
Huon Wilson
cd2eb4701f
syntax: implement #[deriving(DeepClone)]. Fixes #6514 .
2013-05-16 22:55:08 +10:00
bors
2fc6b0998b
auto merge of #6475 : sonwow/rust/tutorials, r=brson
2013-05-14 19:08:19 -07:00
Björn Steinbrink
bdc182cc41
Use static string with fail!() and remove fail!(fmt!())
...
fail!() used to require owned strings but can handle static strings
now. Also, it can pass its arguments to fmt!() on its own, no need for
the caller to call fmt!() itself.
2013-05-14 16:36:23 +02:00
Youngsoo Son
0c082047bc
Replace shared/unique by managed/owned in the tutorial
2013-05-14 22:25:55 +09:00
bors
3abc5b3ffb
auto merge of #6417 : pcwalton/rust/exprs-in-patterns, r=pcwalton
...
r? @graydon
2013-05-13 13:25:42 -07:00
Huon Wilson
d43908a3a7
doc: document the #[deriving] attribute.
...
Closes #4916 .
2013-05-13 20:04:03 +10:00
Patrick Walton
06ef889cdc
libsyntax: Remove extern mod foo { ... }
from the language.
2013-05-12 16:33:15 -07:00
bors
9ee8d506d9
auto merge of #6398 : osaut/rust/master, r=bstrie
...
I have replaced io::println by println in the tutorial as I do not think it is needed anymore since it is already included in prelude.rs.
2013-05-11 15:10:44 -07:00
Alex Crichton
60803e5fc8
Fix tests with the swap operator
2013-05-10 22:51:06 -04:00
Alex Crichton
63c7e2f991
Remove the '<->' operator from the language
2013-05-10 22:51:06 -04:00
Olivier Saut
017e7e8be1
Replace io::println by println as it is now included in prelude.rs
2013-05-10 21:12:11 +02:00
Daniel Micay
044abef0e5
fix incorrect region code based on the old 'self
...
also removes unnecessary casts from the RcMut implementation
2013-05-08 16:00:49 -04:00
Daniel Micay
8f2d71ac00
small fix to the tutorial-ffi destructor example
...
The previous example was erroneously attempting to destroy
uninitialized memory, which was often zeroed (masking the bug).
2013-05-04 21:57:10 -04:00
Daniel Micay
86efd97a10
add gitattributes and fix whitespace issues
2013-05-03 20:01:42 -04:00
Brendan Zabarauskas
ee26c7c433
Revert rename of Div to Quot
2013-05-01 15:40:05 +10:00
Jed Davis
4701716b56
Revert "doc: XFAIL mysterious failure on bots"
...
This reverts commit 2c6dae081b
.
2013-04-30 12:07:10 -07:00
Patrick Walton
2c6dae081b
doc: XFAIL mysterious failure on bots
2013-04-29 14:30:57 -07:00
Patrick Walton
670ab8ac36
librustc: Change labels to use the lifetime notation '
.
2013-04-29 14:30:57 -07:00
ILYONG CHO
9d33008da1
tutorial: Fix 'self' to 'Self'
2013-04-29 17:59:25 +09:00
Daniel Micay
46f91a0fa9
make way for a new iter module
2013-04-28 22:31:39 -04:00
Daniel Micay
195911fca4
tutorial-ffi: add example of a custom destructor
2013-04-26 14:07:57 -04:00
Daniel Micay
721e1143a5
tutorial: rework the section on destructors
...
This removes the comparison to manual memory management examples,
because it requires too much existing knowledge. Implementing custom
destructors can be covered in the FFI tutorial, where `unsafe` is
already well explained.
2013-04-26 14:07:47 -04:00
Marvin Löbel
3759b5711d
Fixed typo... And a billion other things.
2013-04-24 22:28:02 +02:00
Tim Chevalier
4508da226a
rustpkg: In doc, mention other implicit RUST_PATH entries
...
as per Graydon's comment
2013-04-22 18:17:32 -07:00
Tim Chevalier
d834c0d59d
docs: Sketch out rustpkg manual
2013-04-22 18:17:32 -07:00
Brendan Zabarauskas
01eb5e8ad3
Rename Div operator trait to Quot and Modulo operator trait to Rem
2013-04-22 01:58:53 +10:00
Dan Luu
69f6ac5d31
Fix debug! usage in tutorial
2013-04-19 19:17:34 -04:00
Brian Anderson
decd3901d5
core::comm: Modernize constructors to use new
2013-04-18 14:07:35 -07:00
Dan Luu
7373c64a4c
Explain use of debug\! in tutorial
2013-04-17 11:51:43 -04:00
bors
8b74efaa7b
auto merge of #5852 : thestinger/rust/ffi, r=thestinger
2013-04-12 03:37:00 -07:00
Daniel Micay
53d2228b37
tutorial-ffi: add another missing word
2013-04-12 06:34:25 -04:00
Daniel Micay
a4db39a6fe
tutorial-ffi: add missing word
2013-04-12 03:15:07 -04:00
Daniel Micay
1faa3596b0
rewrite the ffi tutorial with snappy as an example
...
The example with OpenSSL is incorrect, because OpenSSL is using a
static variable for the return value and isn't thread-safe.
The gettimeofday example isn't great because it's not very portable.
2013-04-12 02:12:00 -04:00
bors
a425b75c64
auto merge of #5773 : dunsmoreb/rust/incoming, r=bstrie
...
Updates the tutorial to include a simple definition for tuples in section 4.2. Fixes #5132 .
2013-04-10 06:04:00 -07:00
Bryan Dunsmore
08bc392d94
Update destructuring to reference tuples section.
2013-04-10 07:06:18 -05:00
bors
786ae0114b
auto merge of #5782 : zofrex/rust/doc-1-tuples, r=thestinger
...
As per [the 0.6 release notes](https://github.com/mozilla/rust/wiki/Doc-detailed-release-notes#06-april-2013 ) single-element tuples are legal. I spotted a couple of places in the documentation that said otherwise, and propose these changes to them.
2013-04-08 16:22:03 -07:00
bors
c92936395c
auto merge of #5775 : pavpanchekha/rust/patch-1, r=thestinger
...
Change wrong field name in "Trait Inheritance" section.
2013-04-08 11:10:00 -07:00
Pavel Panchekha
c6d6782906
Fixed typo
...
Change wrong field name in "Trait Inheritance" section.
2013-04-07 23:19:31 -03:00
Bryan Dunsmore
f0d0cbfff8
Include definition of tuples for destructuring.
...
Updates the tutorial to include a simple definition for tuples in
section 4.2. Fixes #5132 .
2013-04-07 17:09:15 -05:00
zofrex
ac9e694d59
Update manual for single-element tuple types
2013-04-07 22:08:40 +01:00
zofrex
d1e2d295f8
Update manual for single-element tuples
2013-04-07 22:08:34 +01:00
zofrex
621d45b341
Update tutorial: 1-tuples now exist
2013-04-07 22:08:23 +01:00
bors
614d6da828
auto merge of #5721 : dhardy/rust/master, r=graydon
...
This is some stuff which seemed to be missing to me (though I haven't read everything yet so hope I haven't missed the relevant section).
A similar addition for borrowing handles is needed, but #5720 stumped me.
Comments welcome.
2013-04-05 18:54:52 -07:00
Diggory Hardy
e2a6feb8fe
Tutorial: spelling correction and move a failing test to an xfail-test marked code block.
2013-04-05 12:26:47 +02:00
Diggory Hardy
1e483c7b70
Tutorial: fix typo
2013-04-04 22:35:23 +02:00
Diggory Hardy
964fc862e0
Tutorial: comment on how mutability applies to boxes
2013-04-04 18:13:12 +02:00
bors
717ed51f12
auto merge of #5716 : dhardy/rust/master, r=thestinger
2013-04-04 06:12:49 -07:00
Diggory Hardy
cb91e91418
Tutorial: rename variable to avoid confusion.
2013-04-04 15:08:25 +02:00
bors
b5d8224212
auto merge of #5713 : brson/rust/tutorial2, r=thestinger
...
It doesn't quite reflect reality
2013-04-04 02:18:47 -07:00
bors
1dc330c313
auto merge of #5707 : brettcannon/rust/patch-1, r=thestinger
...
The sentence "Remember that `(float, float)` is a tuple of two floats"
sounds like you've already read a section on tuples, but that section
comes later. Changing it to "Assuming that ..." makes it more about
taking the writer's word that the syntax is how tuples are defined.
2013-04-04 01:21:50 -07:00
bors
21de574625
auto merge of #5703 : steveklabnik/rust/add_log_docs, r=thestinger
...
Closes #5699 .
2013-04-04 00:18:45 -07:00
Brian Anderson
679b1dcb62
doc: Rewrite task tutorial intro
...
It doesn't quite reflect reality
2013-04-03 22:54:58 -07:00
bors
aa899c97d9
auto merge of #5710 : ajuckel/rust/patch-1, r=luqmana
...
One word typo fix
2013-04-03 22:30:45 -07:00
Anthony Juckel
e2c7a4def2
Simple typo fix
2013-04-03 19:10:09 -05:00
Steve Klabnik
a7f0bfbda6
One more typo: dubug -> debug
2013-04-03 16:59:13 -07:00
Brett Cannon
8dd5a70ef4
Update tut. to not sound like I missed a section
...
The sentence "Remember that `(float, float)` is a tuple of two floats"
sounds like you've already read a section on tuples, but that section
comes later. Changing it to "Assuming that ..." makes it more about
taking the writer's word that the syntax is how tuples are defined.
2013-04-03 18:52:28 -03:00
Steve Klabnik
3044f5e2b6
typo fix: na -> an
2013-04-03 12:44:41 -07:00
Steve Klabnik
d79b22474c
Add information about logging macros to the tutorial.
...
Closes #5699 .
2013-04-03 11:40:23 -07:00
Daniel Micay
cc148b58ff
rename Linear{Map,Set} => Hash{Map,Set}
2013-04-03 10:30:36 -04:00
Daniel Micay
44029a5bbc
hashmap: rm linear namespace
2013-04-03 10:30:18 -04:00
bors
2815742ba5
auto merge of #5669 : graydon/rust/tweaks, r=thestinger
...
Just some minor cleanup of version strings and copyrights.
2013-04-01 18:00:43 -07:00
Graydon Hoare
951f460aa8
tidy version numbers and copyright dates
2013-04-01 16:15:49 -07:00
bors
d1935898ed
auto merge of #5662 : catamorphism/rust/docs, r=catamorphism
...
r? @brson
2013-04-01 16:03:47 -07:00
Tim Chevalier
ce09645591
docs: Xfail test, it's just for illustration anyway
2013-04-01 15:21:22 -07:00
Brian Anderson
243e601e51
doc: Update tutorial description of core
2013-04-01 14:30:14 -07:00