Commit Graph

688 Commits

Author SHA1 Message Date
Brian Anderson
994c881538 tutorial: Use blockquotes for asides. Add styling 2012-07-07 15:51:11 -07:00
Brian Anderson
3413b3f5c5 tutorial: Expand the section on functions 2012-07-07 15:37:58 -07:00
Brian Anderson
205b483edd tutorial: Discuss failure and asserts together 2012-07-07 15:09:54 -07:00
Brian Anderson
59355e99ca tutioral: Discuss basic function syntax is discussed before the memory model 2012-07-07 15:08:44 -07:00
Brian Anderson
b5f5676a2f tutorial: Use consistent casing in headers 2012-07-06 18:27:42 -07:00
Brian Anderson
28fec95c59 tutorial: Add some work on borrowed pointers 2012-07-06 18:25:39 -07:00
Brian Anderson
af199f2edb tutorial: Expand the section on datatypes 2012-07-06 18:09:59 -07:00
Brian Anderson
ad05996223 tutorial: Fix a test-breaking typo 2012-07-06 18:09:22 -07:00
Brian Anderson
4bb13c69d6 Add 'class' and 'new' to codemirror-rust.js 2012-07-06 17:18:11 -07:00
Brian Anderson
57698fec6c tutorial: Remove some trivia 2012-07-06 17:07:29 -07:00
Graydon Hoare
ceac155211 For #2229, recognize 'again' in place of 'cont', final change pending snapshot. 2012-07-06 15:46:39 -07:00
Brian Anderson
fce064db6b tutorial: Reduce header level for do/for loop sections 2012-07-06 15:10:30 -07:00
Benjamin Herr
177853c551 tutorial: Formatting fix 2012-07-06 23:55:25 +02:00
Brian Anderson
ea4cd49e9f tutorial: Minor tweak 2012-07-06 14:52:21 -07:00
Brian Anderson
82001412f2 tutorial: Add a section on the memory model 2012-07-06 14:38:05 -07:00
Brian Anderson
8c64a98d65 tutorial: Minor tweaks to intro 2012-07-06 12:20:03 -07:00
Brian Anderson
08a99d6ae1 tutorial: Add a language overview to the introduction 2012-07-06 12:14:36 -07:00
Lindsey Kuper
1e34202e74 Minor tutorial tweaks 2012-07-05 11:32:49 -07:00
Brian Anderson
7ff2740199 tutorial: Minor correction 2012-07-04 20:52:46 -07:00
Ben Striegel
f2e2a14f36 Remove empty argument lists from do expressions 2012-07-04 17:21:29 -07:00
Graydon Hoare
db355082e1 Doc nit. 2012-07-04 11:51:57 -07:00
Brian Anderson
86f0dcb9ab tutorial: Make example less bracey 2012-07-04 03:58:00 -07:00
Brian Anderson
afb3980f29 tutorial: More improvements to closure section 2012-07-04 01:50:51 -07:00
Brian Anderson
08368a38d3 tutorial: More cleanup 2012-07-03 19:13:41 -07:00
Brian Anderson
a76ed88f54 tutorial: Add a more detailed example to the intro 2012-07-03 17:56:50 -07:00
Brian Anderson
06368a7b75 tutorial: Minor editing to intro 2012-07-03 14:36:11 -07:00
Brian Anderson
63c043091e tutorial: Restructure intro materials 2012-07-03 13:02:20 -07:00
Brian Anderson
90dcb59400 tutorial: Minor improvements to closures 2012-07-02 23:23:43 -07:00
Brian Anderson
43def0677a tutorial: More updates for closures 2012-07-02 16:32:19 -07:00
Brian Anderson
b446ea8710 tutorial: Some work on closures 2012-07-02 00:14:25 -07:00
Brian Anderson
d1fc2b5995 Convert to new closure syntax 2012-07-01 19:19:32 -07:00
Brian Anderson
a3382b6f26 Eliminate usages of old sugared call syntax 2012-06-30 16:01:49 -07:00
Michael Sullivan
a3c7d93c77 Get rid of basically all of the remaining old style vecs in tests. 2012-06-29 15:08:12 -07:00
Graydon Hoare
e2205659e3 Fix tabSize doc build breakage, also remove the stray tab that got into docs. 2012-06-27 14:37:43 -07:00
Graydon Hoare
d3c6119a7a More keyword paring and migration in runtime, docs, code modes. 2012-06-27 13:30:49 -07:00
Tim Chevalier
95feaee353 In doc reference, don't mention references, and stub out a section for classes 2012-06-25 12:16:33 -07:00
Tim Chevalier
60a748a1d8 Remove section on resources from tutorial; add a todo to cover classes 2012-06-22 13:11:55 -07:00
Brian Anderson
0a6943dd31 Merge pull request #2684 from mozilla/incoming
Incoming
2012-06-20 20:45:19 -07:00
Lindsey Kuper
1df6ddd08c doc: add information about suffix inference to tutorial and manual. 2012-06-20 17:56:40 -07:00
Brian Anderson
4dcf84e4f4 Remove bind. Issue #2189 2012-06-20 17:27:28 -07:00
Kevin Cantu
8103611b7f Use smaller 32x32 logo 2012-06-16 12:48:48 -07:00
Kevin Cantu
976fae80a0 Add logo to HTML docs 2012-06-16 12:35:01 -07:00
Niko Matsakis
013fc92423 remove alias analysis and replace with borrowck
This reverts commit 7ef825bb60.
2012-06-08 20:39:11 -07:00
Brian Anderson
7ef825bb60 Revert "remove alias analysis and replace with borrowck"
18s perf regression compiling rustc with opts

This reverts commit 7f6ee0ce0d.
2012-06-07 19:42:27 -07:00
Niko Matsakis
7f6ee0ce0d remove alias analysis and replace with borrowck
cc #2540
2012-06-07 16:46:57 -07:00
Niko Matsakis
3f6e6532ac make vec fns/methods take imm slices.
this also repairs the unsoundness in typing of unpack_slice,
which was silently converting a const ptr to an imm one.
2012-06-02 19:14:57 -07:00
Lindsey Kuper
47cba3a107 tutorial: Consistent metavariable for types. Closes #2461. 2012-05-29 13:11:55 -07:00
Lindsey Kuper
3891b5a569 tutorial: Minor cleanup. 2012-05-29 13:11:55 -07:00
Paul Stansifer
829c983479 Update the list of reserved words. 2012-05-24 14:26:16 -07:00
Michael Sullivan
353cda5c86 Update the tutorial with the new shift behaviors. 2012-05-23 11:00:33 -07:00
Brian Anderson
b329e1c719 doc: Fix as description in tutorial 2012-05-16 20:22:32 -07:00
Brian Anderson
9e4fb320da doc: Fix operator precedence. Closes #2390 2012-05-16 20:16:27 -07:00
Lindsey Kuper
17d6b09d14 doc: remove duplicate words. Thanks, Matt Might! 2012-05-15 11:25:35 -07:00
Lindsey Kuper
b8880e3254 Remove be keyword.
Closes #2227.
2012-05-15 10:41:14 -07:00
Paul Stansifer
f943667af3 Remove do ... while loops from the tests and docs. 2012-05-10 15:27:42 -07:00
Tim Chevalier
9280d0c090 Explain difference between star and underscore in patterns in the reference manual 2012-04-23 19:22:24 -07:00
Tim Chevalier
55e29ef4aa Mention lazy evaluation of log arguments in tutorial 2012-04-23 15:50:40 -07:00
Tim Chevalier
03d9d6287b Discuss (*) patterns in reference documentation 2012-04-23 15:50:16 -07:00
Brian Anderson
8be944e89e doc: Remove unused keywords.txt 2012-04-19 20:06:13 -07:00
Brian Anderson
594d22e7e2 doc: Update keyword list 2012-04-19 16:59:28 -07:00
Joshua Wise
e5f51bf5ef doc: Update keywords.txt with modern list of keywords derived from parser. 2012-04-19 00:05:55 -07:00
Marijn Haverbeke
73ea690016 Describe new for construct in the tutorial
Closes #2141
2012-04-18 17:21:39 +02:00
Niko Matsakis
35a93e61d4 rewrite region resolution so it takes place in typeck 2012-04-16 19:48:00 -07:00
Graydon Hoare
9e726b0461 Add description of by-move mode. 2012-04-11 10:20:52 -07:00
Tim Chevalier
9d274ec5f2 Re-rename option functions
get_with_default (nee from_maybe) => get_default
with_option (nee maybe) => map_default
with_option_do (nee may) => iter

As per discussion of 21be1379d5
2012-04-06 12:20:13 -07:00
Marijn Haverbeke
fc202ca034 Remove support for old-style for
Closes #1619
2012-04-06 20:38:23 +02:00
Tim Chevalier
fc7fc90adf Documentation only: update tutorial to mention --lib only for single source files
In the tutorial, use the crate_type attribute when discussing crate files that
are libraries, and only refer to the --lib files when talking about making a
single source file into a library.

Closes #2070.
2012-04-05 16:28:09 -07:00
Tim Chevalier
3ef620bf92 task_builder => builder in the docs
This example got left out for some reason.
2012-04-05 14:35:54 -07:00
Tim Chevalier
21be1379d5 Rename some core::option functions
from_maybe => get_with_default
maybe => with_option
may => with_option_do

I know these names are kind of ridiculous, but it's the best I could think of.
Feel free to bikeshed. Closes #2081
2012-04-02 16:12:49 -07:00
Brian Anderson
d0268cbe5f doc: Abbreviate Thursday as 'th', not 'do' 2012-04-02 14:17:33 -07:00
Brian Anderson
9ec21933f1 doc: Tutorial fixes
Thanks to Mohd. Bilal Husain
2012-04-01 15:36:56 -07:00
Graydon Hoare
2142c5ebbb Minor typo fixes. 2012-03-27 13:54:49 -07:00
Graydon Hoare
6e6798c4e1 Bulk-edit mutable -> mut. 2012-03-26 18:35:18 -07:00
Jacob Parker
82e5fe1d72 str::to_chars -> str::chars 2012-03-25 16:29:18 -04:00
Niko Matsakis
dc07280b08 make --enforce-mut-vars always on, add mut annotations to remaining files 2012-03-22 09:58:19 -07:00
Brian Anderson
8404ea0c8a doc: Fix more language ref tests 2012-03-20 21:11:13 -07:00
Brian Anderson
575692c3bc doc: Fix some language ref examples 2012-03-20 18:59:21 -07:00
Brian Anderson
089877f0c5 doc: tag->enum in codemirror-rust.js 2012-03-20 18:59:21 -07:00
Brian Anderson
0a347e760f doc: Run language ref through prep.js
This is so we can strip out support code needed to make the examples work,
and as a bonus it does syntax highlighting.
2012-03-20 18:59:21 -07:00
Brian Anderson
57281f52e5 test: Begin running the language ref examples. Mostly xfailed 2012-03-20 18:59:21 -07:00
Brian Anderson
a0cbf638ee doc: Switch the tutorial to pandoc's method of tagging code blocks
Instead of '## tag', it's '~~~ {.tag}'
2012-03-20 18:59:21 -07:00
Brian Anderson
f322dd1510 doc: Fix external links in tutorial 2012-03-20 17:19:53 -07:00
Brian Anderson
f5087aa64b doc: Remove unary move operator from language ref. Closes #2032 2012-03-20 15:20:37 -07:00
Brian Anderson
13bcc73625 core: Rename vec::position_elt to position_elem 2012-03-18 17:40:49 -07:00
Brian Anderson
b968c8e6cd Name types after their modules instead of 't' 2012-03-13 15:14:17 -07:00
Graydon Hoare
6f5853f5a1 Libc/os/run/rand/io reorganization. Close #1373. Close #1638.
- Move io, run and rand to core.
 - Remove incorrect ctypes module (use libc).
 - Remove os-specific modules for os and fs.
 - Split fs between core::path and core::os.
2012-03-12 20:08:29 -07:00
Brian Anderson
772028acdb doc: Add some info about native mods and crust functions 2012-03-12 15:41:11 -07:00
Tim Chevalier
fde4c1efbb Document what the type of the main() function should be 2012-03-11 20:55:12 -07:00
Tim Chevalier
d7ae9f1370 Docs for infinite loops 2012-03-11 20:17:37 -07:00
Brian Anderson
a0a230de83 doc: Add 'crust' to keywords 2012-03-11 18:05:51 -07:00
Brian Anderson
57af1e9f67 doc: Update tutorial for task API changes 2012-03-10 15:30:51 -08:00
Brian Anderson
91b988ea45 doc: Indent preformatted text a little more 2012-03-10 15:26:41 -08:00
Brian Anderson
93a082149a build: Switch from naturaldocs to rustdoc 2012-03-09 22:56:53 -08:00
Brian Anderson
4220dcf1e9 core: New task API 2012-02-20 18:58:04 -08:00
Daniel Luz
06658b46b8 Duplicate keyword 2012-02-14 23:39:30 -02:00
Daniel Luz
039cc8d6c5 Fixed missing quote on bracket literal 2012-02-14 23:39:02 -02:00
Tomoki Aonuma
6d1d9a0236 Fix typos in the reference manual 2012-02-15 04:34:02 +09:00
Patrick Walton
d4d21b4279 tutorial: Mention how the destructor works in the section on resources. Closes #1615. 2012-02-14 09:28:39 -08:00
Marijn Haverbeke
87a488048d Make keyword table in reference reflect reality more closely
And remove the part about reserved words.
2012-02-06 22:03:17 +01:00
Brian Anderson
91b6dc5c8e Merge remote-tracking branch 'erickt/master'
Conflicts:
	src/libcore/vec.rs
	src/libstd/getopts.rs
2012-02-05 15:15:21 -08:00
Marijn Haverbeke
75c56e8494 Add missing 'use std' in tutorial example 2012-02-05 14:57:33 +01:00
Paul Woolcock
6ba3d24355 Remove ternary operator
`expr_ternary`, `ternary_to_if`, and all parses & lexer definitions have
been removed.
2012-01-30 18:21:19 +01:00
Erick Tryzelaar
259636a112 core: rename vec::position* functions
Almost all of the vec functions that predicates don't have a
corresponding function that takes a single element, so this
commit renames the common fn usecase to be the default.
2012-01-28 09:18:34 -08:00
Brian Anderson
6d360d2b02 tutorial: Fix types in gettimeofday example. Closes #1657 2012-01-26 15:45:02 -08:00
Tim Chevalier
746fa27988 In the tutorial install directions, mention that you may need to sudo make install 2012-01-25 13:49:32 -08:00
Joe Pletcher
edd86126f7 Added a small note to help explain tag's in older code. 2012-01-25 10:17:50 +01:00
Joe Pletcher
b02b65a547 Remove stale references to tags, replaced with enums. 2012-01-25 10:17:49 +01:00
Joe Pletcher
3b9a9fce49 Remove reference to tags, replace enums. 2012-01-25 10:16:32 +01:00
Tim Chevalier
2d84b481de Documentation only -- typos in section on swap expression
Closes #1595. Thanks to mikesamuel.
2012-01-24 16:46:22 -08:00
Tim Chevalier
cd9b344f7b Update docs to reflect new export forms 2012-01-23 16:35:39 -08:00
Brian Anderson
088e915fee Remove mention of Windows installer from tutorial
We don't want users to hurt themselves, since the installer has
a bug in 0.1 that could possibly corrupt %PATH%

Conflicts:

	doc/tutorial.md
2012-01-23 14:09:21 -08:00
Brian Anderson
5cb725a890 tutorial: Remove mention of windows installer 2012-01-23 13:52:31 -08:00
Rick Waldron
c42b52b3fd Corrects order of identifier and type in arguments list in 7.3.3 Constraints example. Fixes #1613 2012-01-22 23:14:46 -05:00
Brian Anderson
98fd120ac1 tutorial: Make the comm examples pass 2012-01-21 15:25:14 -08:00
Brian Anderson
de150e02ae tutorial: Un-xfail some working examples 2012-01-21 15:06:06 -08:00
Taras Shpot
1bbd97c11f doc: Fix typo 2012-01-21 16:21:18 +02:00
Brian Anderson
2aabccc3ba doc: Remove extract-tests.js and run-tests.sh
The tutorial tests are run as part of the test suite now.
2012-01-20 19:57:47 -08:00
Brian Anderson
327c8bc733 build: Run tutorial tests 2012-01-20 19:56:06 -08:00
Lindsey Kuper
78c327559c Typo fixes. 2012-01-20 22:36:33 -05:00
Brian Anderson
63a1dcda29 doc: Translate extract-tests.js to python 2012-01-20 17:32:49 -08:00
Matt Brubeck
155601eefe Update the keyword lists in rust.md and syntax.vim
Add new keywords "enum" and "of", and remove old keywords "auth", "chan",
"log_err", "tag", and "task".

Also add reserved words to the syntax file, to help Vim users avoid using them
as identifiers.
2012-01-20 16:08:51 -08:00
Brian Anderson
4efdab0059 doc: Add MinGW instructions to tutorial 2012-01-20 15:27:14 -08:00
Brian Anderson
3401c50070 doc: Use commas to separate enums in tutorial 2012-01-20 15:14:18 -08:00
Niko Matsakis
1304e4e40f update tutorial to avoid block() syntax and to use term stack closure 2012-01-20 09:14:30 -08:00
Brian Anderson
20a9e317c9 doc: Fix mutant comma in tutorial 2012-01-20 02:16:11 -08:00
Brian Anderson
341540b694 doc: Mention 'debug' log level in tutorial. Closes #1579 2012-01-20 01:06:26 -08:00
Graydon Hoare
a4954eb6ce Couple typo fixes in tutorial. 2012-01-19 23:58:33 -08:00
Graydon Hoare
d8e750f1c6 Typo fix in tutorial. 2012-01-19 22:55:40 -08:00
Brian Anderson
b9d517296a doc: Update description of logging spec and ::rt module 2012-01-19 22:30:15 -08:00
Matt Brubeck
2eda013ea2 Add documentation about paretheses for grouping expressions 2012-01-19 21:54:17 -08:00
Matt Brubeck
3d9f50a186 Mention associativity of binary operators 2012-01-19 21:54:17 -08:00
Matt Brubeck
3276af7f24 "Rust task" should be "Rust program" in the intro to the Memory Model docs 2012-01-19 21:54:17 -08:00
Graydon Hoare
c470018240 Merge pull request #1573 from mbrubeck/master
Remove some stray texinfo syntax from a footnote
2012-01-19 21:36:13 -08:00
Ben Striegel
1a295096b1 tutorial.md: spelling corrections for sections 1-5 2012-01-20 00:22:05 -05:00
Matt Brubeck
cea9fbfab0 Remove some stray texinfo syntax from a footnote 2012-01-19 21:12:46 -08:00
Matt Brubeck
bed7e96022 Fix a broken link in doc/rust.md. 2012-01-19 20:55:36 -08:00
Graydon Hoare
6ffc36bb1b Move some doc text around. 2012-01-19 18:34:41 -08:00
Graydon Hoare
874390831a Fix a bunch of broken internal links in the docs. Add a hokey link checker. 2012-01-19 17:50:21 -08:00
Graydon Hoare
a5e1848906 Remove old ref.foo noise. 2012-01-19 17:11:05 -08:00
Graydon Hoare
5589ab16e0 Clarify immaturity of grammar, add a pile of half-baked grammar rules. 2012-01-19 17:05:35 -08:00
Graydon Hoare
997b29fa7e Fix links. 2012-01-19 17:01:15 -08:00
Tim Chevalier
c500801f83 Fix typos in section 6; point out that prove expressions are unsupported 2012-01-19 16:59:25 -08:00
Tim Chevalier
704210ef7c Typos, section 5 2012-01-19 16:31:42 -08:00
Tim Chevalier
bb54979b39 Fix typos 2012-01-19 16:23:38 -08:00
Tim Chevalier
64a0695fec Fix typos 2012-01-19 16:05:55 -08:00
Tim Chevalier
93a816ab9d Fix typo 2012-01-19 16:02:04 -08:00
Graydon Hoare
7e21be5304 Add 'getting started' text to tutorial, close #427. 2012-01-19 14:49:00 -08:00
Graydon Hoare
cc2bd02827 Remove doc/rust.texi 2012-01-19 13:10:14 -08:00
Graydon Hoare
e0a4d47720 Copy section to docs on runtime services. 2012-01-19 13:10:14 -08:00
Brian Anderson
0c237254b3 doc: Copyedit task section 2012-01-19 12:23:35 -08:00
Brian Anderson
35f553dbd6 doc: Fix typo 2012-01-19 11:38:26 -08:00
Marijn Haverbeke
d54cc1cad4 Fix internal linking in the tutorial 2012-01-19 15:33:45 +01:00
Marijn Haverbeke
a4b77758f0 Move tutorial over to a format similar to the reference doc
And adjust highlighting/testing scripts to deal with this.
2012-01-19 13:34:10 +01:00
Tim Chevalier
90cd795b8b Update docs to reflect pattern syntax change 2012-01-19 01:22:43 -08:00
Graydon Hoare
3074fd591d Tidy tidy 2012-01-18 18:44:06 -08:00
Marijn Haverbeke
ba6c94e321 Add a stylesheet to make the reference HTML look a bit prettier 2012-01-18 16:28:31 +01:00
Marijn Haverbeke
861b8f0107 Fill out some parts of the reference docs 2012-01-18 16:28:31 +01:00
Marijn Haverbeke
e40cd654b9 Fix bug in tutorial render script 2012-01-18 16:28:31 +01:00
Marijn Haverbeke
94cd792b92 Fix poor markdown parsing in tutorial-building script 2012-01-18 09:39:19 +01:00
Graydon Hoare
711fc20d88 Merge pull request #1544 from kevina/issue-1393
Minor cleanups to custom discriminator code.
2012-01-17 12:45:09 -08:00
Kevin Atkinson
bdc8e8d222 Minor cleanups to custom discriminator code.
Mostly updates to the comments and docs from Pull Request #1537.
2012-01-16 21:04:02 -07:00
Graydon Hoare
293678847b Convert a bunch of material on items, statements, expressions and typestates. 2012-01-16 18:04:48 -08:00
Graydon Hoare
236b304f19 Convert some material covering items, view-items, types. 2012-01-16 16:13:34 -08:00
Marijn Haverbeke
498ad91d06 Upgrade CodeMirror mode used to highlight the tutorial code 2012-01-16 13:07:16 +01:00
Marijn Haverbeke
936c933fd8 Move emacs mode into tree 2012-01-16 12:44:24 +01:00
Kevin Atkinson
edf11ebf02 In the tutorial, document that C-like enums can have the discriminator
values set and that it is possible to cast them to scalar values.
2012-01-16 11:19:32 +01:00
Graydon Hoare
f535940bd5 Import task and memory-model docs. 2012-01-13 15:43:12 -08:00
Graydon Hoare
4f9e1ba80b More doc porting. 2012-01-13 15:43:12 -08:00
Graydon Hoare
fefdb63c4c Begin shift over to using pandoc, markdown and llnextgen for reference manual. Fix man page URL while at it. 2012-01-12 19:10:30 -08:00
Graham Fawcett
f4a3a3b878 tutorial: rework nolink description to remove mention of "empty string" 2012-01-12 22:02:41 +01:00
Marijn Haverbeke
ca72a8300b Add tutorial chapter on interfaces 2012-01-12 14:24:36 +01:00
Marijn Haverbeke
0f72c53fdf Go over the tutorial again
Edit some things, make sure all code runs.
2012-01-12 13:19:02 +01:00
Niko Matsakis
79d489cedf discuss joinable tasks 2012-01-11 13:12:45 -08:00
Niko Matsakis
f3b867fd04 add section on spawn_connected to tutorial and pull test into file 2012-01-11 09:49:21 -08:00
Niko Matsakis
ef895b9632 update various parts of the tutorial 2012-01-10 19:57:00 -08:00
Austin Seipp
55edb4a04f Replace all occurrences of 'when' with 'if' in documentation and tutorial.
Also update the naturaldocs keywords file.

Closes #1396
2012-01-09 19:27:06 -08:00
Graydon Hoare
8387896dda Remove proto_sugar and 'lambda' as keyword, commit to fn@. 2012-01-09 16:12:48 -08:00
Brian Anderson
48019c5b0a doc: typo 2012-01-07 17:04:30 -08:00
Marijn Haverbeke
7ea175f23f Fix confusing information in tutorial chapter about argument modes 2012-01-02 10:23:04 +01:00
Erick Tryzelaar
eba891e989 tutorial: Mention by-value argument passing style. 2011-12-31 12:20:03 -08:00
Graydon Hoare
90ae3e3168 Document copy/move/swap/assign expressions more accurately. Fix up some drift on log docs. 2011-12-30 15:10:55 -08:00
Graydon Hoare
d6db9506f4 Purge some obsolete and/or not-implemented stuff from docs. 2011-12-29 18:02:39 -08:00
Graydon Hoare
36c55b20a8 Add support in lexer for utf8 identifiers. No NFKC logic in char yet. 2011-12-29 14:45:18 -08:00
Graydon Hoare
88d74993d8 Update docs on log expressions. 2011-12-23 11:43:36 -08:00
Graham Fawcett
7ddd353ef6 implement #[nolink]; deprecate #[link_name = ""]; note in stdlib to remove empty link_name.
Can't remove them from stdlib until the snapshotted compiler supports #[nolink].
2011-12-16 15:29:59 -08:00
Brian Anderson
89efb7d981 libstd: Update docs 2011-12-06 13:58:54 -08:00
Graydon Hoare
447414f007 Establish 'core' library separate from 'std'. 2011-12-06 12:13:04 -08:00
Stefan Plantikow
3ee2eb656e doc: added definition of trivial casts to spec
(cf @ignored Expr.Be and #1215 for intended use)
2011-12-02 11:38:24 -08:00
Haitao Li
6168f8f15b tutorial: Fix typo in the test section 2011-11-25 08:03:47 +01:00
Haitao Li
3e303af86b rustc: Add a path attribute for crate directives
The path information was an optional "filename" component of crate
directive AST. It is now replaced by an attribute with metadata named
"path".

With this commit, a directive

  mod foo = "foo.rs";

should be written as:

  #[path = "foo.rs"]
  mod foo;

Closes issue #906.
2011-11-24 15:31:18 -08:00
Haitao Li
2ac63801d2 doc: Build keywords multitable automatically
Keywords are now listed in a plain text file. They're sorted in
column-major order and rendered as a texinfo multitable in rust.texi.

Fixes issue #1216.
2011-11-23 21:11:18 +01:00
Marijn Haverbeke
a8dd52ed36 Remove last traces of auth keyword
The reference now has an empty hole where the auth keyword used to be.
Changing the keyword table seems to require manually sorting the
keywords and putting them back into some kind of arcane interleaved
order. I'll open an issue to actually fix this.

Closes #1211
2011-11-23 11:02:27 +01:00
Marijn Haverbeke
fedb775fbb Add hacks to extract and compile tutorial code
Not included in the build by default, since it's fragile and kludgy. Do
something like this to run it:

    cd doc/tutorial
    RUSTC=../../build/stage2/bin/rustc bash test.sh

Closes #1143
2011-11-22 16:12:23 +01:00
Marijn Haverbeke
532642f425 Clarify escaped newlines in tutorial
Closes #1117
2011-11-22 12:47:07 +01:00
Marijn Haverbeke
8e2b5de90e Fix typo in tutorial 2011-11-21 13:20:02 +01:00
Marijn Haverbeke
12f6e868f7 Add explanation of kinds to tutorial 2011-11-21 12:07:41 +01:00
Haitao Li
f4eb25e0d0 tutorial: Fix type mismatch in example FFI code
Compile error:
time.rs:13:23: 13:43 error: mismatched types: expected
*R[tv_sec=mMltv_usec=mMl] but found *R[tv_sec=Mltv_usec=Ml] (record
elements differ in mutability)
time.rs:13     libc::gettimeofday(std::ptr::addr_of(x),
std::ptr::null());
                                  ^~~~~~~~~~~~~~~~~~~~
error: aborting due to previous errors
rust: upcall fail 'explicit failure', ../src/comp/driver/session.rs:70
rust: domain main @0x9dfd178 root task failed
2011-11-17 22:50:08 +08:00
Brian Anderson
bfbaa3d1e1 tutorial: Close unmatched quote in anchor tag 2011-11-16 15:02:00 -08:00
Brian Anderson
9b89b0cffd Update tutorial for native mod changes 2011-11-16 12:16:36 -08:00
Haitao Li
5665308d8c tutorial: Update with native module syntax change 2011-11-16 11:35:14 -08:00
Marijn Haverbeke
73cd032df5 Fix small grammar mistake in tutorial 2011-11-16 08:51:59 +01:00
Marijn Haverbeke
0898d441cb Use libcrypto.so instead of libssl.so in the ffi part of tutorial 2011-11-15 13:53:03 +01:00
Brian Anderson
369fc5e480 Document crate top-level and directory modules. Closes #1097 2011-11-07 13:34:04 -08:00
Marijn Haverbeke
ba57ec24ea Fix some more bugs in the tutorial
Tutorial code going out of date is going to be a recurring problem...
2011-11-07 09:55:25 +01:00
Matt Brubeck
ce8c5b0340 Tutorial: 'import std;' should be 'use std;'. 2011-11-07 08:45:29 +01:00
Marijn Haverbeke
2c033f83ef Fill in the tutorial section on testing 2011-11-04 12:23:35 +01:00
Marijn Haverbeke
4ce6472c02 Clarify metadata syntax in manual
Closes #1119
2011-11-03 10:59:42 +01:00
Marijn Haverbeke
eed782c778 Fix confusing sentence in tutorial. 2011-11-02 19:03:49 +01:00
Marijn Haverbeke
d58a9c7346 Expand the tutorial section on functions 2011-11-02 13:49:37 +01:00
Marijn Haverbeke
769e9b669b Write briefly about syntax extension in the syntax section
The currently existing syntax extension facilities don't really merit
their own section.
2011-11-02 13:27:29 +01:00
Marijn Haverbeke
0a20eed2db Make ptr::addr_of return an immutable vec, add mut_addr_of 2011-11-02 12:20:12 +01:00
Marijn Haverbeke
eaf9e05611 Make 'lambda(...) -> ...' parse as a type 2011-11-02 12:20:11 +01:00
Marijn Haverbeke
eabc9f2295 Fix some typos in tutorial 2011-11-01 22:11:55 +01:00
Brian Anderson
4a2d277bbf Fix typo in syntax.md 2011-11-01 12:39:47 -07:00
Marijn Haverbeke
11999351e0 Fill in the foreign-function part of the tutorial 2011-11-01 17:35:18 +01:00
Marijn Haverbeke
4fec1798d0 Tie up some ends in the tutorial 2011-11-01 15:41:14 +01:00
Marijn Haverbeke
a6d856c57c Improve syntax highlighting in tutorial 2011-11-01 15:16:50 +01:00
Marijn Haverbeke
59cc8636b7 Fix file timestamp extraction in tutorial builder 2011-11-01 14:47:13 +01:00
Marijn Haverbeke
aa01876c95 Flesh out the module section of the tutorial 2011-11-01 14:38:55 +01:00
Marijn Haverbeke
e8e2cd44f4 Add syntax highlighting to the code snippets in the tutorial
Using the CodeMirror Rust mode.
2011-11-01 12:46:46 +01:00
Marijn Haverbeke
8b57cb90e5 Clarify tutorial based on feedback, fix some Markdown errors 2011-11-01 09:42:24 +01:00
Haitao Li
ca7d750eb8 doc: Sort keywords alphabetically 2011-11-01 09:25:39 +01:00
Haitao Li
2befca3966 doc: Add missing keywords block and lambda 2011-11-01 09:25:37 +01:00
Brian Anderson
151aaf84ce Add pattern guard docs to language ref 2011-10-31 15:37:40 -07:00
Marijn Haverbeke
0b4f0a4caa Add a first stab at a tutorial
You build it with `cd doc/tutorial; node build.js`, and then point
your browser at doc/tutorial/web/index.html. Not remotely ready for
publicity yet.
2011-10-31 16:21:39 +01:00
Matt Brubeck
d5415a3973 Remove iter and 'for each' from the documentation 2011-10-28 20:33:58 -07:00
Brian Anderson
6864070b24 Document alt record patterns 2011-10-28 16:51:11 -07:00
Brian Anderson
6afecc37e3 Document the nullary-variant period in alt patterns 2011-10-28 16:18:16 -07:00
Matt Brubeck
ba1df0eda9 More documentation for alt expressions 2011-10-28 16:03:27 -07:00
Brian Anderson
fd095fbfa6 Document how RUST_LOG works 2011-10-28 15:47:20 -07:00
Matt Brubeck
5a0f18558e Add 'as' (cast) operator to the documentation 2011-10-27 13:37:35 -07:00
Brian Anderson
4d669036f3 Add more std documentation 2011-10-26 18:32:34 -07:00
Brian Anderson
1b75e5c315 Use web-style paragraphs in std docs 2011-10-26 11:55:28 -07:00
Brian Anderson
197c8543fe Add more std documentation 2011-10-26 11:47:42 -07:00
Brian Anderson
7ae757583a Begin documenting std and add doc generation using naturaldocs
Naturaldocs isn't really that great but it seems easier to get
something working than with doxygen, for which we would need to
convert rust code to something C++ish. We probably want to just
write a rustdoc utility at some point.
2011-10-25 18:01:52 -07:00
Matt Brubeck
5950ae3c0e doc: Fix parse errors in list examples in documentation 2011-10-17 22:50:46 -07:00
Matt Brubeck
f400bfd8fd doc: Update 'alt' documentation to remove 'case' keyword 2011-10-17 22:50:46 -07:00
Matt Brubeck
1e5f163eec doc: 'alt' expressions no longer require parens 2011-10-17 22:21:31 -07:00
Matt Brubeck
9e8076c88b doc: 'if' expressions no longer require parens 2011-10-17 22:21:31 -07:00
Matt Brubeck
db84029268 doc: 'for' and 'for each' no longer use parens 2011-10-17 22:21:31 -07:00
Matt Brubeck
16a5885555 doc: Fix typo (s/pay/may/) 2011-10-17 22:21:31 -07:00
Brian Anderson
4dafbcd992 doc: Don't merge function and concept index. There is no findex
This is causing errors on my windows install
2011-09-29 16:47:09 -07:00
Patrick Walton
199e4dee8d doc: Remove case from the list of keywords 2011-09-27 14:01:06 -07:00
Patrick Walton
f54e2699fb doc: Remove tup from the list of keywords 2011-09-27 13:57:54 -07:00
Erik Rose
dce9dfeefc Fix some typos and grammar in the docs. 2011-09-25 22:25:15 -07:00
Graydon Hoare
390677ebcc Switch URLs. 2011-09-20 16:27:08 -07:00
Marijn Haverbeke
d0d322ac93 Stop mentioning tail calls in reference
They don't work, and won't work in the near future.
2011-09-15 10:14:52 +02:00
Graydon Hoare
6dcd0a9b5e Remove mention of port, chan and task *types*, as they're not just library-provided. Move some text about channels into the comm section. 2011-09-14 14:48:40 -07:00
Graydon Hoare
f13acbdbf1 Remove talk of 'sharing boxes between tasks', old GC layer, etc. Add description of unique boxes. 2011-09-14 14:38:52 -07:00
Graydon Hoare
4e93ea8b1e Remove mention of the nonexistent (and no longer implementable) memory accounting model. 2011-09-14 14:22:27 -07:00
Graydon Hoare
c61f06fde9 Fix vector indexing notation, remove reference to 'slices'. 2011-09-14 14:13:47 -07:00
Graydon Hoare
7c782c10df Fix description of tuples. 2011-09-14 14:11:31 -07:00
Brian Anderson
79751348b3 Remove more references to reflection from docs 2011-09-14 13:32:09 -07:00
Graydon Hoare
431a27f9a8 Remove description of nonexistent stuff (reflection, meta directives); add description of attributes and tidy up description of syntax extensions. 2011-09-14 12:35:26 -07:00
Graydon Hoare
ffeb175239 Remove stuff that's either unimplemented or misleading. 2011-09-14 12:35:26 -07:00
Graydon Hoare
2812f3cf24 Remove misleading details. 2011-09-14 12:35:26 -07:00
Graydon Hoare
71297a5e17 Remove redundant line. 2011-09-12 14:17:32 -07:00
Marijn Haverbeke
982a1a4783 Rename alias to reference in docs and error messages
Update docs to reflect new approach to aliases
2011-09-12 14:24:46 +02:00
Paul Stansifer
5815f4f1de Update docs for macro-related stuff. 2011-08-26 15:13:57 -07:00
Tim Chevalier
63f9b43d36 Docs for pure fn and unchecked 2011-08-25 19:09:30 -07:00
Eric Holk
4d92cb5c63 Removing mention of domain, updating the communication examples. 2011-08-25 12:33:09 -07:00
Brian Anderson
556de425b3 Update docs for import/export 2011-08-17 11:33:34 -07:00
Graydon Hoare
ca82a690cf Move task/comm stuff from exprs to task in manual, change typarams from [] to <>. 2011-08-16 17:39:25 -07:00
Lindsey Kuper
133b3d05b4 Update syntax for function arguments; tweak object system examples to
make mutable fields work.
2011-08-11 16:19:51 -07:00
Lindsey Kuper
5d0f9d92ff Fix typo in docs that was causing makeinfo warning. 2011-08-11 16:19:51 -07:00
Graydon Hoare
c96f62a29d Fiddle the comm operators in the docs, add swap and move symbols (no docs yet). 2011-08-11 14:58:01 -07:00
Lindsey Kuper
d2c1fbd218 Stub out docs for anon objs; update existing object system docs. 2011-08-10 19:00:59 -07:00
Graydon Hoare
6b756c4b4a Update docs to describe kinds rather than layers, remove old terms. 2011-08-10 17:11:24 -07:00
Graydon Hoare
0daa4fb1c4 More decl fixes. 2011-08-10 17:11:24 -07:00
Graydon Hoare
a38a1b6c7a Fix some more declarations in example code in docs. 2011-08-10 17:11:24 -07:00
Graydon Hoare
1dd9240e56 Update docs regarding path syntax. 2011-08-10 17:11:24 -07:00
Graydon Hoare
2f35f645c3 Update frontmatter. 2011-08-10 17:11:24 -07:00
Graydon Hoare
5b084e4e36 Update docs to new let syntax. 2011-08-10 15:47:11 -07:00
Graydon Hoare
c7f1c36f2b Update docs on vector value syntax. 2011-08-10 15:16:45 -07:00
Graydon Hoare
c659ba4118 Update docs on record type and value syntax. 2011-08-10 14:50:01 -07:00
Graydon Hoare
8bc4291764 Some edits to introductory material in docs. 2011-08-10 14:50:01 -07:00
Tim Chevalier
8c757fcd40 Clarify docs about claim 2011-06-28 17:50:06 -07:00
Tim Chevalier
1d37118a00 Update docs for claim 2011-06-28 16:41:06 -07:00
Brian Anderson
eb0d56f8c5 Add a FIXME to the docs about literal suffixes 2011-06-25 19:28:19 -07:00
Brian Anderson
72f90f0f5f Turn doc FIXMEs into comments 2011-06-21 06:17:54 -07:00
Brian Anderson
7d1979d024 Add FIXMEs to meta documentation
Issue #487
2011-06-18 20:23:05 -07:00
Tim Chevalier
7cefd86d41 missing word in docs 2011-06-16 14:08:48 -07:00
Tim Chevalier
11db05cf1a Apparently my version of texinfo doesn't require curly braces to be escaped, but the buildbot's version does... 2011-05-23 10:41:47 -07:00
Tim Chevalier
ac3fd914b9 Update docs to talk about ! annotations 2011-05-23 10:33:14 -07:00
Graydon Hoare
48e0de22c1 Put out burning tinderbox. 2011-05-05 11:54:45 -07:00
Tim Chevalier
910a05d875 Update docs to reflect preds 2011-05-05 11:26:07 -07:00
Tim Chevalier
d9c9982f0a Update docs to reflect assert vs. check
Also added the --batch flag to texi2pdf, as it doesn't really ever
seem useful to drop to the TeX prompt during a build.
2011-05-05 11:26:07 -07:00
Graydon Hoare
3d9cf15d0b Remove half-baked 'opacity' layer qualifier. 2011-04-19 14:00:04 -07:00
Graydon Hoare
b7d680b57d Remove mention of effect system from manual. 2011-04-19 13:39:57 -07:00
Lindsey Kuper
0c873993c9 'Type' renamed to 'type definition'.
This is basically so people don't confuse a Ref.Item.Type with a
Ref.Type.
2011-04-18 11:49:32 -07:00
Graydon Hoare
6909e7ca78 Fix busted texi from last night. 2011-04-13 09:59:00 -07:00
Graydon Hoare
d3409f6368 Finish the majority of statement -> expression rearrangement in manual. 2011-04-12 18:27:03 -07:00
Tim Chevalier
d64b72f6ec More statement-to-expression edits 2011-04-04 17:35:10 -07:00
Lindsey Kuper
5de3f441d0 A trivial documentation commit. 2011-04-04 17:29:49 -07:00
Tim Chevalier
512bba264e Change 'statement' to 'expression' in a bunch of places 2011-04-04 17:02:31 -07:00
Lindsey Kuper
db5c809c83 Add 'self' keyword. 2011-03-28 21:13:42 -07:00
Brian Anderson
d7c67fc6ac Fix typo in Ref.Task.Comm 2011-03-25 08:43:10 -07:00
Graydon Hoare
29d853dd19 Remove obsolete Makefiles. 2011-03-24 14:56:51 -07:00
Brian Anderson
5d98f55fcf Update docs for if statements 2011-03-22 08:11:36 -07:00
Brian Anderson
e2d36e00ce Remove parens from nullary tag constructors in docs 2011-03-01 23:11:52 -05:00
Graydon Hoare
dabccadd32 Update manual to define identifiers using UAX 31 XID_Start / XID_Continue. 2011-02-25 15:43:50 -08:00
Sean Stangl
3339243254 Fix documentation: aliases may not be used in loop constructs. 2011-01-27 12:15:54 -08:00
benjaminjackman
7f4ec2c622 fixed typo in tuple menu label 2011-01-17 18:09:35 -08:00
Brian Anderson
74e6bb87d6 Update keyword list with 'const', 'thread' 2011-01-03 11:08:14 -08:00
Brian Anderson
c90d114d36 Use git log pretty printing arguments that are compatible with older versions of git 2011-01-03 11:06:52 -08:00
Graydon Hoare
3f227c71b2 Some terminology updates to talk about layers. 2010-12-14 13:41:19 -08:00
Ralph Giles
c038261762 Fix documentation: it's (&str s) not (str &s). 2010-11-03 15:37:56 -07:00
Ralph Giles
446932b5bc Fix doc references to 'for each' syntax to match the compiler.
The rustboot compiler expects 'for each (type v in ...)' like 'for',
rather than 'for each (type v = ...)' as given in the documentation.
2010-11-03 15:37:55 -07:00
Ralph Giles
4af0db4d76 Make version.texi depend on rust.texi.
This will at least update the version string on the title page
when the book source changes. It may not be entirely accurate
since rust.texi may have uncommitted changes. But previously,
it was basically only ever updated on the first build or after
'make clean'.
2010-11-03 15:37:54 -07:00
Ralph Giles
c45d21eb9b Fix two documentation typos. 2010-11-03 15:37:54 -07:00
Graydon Hoare
da13c508d8 First pass on splitting stratum and opacity off of effects. WIP. 2010-11-02 11:11:58 -07:00
Graydon Hoare
43ec78636f Update manual to cover change to nominal tag items. 2010-09-13 17:58:09 -07:00
Graydon Hoare
766b91d88b Add support for a reserved-words list and reserve the various not-supported-but-plausible IEEE datatypes. 2010-08-17 14:48:00 -07:00
Jeffrey Yasskin
b71340552f Add names to tasks and domains. These can either be an explicit literal string
after the "spawn" keyword, or implicitly the call expression used to start the
spawn.
2010-08-09 11:43:16 +02:00
Graydon Hoare
e08ed23a80 Make note of new literal forms in docs. 2010-07-29 16:04:22 -07:00
Brian Anderson
0633c7ae6e Fix syntax of tag variants in the list example 2010-07-18 14:25:50 +08:00
Jeffrey Yasskin
bd56de745b Explain that rust methods can't call other methods on the same object, either
implicitly or explicitly.
2010-07-18 14:25:18 +08:00
Graydon Hoare
405cd282a3 Typo fixes to docs, from Ralph Giles. 2010-07-13 16:04:31 -07:00
Graydon Hoare
02bdc27f5a Doc fix. 2010-07-13 14:22:33 -07:00
Jeff Balogh
6f5ef5815b Fix typos in the docs. 2010-07-13 06:06:44 +08:00
Graydon Hoare
ddf49afe08 Remove "two's complement unsigned" integer type descriptions from docs, nurr. 2010-07-08 22:05:07 -07:00
Matt Brubeck
244ea68082 Issue 66: Multi-line comments 2010-07-08 22:43:15 +08:00
Graydon Hoare
d39753685b Doc tweak. 2010-07-08 07:28:21 -07:00
Graydon Hoare
658d9238b7 Clean in doc dir a little harder. 2010-07-04 15:39:53 -07:00
Graydon Hoare
f2ffa57ddf Add stamp target to doc/Makefile. 2010-07-03 21:48:31 -07:00
Graydon Hoare
965e5287ba Add concept-index entries to docs, plus fix a few minor nits. 2010-07-03 17:29:06 -07:00
Graydon Hoare
df0fa603d0 Add version-stamp machinery (and put "Draft + datestamp" into doc footer). 2010-07-03 00:27:33 -07:00
Roy Frostig
c5a3c9736a Clarify manual's explanation of unwinding during failure. Add bit about soft vs. hard failure. 2010-07-02 18:33:09 -07:00
Roy Frostig
8b88fbf3aa Minor clarification/typo-correcting edits to manual sections up to and including Ref.Mem chapter. 2010-07-02 13:39:42 -07:00
Roy Frostig
2683ae64bf Remove nameless node causing errors on doc make. 2010-07-02 10:09:58 -07:00
Graydon Hoare
a0c9d4fe9a Strip out over-aggressive pagination in manual. 2010-07-01 09:37:28 -07:00
Graydon Hoare
8bf6ae99f4 I lied; ObjC 2.0 did not actually pick up CLU/Sather iterators. They've been dormant since the 90s. Sigh. 2010-07-01 09:37:06 -07:00
Graydon Hoare
0bc1ad60ef Union is a more familiar term than sum. 2010-07-01 09:36:22 -07:00
Graydon Hoare
cb04275afa Add machine-dependent 'float' type. 2010-07-01 09:35:48 -07:00
Graydon Hoare
3aaff59dba Describe numeric and textual literals better; clean up lexeme descriptions a bit. 2010-07-01 09:00:47 -07:00
Graydon Hoare
aa614d5280 Modify manual to reflect new box/local terminology and new slot/type roles for box and mutable. 2010-07-01 01:13:42 -07:00
Graydon Hoare
d6b7c96c3e Populate tree. 2010-06-23 21:03:09 -07:00
Graydon Hoare
c01efc669f Initial git commit. 2010-06-16 14:30:45 -07:00