0
0
mirror of https://github.com/rust-lang/rust.git synced 2024-12-01 13:18:54 +01:00
rust/doc
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
..
lib
lib.css
manual.css
prep.js
README
rust.css
rust.md auto merge of #5703 : steveklabnik/rust/add_log_docs, r=thestinger 2013-04-04 00:18:45 -07:00
tutorial-borrowed-ptr.md
tutorial-ffi.md librustc: Remove fail_unless! 2013-03-29 16:39:08 -07:00
tutorial-macros.md
tutorial-tasks.md doc: Rewrite task tutorial intro 2013-04-03 22:54:58 -07:00
tutorial.md auto merge of #5721 : dhardy/rust/master, r=graydon 2013-04-05 18:54:52 -07: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