rust/src/doc
Mark Simulacrum 50799265ca Test src/doc once more 2017-07-10 11:43:02 -06:00
..
book@325c3da081 update book with redirect fixes 2017-06-14 15:48:43 -04:00
nomicon@eee5ffb127 Test src/doc once more 2017-07-10 11:43:02 -06:00
reference@876582e9d0 Update various book repos for the next release. 2017-06-01 20:29:57 -04:00
rustdoc fix tests 2017-06-05 13:14:31 -04:00
unstable-book Test src/doc once more 2017-07-10 11:43:02 -06:00
README.md rustbuild: Run all markdown documentation tests 2016-04-19 09:52:56 -07:00
complement-design-faq.md Remove the FAQs in favor of the website 2015-12-23 14:03:45 -08:00
complement-lang-faq.md Remove the FAQs in favor of the website 2015-12-23 14:03:45 -08:00
complement-project-faq.md Remove the FAQs in favor of the website 2015-12-23 14:03:45 -08:00
favicon.inc Use https URLs to refer to rust-lang.org where appropriate. 2015-08-09 14:28:46 -07:00
footer.inc rustdoc: Improve playground run buttons 2016-10-15 18:32:03 +01:00
full-toc.inc
grammar.md Add `_` to the list of keywords 2017-06-17 13:14:26 -07:00
guide-crates.md
guide-error-handling.md
guide-ffi.md
guide-macros.md
guide-ownership.md
guide-plugins.md Add top level sections to the Unstable Book. 2017-04-18 21:26:09 -04:00
guide-pointers.md Change removal notice for pointer guide. 2015-06-29 15:18:00 -04:00
guide-strings.md
guide-tasks.md Fix broken link in old rust guide 2015-03-04 23:18:24 +00:00
guide-testing.md
guide-unsafe.md
guide.md
index.md Clarify the doc index 2017-04-25 05:35:51 -04:00
intro.md Remove the 30 minute intro 2015-04-18 17:55:31 -04:00
not_found.md Use https URLs to refer to rust-lang.org where appropriate. 2015-08-09 14:28:46 -07:00
reference.md Redirect to the new reference 2017-02-21 14:03:13 -05:00
rust.css Avoid using locally installed Source Code Pro font (fixes #24355). 2016-12-04 13:44:19 -08:00
rust.md Avoid linking to a moved page in rust.html 2017-03-29 15:38:47 +02:00
rustc-ux-guidelines.md Update rustc-ux-guidelines.md 2017-05-08 18:15:23 -07:00
rustdoc.md
tutorial.md
version_info.html.template Add alt tags for logos 2016-01-20 11:53:20 -05:00

README.md

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.