rust/doc
Felix S. Klock II 6cabe2b902 Fixed two examples of erroneous code so their errors match expectation.
1. In the first case, the previous code was failing during type inference
   due to mismatched structure.  Fix is to use the X structure at both
   points in the code.

2. In the second case, a naive transcription that subsitutes *nothing*
   in for the omitted statements signified by "..." will actually
   compile without an error.  Furthermore, any pure code could also be
   substituted for the ellipsis and the code would compile (as the
   text already states).  So to make the example more illustrative, it
   would be better to include an impure callback, which makes the
   potential for aliasing immediately obvious to the reader.
2013-01-29 11:28:52 +01:00
..
lib
lib.css
manual.css
prep.js
README
rust.css
rust.md doc typo 2013-01-25 11:58:33 -08:00
tutorial-borrowed-ptr.md Fixed two examples of erroneous code so their errors match expectation. 2013-01-29 11:28:52 +01:00
tutorial-ffi.md doc: fix tutorial unsafe blocks, r=burningtree. 2013-01-23 23:21:47 -08:00
tutorial-macros.md doc: Fix spelling error in macro tutorial 2013-01-12 18:36:46 -05:00
tutorial-tasks.md doc: Fix tutorial typo and remove unnecessary xfail-test 2013-01-20 22:56:45 -08:00
tutorial.md Fix two code examples in main rust tutorial. 2013-01-29 11:28:52 +01:00
version_info.html.template

The markdown docs are only generated by make when node is installed (use
`make doc`). If you don't have node installed you can generate them yourself. 
Unfortunately there's no real standard for markdown and all the tools work 
differently. pandoc is one that seems to work well.

To generate an html version of a doc do something like:
pandoc --from=markdown --to=html --number-sections -o build/doc/rust.html doc/rust.md && git web--browse build/doc/rust.html

The syntax for pandoc flavored markdown can be found at:
http://johnmacfarlane.net/pandoc/README.html#pandocs-markdown

A nice quick reference (for non-pandoc markdown) is at:
http://kramdown.rubyforge.org/quickref.html