Commit Graph

437 Commits

Author SHA1 Message Date
Felix S. Klock II
88bec09e63 Fix two code examples in main rust tutorial.
1. The section on trait definitions of static methods should include
   a trait with a static method in the generated document.

2. The section on trait inheritance had a expression that appears
   nonsensical ("let mycircle = @mycircle") in the generated document.
   The text would be clearer (IMO) if we continued with the running
   example of CircleStruct.
2013-01-29 11:28:52 +01:00
Seo Sanghyeon
92e52bc95e doc: Document pattern matching on vectors 2013-01-23 22:26:47 +09:00
Chris Peterson
0b6487cf2c doc: Fix tutorial typo and remove unnecessary xfail-test 2013-01-20 22:56:45 -08:00
Patrick Walton
f0fa67d6bf doc: Fold information from the memory model interlude in the tutorial elsewhere 2013-01-10 21:24:55 -08:00
John Clements
08275826ca corrected imprecision in description of mutable fields 2013-01-10 20:48:49 -08:00
Brian Anderson
22ed202b61 tutorial: Remove memory model section 2013-01-10 15:22:22 -08:00
Patrick Walton
2db3abddcd librustc: Make unqualified identifier searches terminate at the nearest module scope. r=tjc 2013-01-08 22:02:35 -08:00
Patrick Walton
44ab00ee37 Revert "librustc: Make unqualified identifier searches terminate at the nearest module scope. r=tjc"
This reverts commit a8d37af247.
2013-01-08 19:29:16 -08:00
Patrick Walton
a8d37af247 librustc: Make unqualified identifier searches terminate at the nearest module scope. r=tjc 2013-01-08 19:27:57 -08:00
Brian Anderson
62c7ca64f0 Merge remote-tracking branch 'superoptimizer/master' into HEAD
Conflicts:
	doc/tutorial.md
2013-01-04 17:31:12 -08:00
Mark Lacey
d94e9c0b04 Fix two minor issues in the tutorial.
Remove an extraneous 'then', and replace 'second' with 'first'.
2013-01-03 22:36:35 -08:00
Chris Peterson
16797fd525 doc: Fix some typos in the tutorial and reference manual 2012-12-31 13:46:52 -08:00
Andrew Paseltiner
4cb9247e3b doc: make small corrections to tutorial 2012-12-30 16:09:34 -05:00
Patrick Walton
4be7310be0 doc: Fix explanation and example of struct-like enum variants. rs=busted 2012-12-30 07:09:14 -08:00
Patrick Walton
4b3dd4b920 doc: Fix some broken tutorial examples. rs=bustage 2012-12-29 21:52:51 -08:00
Tim Chevalier
09bb07bed9 Unfortunately, we can't embed cross-crate tests in the tutorial...
...as far as I know, anyway, so I xfailed this tutorial test.
2012-12-24 18:29:02 -08:00
Eric J. Holmes
8223a1278d Fix example. 2012-12-24 18:29:02 -08:00
Graydon Hoare
329316ce15 bump 0.5 => 0.6, redirect some URLs in docs. 2012-12-24 18:29:01 -08:00
Tim Chevalier
3cc0fbca5d doc: mention struct-like enum variants /cc #4217 2012-12-24 15:59:37 -08:00
Tim Chevalier
cf768ce1f4 Unfortunately, we can't embed cross-crate tests in the tutorial...
...as far as I know, anyway, so I xfailed this tutorial test.
2012-12-24 14:07:37 -08:00
Tim Chevalier
b1b0c297a4 Merge pull request #4249 from graydon/0.6-bump
bump 0.5 => 0.6, redirect some URLs in docs.
2012-12-23 13:47:11 -08:00
Eric J. Holmes
889e560ca5 Fix example. 2012-12-23 13:30:23 -08:00
Graydon Hoare
dbd36111fe bump 0.5 => 0.6, redirect some URLs in docs. 2012-12-21 15:35:49 -08:00
Brian Anderson
45e62d0a14 tutorial: Discuss argument patterns 2012-12-20 16:51:37 -08:00
Brian Anderson
d098faa855 tutorial: Clarify description of trait inheritance 2012-12-20 16:36:13 -08:00
Brian Anderson
21c9d0858b tutorial: Fix broken examples 2012-12-20 16:32:44 -08:00
Brian Anderson
f26df46a12 tutorial: Re-remove core:: prefix from some examples 2012-12-20 16:32:44 -08:00
Brian Anderson
d38f784da6 tutorial: Typo 2012-12-20 16:32:44 -08:00
Brian Anderson
b7354f114d tutorial: Clean up language about syntax extensions 2012-12-20 16:32:43 -08:00
Brian Anderson
30fac74bf3 tutorial: Try to fit the early discussion of :: in better 2012-12-20 16:32:43 -08:00
Brian Anderson
cbddd5ed34 tutorial: Remove some trivia about operators 2012-12-20 16:32:43 -08:00
Brian Anderson
2f615dc965 tutorial: Editing 2012-12-20 16:32:43 -08:00
Brian Anderson
e4b3915393 tutorial: Fix example in syntax basics section 2012-12-20 16:32:43 -08:00
Brian Anderson
1983e540e6 tutorial: Update scope 2012-12-20 16:32:43 -08:00
Brian Anderson
072017e5ef tutorial: Mention rusti with other tools 2012-12-20 16:32:43 -08:00
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
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
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
Brian Anderson
d4daa78aa3 Update docs for crate file changes 2012-12-15 19:55:25 -08:00
Brian Anderson
fa4fbd51f6 Update docs for kind name changes 2012-12-13 15:52:50 -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
Brian Anderson
d1c558394f Fix tutorial's use of Drop 2012-11-29 16:23:24 -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
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
Tim Chevalier
19dae8dae1 Remove remaining mentions of <- from docs 2012-10-23 12:13:09 -07: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
Daniel Patterson
c33bff9557 tutorial: add note about mutability of vectors 2012-10-11 23:13:04 -04:00
Tim Chevalier
41bce91cb8 Fix tutorial link to tasks
Closes #3715
2012-10-11 14:17:59 -07:00
Tim Chevalier
39acb06503 Copyedit sections 11-13 of the tutorial. That's all, folks! 2012-10-10 21:29:25 -07:00
Tim Chevalier
6d250517ed Copyedit sections 9 and 10 of the tutorial 2012-10-10 21:06:22 -07:00
Tim Chevalier
7582a482c6 Copyedit sections 7 and 8 of the tutorial 2012-10-10 20:52:20 -07:00
Tim Chevalier
1a8b00a03a Copyedit sections 5 and 6 of the tutorial 2012-10-10 20:35:33 -07:00
Tim Chevalier
d7b8512eae Copyedit section 4 of tutorial 2012-10-10 20:08:08 -07:00
Tim Chevalier
6627ac6623 Copyedit section 3 of tutorial 2012-10-10 19:32:11 -07:00
Tim Chevalier
38ccaed4ce Copyedit sections 1 and 2 of tutorial 2012-10-10 19:05:13 -07:00
Brian Anderson
b7b2217976 Update tutorial install instructions 2012-10-10 17:56:23 -07:00
Patrick Walton
d9317a174e doc: Tweak the wording of the memory model goals 2012-10-09 21:39:18 -07:00
Patrick Walton
6da09c3b43 doc: Fix some inaccuracies in the tutorial.
* Pointers can refer to stack objects as well as heap objects.

* Non-managed types can be cyclic if an arena is used.
2012-10-09 21:24:28 -07:00
tav
4c968f47e0 doc: Remove duplicate word typo in the tutorial. 2012-10-09 01:30:46 +01:00
Brian Anderson
2a41abb9ef Work on the tutorial section on 'do' 2012-10-07 01:52:06 -07:00
Brian Anderson
07fb35227b Tutorial 2012-10-07 01:06:07 -07:00
Brian Anderson
f0c4140dd0 More tutorial tweaking 2012-10-06 22:57:40 -07:00
Brian Anderson
c6330036a4 'The' Rust Language Tutorial 2012-10-06 22:47:26 -07:00
Brian Anderson
b6443519c8 Remove some redundant info from tutorial 2012-10-06 22:45:48 -07:00
Brian Anderson
fe5526f49c docs: Fix capitalization of section title 2012-10-06 22:40:12 -07:00
Brian Anderson
ba26dc50ce docs: Remove more uses of records 2012-10-06 22:35:08 -07:00
Jacob Harris Cryer Kragh
0b2ffa5692 tutorial: Add missing struct name 2012-10-06 22:33:09 -07:00
Brian Anderson
d5d7741247 Overhaul mods and crates section of tutorial 2012-10-06 22:24:15 -07:00
Brian Anderson
f5c95de212 docs: Edit the into bullets 2012-10-06 20:23:38 -07:00
Brian Anderson
035cfcbe72 docs: Clean up trait and module examples 2012-10-06 15:48:06 -07:00
Brian Anderson
e90425999e docs: Remove some 'extern mod std's from tutorial 2012-10-05 19:51:59 -07:00
Brian Anderson
95d9c8699c docs: Simplify a tutorial example 2012-10-05 19:51:59 -07:00
Brian Anderson
02c33f8d31 doc: Strings are vectors of u8, not [u8] 2012-10-05 18:42:48 -07:00
Brian Anderson
3077a2bfaf docs: Add a section on pointer dereferencing 2012-10-05 18:39:09 -07:00
Brian Anderson
8b56287d60 docs: Fix example 2012-10-04 20:13:50 -07:00
Brian Anderson
09df3ed8f1 docs: Explain a little bit about dtors 2012-10-04 20:04:13 -07:00
Brian Anderson
f5dfd9b3ce docs: Tweaks to section on constants 2012-10-04 19:47:20 -07:00
Brian Anderson
213725407b docs: Add section on constants to tutorial 2012-10-04 19:36:56 -07:00
Brian Anderson
aca2419d55 docs: Minor tutorial tweaks 2012-10-04 18:04:31 -07:00
Brian Anderson
b4f124e5f8 docs: Don't talk about mutable vecs in tutorial. Use inherited mutability 2012-10-04 18:01:00 -07:00
Andrew Paseltiner
1ee056672b docs: minor tutorial fixes 2012-10-04 20:33:06 -04:00
Brian Anderson
8cb3da576d docs: Tweaks 2012-10-04 17:09:08 -07:00
Kevin Cantu
fafce9ae37 More looking at the tutorial, small changes 2012-10-04 17:09:08 -07:00
Brian Anderson
e3f458e639 docs: Explain underscore prefix in tutorial 2012-10-04 14:44:19 -07:00
Brian Anderson
5585514c02 docs: Fix a broken test 2012-10-03 23:53:26 -07:00
Brian Anderson
3e47b4f17e Revert "docs: Call () 'unit' instead of 'nil'"
This reverts commit c8ee49a5b6.
2012-10-03 22:18:46 -07:00
Brian Anderson
a35dc85b68 docs: Typo 2012-10-03 20:06:54 -07:00
Brian Anderson
c8ee49a5b6 docs: Call () 'unit' instead of 'nil' 2012-10-03 20:06:24 -07:00
Brian Anderson
d0893fe219 docs: The real answer 2012-10-03 20:04:02 -07:00
Kevin Cantu
0b434af7eb A run through the tutorial, small changes 2012-10-03 19:25:21 -07:00
Brian Anderson
73b2a932b7 doc: Minor tutorial improvements 2012-10-02 20:29:00 -07:00
Brian Anderson
14a2448d03 docs: Typo 2012-10-01 22:39:24 -06:00
Daniel Patterson
55ab0435e7 tutorial: changing again to loop 2012-09-26 23:28:39 -04:00
Brian Anderson
656cbead49 tutorial: Convert a list to prose 2012-09-26 19:34:48 -07:00
Brian Anderson
ae1a73029c tutorial: Minor tweaks 2012-09-26 18:54:47 -07:00
Brian Anderson
3232e75995 tutorial: Delete 'what to be aware of'
This section associates borrowed pointers purely with stack allocation, which
is confusing. The following sections explain pointers in detail.
2012-09-26 18:36:38 -07:00
Brian Anderson
c244147c50 tutorial: Swap order of pointers for emphasis on & 2012-09-26 18:10:35 -07:00
Niko Matsakis
67a8e7128a Demode vec::push (and convert to method) 2012-09-26 18:02:07 -07:00
Brian Anderson
2891f5abe3 tutorial: Remove all references to 'records'. Misc 2012-09-26 16:41:35 -07:00
Brian Anderson
24153eb30f tutorial: Typo 2012-09-26 16:19:21 -07:00
Brian Anderson
ba8750a550 tutorial: Merge discussion of patterns and let bindings 2012-09-24 19:51:03 -07:00
Brian Anderson
a8406e3d00 tutorial: A little more explanation of why managed boxes are useful 2012-09-24 19:37:41 -07:00
Brian Anderson
91fe3fcbef tutorial: Expand borrowed ptr discussion. Misc 2012-09-24 19:11:48 -07:00
Brian Anderson
b3c72713de tutorial: Swap order of data type/function sections. Add method discussion 2012-09-24 18:25:57 -07:00
Brian Anderson
9902135bdd tutorial: More generics cleanup 2012-09-24 17:49:04 -07:00
Brian Anderson
dd9b6c97b9 tutorial: Overhaul the generics section 2012-09-24 17:37:49 -07:00
Brian Anderson
1b1aea8e0e tutorial: Begin trying to improve the generics section 2012-09-23 21:09:44 -07:00
Brian Anderson
690525ed81 tutorial: Update ptr/vec/fn sections with new terminology 2012-09-23 18:45:51 -07:00
Brian Anderson
2d3396bef1 tutorial: Merge some related, small sections 2012-09-23 18:45:51 -07:00
Brian Anderson
2e7ddee823 tutorial: Simplify the first example. Misc 2012-09-22 23:27:05 -07:00
Brian Anderson
3b89dcbdf2 tutorial: Clean up literal section 2012-09-22 22:27:15 -07:00
Brian Anderson
4081b40523 tutorial: Don't iloop in example 2012-09-22 22:24:17 -07:00
Brian Anderson
7937905dbf tutorial: Merge sections 'Types' and 'Using types'
Most of this material is covered elsewhere
2012-09-22 21:50:08 -07:00
Brian Anderson
36602a1f71 tutorial: Convert the type list to a more compact table 2012-09-22 21:23:12 -07:00
Brian Anderson
0cabd6fa1a tutorial: More intro simplification 2012-09-22 21:23:00 -07:00
Brian Anderson
c2bc5122cd tutorial: Make the intro more concise
Talk more about the features of the language, less comparisons to
other languages. Don't introduce the language using the worst possible
example.
2012-09-22 17:59:49 -07:00
Brian Anderson
fd0de8bfd7 doc: Split out task tutorail. Add links to sub-tutorials 2012-09-22 15:34:01 -07:00
Brian Anderson
6caafaa9ea tutorial: Use bold bullet items instead of bold italic 2012-09-22 14:14:48 -07:00
Niko Matsakis
3d59ac3a19 De-mode vec::map, vec::eachi, vec::rev_each, vec::rev_eachi 2012-09-21 19:13:55 -07:00
Graydon Hoare
dffe188991 Install new pub/priv/export rules as defaults, old rules accessible under #[legacy_exports]; 2012-09-21 18:11:43 -07:00