bjoernager/rust
bjoernager/rust
1
Fork 0
Code Activity

Rollup merge of #121021 - GuillaumeGomez:extend-intra-doc-link-chapter, r=notriddle

Browse source 
Extend intra-doc link chapter in the rustdoc book

Linked to #117178.

r? `@notriddle`
This commit is contained in:
Matthias Krüger 2024-02-13 17:38:12 +01:00 • committed by GitHub
commit cc171de476
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 18 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

18
src/doc/rustdoc/src/write-documentation/linking-to-items-by-name.md
View file

@ -151,3 +151,21 @@ will be given, even if the link fails to resolve. For example, any link containi
characters will be ignored. characters will be ignored.
[#72243]: https://github.com/rust-lang/rust/issues/72243 [#72243]: https://github.com/rust-lang/rust/issues/72243
## What happens in case an intra-doc link cannot be generated
In some cases (items behind a `cfg` for example), an intra-doc link cannot be generated to item.
There are different ways to create a link in markdown, and depending on the one you use, it will
render differently in this case:
```md
1. [a]
2. [b][c]
3. [d](e)
4. [f]
[f]: g
```
`1.` and `2.` will will be displayed as is in the rendered documentation (ie, `[a]` and `[b][c]`)
whereas `3.` and `4.` will be replaced by a link targetting `e` for `[d](e)` and `g` for `[f]`.