mikros/rust
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Rollup merge of #90398 - GuillaumeGomez:doc-keyword-doc, r=camelid

Browse Source 
Document `doc(keyword)` unstable attribute

r? `@camelid`
This commit is contained in:
Matthias Krüger 2021-11-01 03:33:08 +01:00 committed by GitHub
commit 0b8d3b1854
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 20 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
src/doc/rustdoc/src/unstable-features.md
View File

@ -134,9 +134,27 @@ Book][unstable-masked] and [its tracking issue][issue-masked].
## Document primitives
This is for Rust compiler internal use only.
Since primitive types are defined in the compiler, there's no place to attach documentation
attributes. The `#[doc(primitive)]` attribute is used by the standard library to provide a way to generate
documentation for primitive types, and requires `#![feature(doc_primitive)]` to enable.
attributes. The `#[doc(primitive)]` attribute is used by the standard library to provide a way
to generate documentation for primitive types, and requires `#![feature(doc_primitive)]` to enable.
## Document keywords
This is for Rust compiler internal use only.
Rust keywords are documented in the standard library (look for `match` for example).
To do so, the `#[doc(keyword = "...")]` attribute is used. Example:
```rust
#![feature(doc_keyword)]
/// Some documentation about the keyword.
#[doc(keyword = "keyword")]
mod empty_mod {}
```
## Unstable command-line arguments