rust/src/doc
kennytm b6f4cea79d Rollup merge of #45250 - brauliobz:non-ascii-idents-details, r=steveklabnik
Moved details of unstable non-ascii identifiers from the Reference

Moved details of unstable non-ascii identifiers from the Reference to the Unstable book

r? @steveklabnik
2017-10-15 14:21:52 +08:00
..
book@08e79609ce update books for next release 2017-10-02 12:07:28 -04:00
man cleanup: rustc doesn't use an external archiver 2017-10-09 22:36:08 +03:00
nomicon@0ee3f7265e update books for next release 2017-10-02 12:07:28 -04:00
reference@36adc6ae50 update books for next release 2017-10-02 12:07:28 -04:00
rustdoc Add precision for rustdoc block codes 2017-09-03 13:15:16 +02:00
unstable-book Fixed link to keywords page in the reference 2017-10-13 17:15:28 -03:00
complement-design-faq.md
complement-lang-faq.md
complement-project-faq.md
favicon.inc
footer.inc
full-toc.inc
grammar.md
guide-crates.md
guide-error-handling.md
guide-ffi.md
guide-macros.md
guide-ownership.md
guide-plugins.md
guide-pointers.md
guide-strings.md
guide-tasks.md
guide-testing.md
guide-unsafe.md
guide.md
index.md link to the rustdoc book from the main docs 2017-08-14 13:58:21 -04:00
intro.md
not_found.md
README.md
reference.md
rust.css
rust.md
rustc-ux-guidelines.md
rustdoc.md
tutorial.md
version_info.html.template

Rust documentations

Building

To generate all the docs, follow the "Building Documentation" instructions in the README in the root of the repository. This will convert the distributed Markdown docs to HTML and generate HTML doc for the books, 'std' and 'extra' libraries.

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

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

(This, of course, requires a working build of the rustdoc tool.)

Additional notes

To generate an HTML version of a doc from Markdown manually, you can do something like:

rustdoc reference.md

(reference.md being the Rust Reference Manual.)

An overview of how to use the rustdoc command is available in the docs. Further details are available from the command line by with rustdoc --help.