0
0
mirror of https://github.com/rust-lang/rust.git synced 2024-11-22 10:25:09 +01:00
rust/doc
2013-05-03 20:01:42 -04:00
..
lib
lib.css
manual.css
prep.js
README add gitattributes and fix whitespace issues 2013-05-03 20:01:42 -04:00
rust.css
rust.md add gitattributes and fix whitespace issues 2013-05-03 20:01:42 -04:00
rustpkg.md
tutorial-borrowed-ptr.md
tutorial-ffi.md
tutorial-macros.md add gitattributes and fix whitespace issues 2013-05-03 20:01:42 -04:00
tutorial-tasks.md add gitattributes and fix whitespace issues 2013-05-03 20:01:42 -04:00
tutorial.md add gitattributes and fix whitespace issues 2013-05-03 20:01:42 -04:00
version_info.html.template add gitattributes and fix whitespace issues 2013-05-03 20:01:42 -04:00

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