rust/doc
Adrien Tétar 5a01dbe67b doc: disable parser error highlighting + a few fixes
CodeMirror parser errors are related to #9873.
2013-11-13 09:32:29 +01:00
..
lib Remove fail keyword from lexer & parser and clean up remaining calls to 2013-02-01 00:15:42 -08:00
po Grammar error and vim syntax highlighting mistake fixed. 2013-11-02 21:34:29 -07:00
manual.inc doc: disable parser error highlighting + a few fixes 2013-11-13 09:32:29 +01:00
po4a.conf doc: Generate .po files for Japanse translations 2013-08-12 22:39:31 +09:00
prep.js fix escape 2012-10-05 12:41:00 -07:00
README doc: switch pandoc to html5 2013-10-19 20:29:34 +02:00
rust.css doc: disable parser error highlighting + a few fixes 2013-11-13 09:32:29 +01:00
rust.md auto merge of #10243 : mattcarberry/rust/master, r=brson 2013-11-07 17:26:12 -08:00
rustpkg.md rustpkg: Make checked-out source files read-only, and overhaul where temporary files are stored 2013-10-10 15:16:31 -07:00
tutorial-borrowed-ptr.md remove the float type 2013-10-01 14:54:10 -04:00
tutorial-conditions.md doc: Don't mention TLS in condition tutorial 2013-11-11 04:29:09 -08:00
tutorial-container.md docs: Replace std::iterator with std::iter. 2013-11-04 10:01:00 +11:00
tutorial-ffi.md Remove #[fixed_stack_segment] and #[rust_stack] 2013-11-11 10:40:34 -08:00
tutorial-macros.md doc: disable parser error highlighting + a few fixes 2013-11-13 09:32:29 +01:00
tutorial-rustpkg.md doc: disable parser error highlighting + a few fixes 2013-11-13 09:32:29 +01:00
tutorial-tasks.md doc: disable parser error highlighting + a few fixes 2013-11-13 09:32:29 +01:00
tutorial.md doc: disable parser error highlighting + a few fixes 2013-11-13 09:32:29 +01:00
version_info.html.template doc/rust.HTML: proper version box 2013-10-19 20:31:53 +02:00

Pandoc, a universal document converter, is required to generate docs as HTML
from Rust's source code. It's available for most platforms here:
http://johnmacfarlane.net/pandoc/installing.html

Node.js (http://nodejs.org/) is also required for generating HTML from
the Markdown docs (reference manual, tutorials, etc.) distributed with
this git repository.

To generate all the docs, run `make docs` from the root of the repository.
This will convert the distributed Markdown docs to HTML and generate HTML doc
for the 'std' and 'extra' libraries.

To generate HTML documentation from one source file/crate, do something like:

  rustdoc --output-dir html-doc/ --output-format html ../src/libstd/path.rs

(This, of course, requires that you've built/installed the `rustdoc` tool.)

To generate an HTML version of a doc from Markdown, without having Node.js
installed, do something like:

  pandoc --from=markdown --to=html5 --number-sections -o rust.html rust.md

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