Commit Graph

788 Commits

Author SHA1 Message Date
Brian Anderson
201039cf0d tutorial: Discuss the primitive types along with their literals 2012-12-20 16:32:43 -08:00
Brian Anderson
107b2e5348 tutorial: It doesn't matter that Rust identifiers are the same as C 2012-12-20 16:32:43 -08:00
Brian Anderson
36e2c100bf tutorial: Integrate constants into main intro text 2012-12-20 16:32:43 -08:00
Brian Anderson
e06ca65244 tutorial: Remove the section on constants
We can mention that constants are declared with 'const' in one line.
Don't need an entire section.
2012-12-20 16:32:42 -08:00
Brian Anderson
0b0b50aaae tutorial: Remove the entire 'Types' section
It's not interesting

/cc: #4217
2012-12-20 16:32:42 -08:00
Brian Anderson
64681213af tutorial: Remove mutable vector syntax 2012-12-20 16:32:42 -08:00
Brian Anderson
e0f9f89c65 tutorial: Remove confusing discussion about semicolons
This takes up a lot of words and isn't very clear. The previous
discussion gets they idea across.

/cc: #4217
2012-12-20 16:32:42 -08:00
Brian Anderson
9cbc0fd0d9 tutorial: Fix formatting 2012-12-20 16:32:42 -08:00
Brian Anderson
a24b9e038a tutorial: update intro 2012-12-20 16:32:42 -08:00
Brian Anderson
f15ccc06f0 tutorial: Update for moves based on type
/cc: #4217
2012-12-20 16:32:42 -08:00
Brian Anderson
41870da5ad tutorial: Typos 2012-12-20 16:32:42 -08:00
Brian Anderson
191b328f31 tutorial: Move method discussion after closures, before generics
/cc: #4217
2012-12-20 16:32:42 -08:00
Brian Anderson
af5cd341d3 Move mast static method to the section on methods
/cc: #4217
2012-12-20 16:32:42 -08:00
Brian Anderson
42ab33e572 Use explicit self in rest of tutorial
/cc: #4217
2012-12-20 16:32:42 -08:00
Brian Anderson
171e6a16f7 tutorial: Rewrite method section to deal with explicit self
Has to be moved until after the pointer discussion.

/cc: #4217
2012-12-20 16:32:41 -08:00
Brian Anderson
7d2c2dbf4b tutorial: Reorder sections on traits
/cc: #4217
2012-12-20 16:32:41 -08:00
Brian Anderson
850050b7df doc: 'trait constraints' -> 'inheritance'. Expand
/cc: #4217
2012-12-20 16:32:41 -08:00
Graydon Hoare
66aadecfee doc: describe the Drop trait. cc: #4217 2012-12-20 16:26:11 -08:00
Tim Chevalier
8554d5e710 doc: Mention tuple structs
/cc: #4217
2012-12-19 21:52:03 -07:00
Tim Chevalier
b99a2542f3 docs: mention static methods
/cc #4217
2012-12-19 21:32:19 -07:00
Tim Chevalier
2d313fe501 Update docs to mention trait constraints; also fix failing doc tests
/cc #4217
2012-12-19 20:38:28 -07:00
Brian Anderson
6742c982a4 Bump version numbers in docs 2012-12-19 18:03:03 -08:00
Graydon Hoare
e0072e39a7 doc: structure expressions. cc: #4217 2012-12-19 17:24:19 -08:00
Graydon Hoare
46766974c7 doc: mention moved and copied types. cc: #4217 2012-12-19 16:55:34 -08:00
Isaac Aggrey
63232d6cf1 Fix doc typo 2012-12-19 12:46:24 -06:00
Brian Anderson
263136d389 'trait instance' -> 'object' 2012-12-18 17:03:56 -08:00
Brian Anderson
80a4769318 Update tutorial on generics. #4217 2012-12-18 16:28:40 -08:00
Graydon Hoare
6d4621d85f doc: a little more material on object types, part of #4217. 2012-12-18 14:37:18 -08:00
Paul Stansifer
7c103f2da9 Add a section to the macro tutorial about recursive macros. 2012-12-16 18:45:54 -05:00
Paul Stansifer
2b5e81c464 Reword some things in the macro tutorial. 2012-12-16 18:45:54 -05:00
Brian Anderson
d4daa78aa3 Update docs for crate file changes 2012-12-15 19:55:25 -08:00
Brian Anderson
e67190a0d2 Display the full TOC in the manual. Closes #4194 2012-12-14 18:06:21 -08:00
Brian Anderson
b0fc222fda Fix broken tests 2012-12-14 16:36:32 -08:00
Tim Chevalier
47faeb9228 [docs] Note that types and modules share the same namespace 2012-12-14 15:42:34 -08:00
Brian Anderson
80ef7243ea Remove spawn_listener, spawn_conversation
These are not needed in a pipe-based Rustiverse
2012-12-14 14:59:32 -08:00
Brian Anderson
55c9cf72e3 Merge pull request #4181 from andrew-d/andrew-doc-fix1
Fix example in docs
2012-12-13 17:28:23 -08:00
Andrew Dunham
08b1c841da Rename "to_str" to "make_string" in the docs
There's already a "to_str" impl for string, so it fails here.
2012-12-13 20:07:58 -05:00
Brian Anderson
fa4fbd51f6 Update docs for kind name changes 2012-12-13 15:52:50 -08:00
Tim Chevalier
0138d87f8f Document pub use foo::* in the reference manual
r=brson

Closes #3788
2012-12-12 16:38:36 -08:00
Tim Chevalier
213773ccb2 Fix tasks tutorial tests 2012-12-12 13:38:19 -08:00
Graydon Hoare
645bd98b60 doc: add missing decls to example, r=burningtree. 2012-12-11 13:43:14 -08:00
Tim Chevalier
eb21ced467 Discuss module syntax earlier in the tutorial
as per #3578
2012-12-11 11:23:20 -08:00
Tim Chevalier
65a1287f53 Discuss the Option type a bit in the tutorial
as per #3577
2012-12-11 11:23:20 -08:00
Lindsey Kuper
1ba9419e6c Tutorial typo fixes 2012-12-10 15:59:18 -05:00
Patrick Walton
eba4dadc54 doc: Fix broken doc test. rs=bustage 2012-12-08 11:47:03 -08:00
Tim Chevalier
2c2398ca0d Xfail broken tests 2012-12-07 23:42:58 -08:00
Graydon Hoare
bbc04dbb24 doc: fix busted doctest, r=burningtree. 2012-12-07 14:40:56 -08:00
Tim Chevalier
b4501f4c64 Document pattern ranges a little more
Patches for further documentation of them welcome, but this
is good enough for now.

Closes #1107
2012-12-06 21:52:50 -08:00
Paul Stansifer
3af757631e Be a bit more explicit about the nature of macro RHSes. 2012-12-06 15:01:40 -08:00
Paul Stansifer
d0c2d6c54e Update macro tutorial to recognize item/statement macros and be clearer
about invocation location vs. interpolation location.
2012-12-06 15:01:17 -08:00
Brian Anderson
946427b562 manual: Clarify that Drop types cannot be Copy 2012-11-30 11:23:22 -08:00
Brian Anderson
d1c558394f Fix tutorial's use of Drop 2012-11-29 16:23:24 -08:00
Paul Stansifer
a88f9ac732 Macros can now also be stmts and items. 2012-11-29 12:09:11 -08:00
Damien Grassart
9f290b5669 Fix sample code in the tutorial 2012-11-26 14:41:29 -08:00
Tim Chevalier
e454a47bf2 [tutorial] Use a less confusing closure example
Closes #3996
2012-11-24 09:28:34 -08:00
Brian Anderson
8f22582e9f Fix breakage. Expand const examples in manual 2012-11-19 23:20:37 -08:00
Jesse Jones
ca332a68fa Added optional pub to use_decl EBNF. 2012-11-18 18:28:05 -08:00
Jesse Jones
76712476c2 Slightly better description of macro designators.
Closes #3378
2012-11-18 18:25:06 -08:00
Jesse Jones
a24da7e254 Discuss the types that may be used with const items.
Also removed vector example that doesn't compile. IMO closes #3341.
2012-11-18 17:05:24 -08:00
Jesse Jones
a1bf759783 Added brief discussion of static trait methods.
Closes #3339
2012-11-18 15:49:53 -08:00
Jesse Jones
57c203ef7f Documented copy, ref, move in patterns.
Closes #3337
2012-11-18 15:26:12 -08:00
Jesse Jones
e46de5381b Moved the matching structs example next to the prose talking about struct matching 2012-11-18 15:15:12 -08:00
Jesse Jones
67d421d62d Document [0, ..8] vector syntax.
Closes #3336
2012-11-18 11:36:09 -08:00
Jesse Jones
d106ef88e6 Improved attribute section, mostly by mentioning lint attributes.
Closes #2769
2012-11-18 09:23:09 -08:00
Jesse Jones
d701fcd8a5 Added a readme explaining how to generate html from markdown docs w/o node 2012-11-18 09:08:31 -08:00
Tim Chevalier
12a4130749 Typo 2012-11-15 19:36:48 -08:00
Cat's Eye Technologies
7c35f7ed04 Minor grammatical edits; use preferred nomenclature consistently. 2012-11-11 16:19:40 +00:00
Patrick Walton
2904095570 rustc: Implement the Drop trait. r=brson 2012-11-07 12:34:32 -08:00
Brian Anderson
ed48e76e77 Fix typo in borrowed pointer tutorial. Closes #3876 2012-10-29 13:52:05 -07:00
Tim Chevalier
2ab614f356 Document labeled break and continue in the reference manual
r=brson
2012-10-26 15:00:55 -07:00
Tim Chevalier
0ef75a6965 Document how the compiler disambiguates variable patterns from variant patterns
r=brson
Closes #3851
2012-10-25 15:03:33 -07:00
Tim Chevalier
19dae8dae1 Remove remaining mentions of <- from docs 2012-10-23 12:13:09 -07:00
Tim Chevalier
804c608f01 Remove binary move from the docs 2012-10-23 12:10:03 -07:00
Brian Anderson
5fc4e51ab7 docs: Remove unfinished sentence in manual. Closes #3806 2012-10-22 13:12:16 -07:00
Paul Stansifer
4edb881124 Talk about ends, rather than means, in macro tutorial introduction. 2012-10-20 21:54:25 -04:00
Paul Stansifer
0f2fc71d79 Add examples to the parsing limitations section of the macro tutorial.
(Thanks to bstrie for pointing them out!)
2012-10-17 21:40:39 -04:00
Ben Striegel
f7ce3dc55f Extraneous sigil patrol: turn &[] literals into [] 2012-10-17 11:19:38 -07:00
Ben Striegel
5e1d0bab80 Sigil patrol: change fn@ fn& fn~ to @fn &fn ~fn
This also involves removing references to the old long-form closure
syntax, which pcwalton alleges is deprecated and which was never updated
for the new forms, e.g. `@fn() {}` is illegal.
2012-10-17 11:19:38 -07:00
Ben Striegel
e94e82cb8e Extraneous sigil patrol: ~"string literals" 2012-10-17 11:19:38 -07:00
Niko Matsakis
a92c3db0b3 add missing pub from multifile example in sec 12.3 2012-10-16 20:20:18 -07:00
Tim Chevalier
ea5e3d21ff Make moves explicit in doc examples
Had to remove the buffalo example. It was awkward to update for
explicit moves.
2012-10-12 20:43:37 -07:00
Tim Chevalier
45d1cd83ab Copyedit "Items and attributes" section in docs
Most notably, I removed the "foldl" example in the section on pure functions,
as IIRC this is no longer something you need an unsafe block for
(pure functions are as pure as their arguments). Feel free to add
an example where an unsafe block really is needed.
2012-10-12 12:02:08 -07:00
Brian Anderson
39c0d3591e Merge pull request #3734 from dbp/tutorial-fixes
tutorial: add note about mutability of vectors
2012-10-11 21:01:16 -07:00
Daniel Patterson
c33bff9557 tutorial: add note about mutability of vectors 2012-10-11 23:13:04 -04:00
Tim Chevalier
91315c3c2f manual: Lightly copyedit the crates section 2012-10-11 20:09:41 -07:00
Tim Chevalier
bb4dd06307 manual: Lightly copyedit the macros section 2012-10-11 20:03:24 -07:00
Tim Chevalier
140d16ac58 Fix tutorial-ffi tests 2012-10-11 19:45:04 -07:00
Graydon Hoare
5bca5f7c54 manual: fix one more nit. 2012-10-11 19:39:21 -07:00
Graydon Hoare
588d97d80e manual: fix accidentally broken test. 2012-10-11 19:30:43 -07:00
Graydon Hoare
13ea16152d manual: remove as many ~[] literals as possible. 2012-10-11 19:25:09 -07:00
Graydon Hoare
d81d4f1f3c manual: remove as many ~"" literals as possible. 2012-10-11 19:22:53 -07:00
Graydon Hoare
0b1a401bb7 manual: fix bullet list. 2012-10-11 19:15:40 -07:00
Graydon Hoare
d471e24214 manual: remove description of references (modes) from memory-slots section. 2012-10-11 19:12:35 -07:00
Graydon Hoare
70909533f0 manual: rewrite the section on type kinds. 2012-10-11 19:07:38 -07:00
Graydon Hoare
9bbff50c14 manual: fix various examples. 2012-10-11 18:18:53 -07:00
Graydon Hoare
089e257769 manual: capitalize more examples properly. 2012-10-11 18:18:53 -07:00
Graydon Hoare
9ea5e6a3b2 manual: fix vec and str types to discuss definite / indefinite size. 2012-10-11 18:18:53 -07:00
Graydon Hoare
45dc69d887 manual: example fixup. 2012-10-11 18:18:53 -07:00
Graydon Hoare
196cc0265c manual: add 'item', remove statement that built-in types are keywords. 2012-10-11 18:18:53 -07:00
Graydon Hoare
a1c831be25 manual: avoid describing 'assert' as 'like check', note future removal. 2012-10-11 18:18:53 -07:00