Uh oh!
There was an error while loading. Please reload this page.
Add list of supported disambiguators and suffixes for intra-doc links in the rustdoc book - #110348
Conversation
jyn514
commented
Apr 15, 2023
cc @Manishearth , I remember last time I suggested adding this you thought having it in the error messages was enough. |
GuillaumeGomez
commented
Apr 15, 2023
It's what I thought too and then I re-discovered the auto-disambiguation of trait and derive proc-macro and because of this, I think providing the list of disambiguators is now something we must provide. But even before that, providing the list of disambiguators seems like something we should provide just so that people aren't surprised when they see them. Having an "official list" is always a good thing imo. |
notriddle
commented
Apr 15, 2023
Here’s where the disambiguators are actually implemented: https://github.com/rust-lang/rust/blob/master/src/librustdoc/passes/collect_intra_doc_links.rs#L1416 Perhaps add a comment there reminding anyone adding a new disambiguator to also update the book? |
GuillaumeGomez
commented
Apr 15, 2023
Good idea! |
GuillaumeGomez
commented
Apr 15, 2023
Added code comments. |
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
bef32f4 to
fbc7696CompareGuillaumeGomez
commented
Apr 16, 2023
Updated as suggested. |
Uh oh!
There was an error while loading. Please reload this page.
… in the rustdoc book
…y update the disambiguators list
fbc7696 to
1531c95CompareGuillaumeGomez
commented
Apr 17, 2023
Applied suggestion. |
Manishearth
commented
Apr 17, 2023
@bors r+ rollup |
bors
commented
Apr 17, 2023
…ixes-rustdoc-book, r=Manishearth Add list of supported disambiguators and suffixes for intra-doc links in the rustdoc book This information is otherwise only provided in case an error occurs, which isn't great. r? `@notriddle`
…ixes-rustdoc-book, r=Manishearth Add list of supported disambiguators and suffixes for intra-doc links in the rustdoc book This information is otherwise only provided in case an error occurs, which isn't great. r? ``@notriddle``
…iaskrgr Rollup of 7 pull requests Successful merges: - rust-lang#109981 (Set commit information environment variables when building tools) - rust-lang#110348 (Add list of supported disambiguators and suffixes for intra-doc links in the rustdoc book) - rust-lang#110409 (Don't use `serde_json` to serialize a simple JSON object) - rust-lang#110442 (Avoid including dry run steps in the build metrics) - rust-lang#110450 (rustdoc: Fix invalid handling of nested items with `--document-private-items`) - rust-lang#110461 (Use `Item::expect_*` and `ImplItem::expect_*` more) - rust-lang#110465 (Assure everyone that `has_type_flags` is fast) Failed merges: r? `@ghost` `@rustbot` modify labels: rollup
This information is otherwise only provided in case an error occurs, which isn't great.
r? @notriddle