itsscb/rust
1
0
Fork 0
mirror of https://github.com/rust-lang/rust.git synced 2026-03-23 15:45:23 +00:00
Code Issues Packages Projects Releases Wiki Activity

Make note of documentation tests and binaries

Browse Source 
Fixes #24228
This commit is contained in:
Steve Klabnik
2015-04-16 15:55:10 -04:00
parent a2ccc81f4b
commit dc4554a9b3
1 changed files with 4 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
src/doc/trpl/documentation.md
View File

@@ -380,7 +380,10 @@ $ rustdoc --test path/to/my/crate/root.rs
$ cargo test
```
That's right, `cargo test` tests embedded documentation too.
That's right, `cargo test` tests embedded documentation too. However,
`cargo test` will not test binary crates, only library ones. This is
due to the way `rustdoc` works: it links against the library to be tested,
but with a binary, there’s nothing to link to.
There are a few more annotations that are useful to help `rustdoc` do the right
thing when testing your code: