rust/src/doc
bors 295d98069f Auto merge of #50390 - hdhoang:46205_deny_by_default, r=nikomatsakis
lint: deny incoherent_fundamental_impls by default

Warn the ecosystem of the pending intent-to-disallow in #49799.

There are 4 ICEs on my machine, look unrelated (having happened before in https://github.com/rust-lang/rust/issues/49146#issuecomment-384473523)

```rust
thread 'main' panicked at 'assertion failed: position <= slice.len()', libserialize/leb128.rs:97:1
```

```
    [run-pass] run-pass/allocator/xcrate-use2.rs
    [run-pass] run-pass/issue-12133-3.rs
    [run-pass] run-pass/issue-32518.rs
    [run-pass] run-pass/trait-default-method-xc-2.rs
```

r? @nikomatsakis
2018-05-08 04:56:01 +00:00
..
book@f51127530d Update books for the next release. 2018-05-05 19:02:13 -04:00
man
nomicon@748a5e6742 Update books for the next release. 2018-05-05 19:02:13 -04:00
reference@134f419ee6 Update books for the next release. 2018-05-05 19:02:13 -04:00
rust-by-example@eebda16e4b Update books for the next release. 2018-05-05 19:02:13 -04:00
rustc ignore erroneous example 2018-05-03 08:17:21 +07:00
rustdoc Add doc about doc alias feature 2018-04-22 00:30:48 +02:00
unstable-book Add tool_attributes feature to unstable book 2018-05-02 11:48:11 +02: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 update doc index to link to the rustc book 2018-04-09 14:04:57 -04:00
intro.md
not_found.md
README.md
reference.md
rust.css
rust.md
rustc-ux-guidelines.md Move librustc_const_eval to librustc_mir 2018-03-08 08:08:14 +01:00
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.