dnrops
/
rfcs
mirror of https://github.com/rust-lang/rfcs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Add more disambiguators to match PR

This commit is contained in:
Manish Goregaokar 2018-01-19 18:16:02 +05:30
parent ee53b90052
commit 0b17ddf4b5
1 changed files with 5 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
text/1946-intra-rustdoc-links.md
View File

@ -307,6 +307,8 @@ Our proposal is this:
- It is possible that disambiguators for one kind of type-namespace object - It is possible that disambiguators for one kind of type-namespace object
will work for the other (i.e. you can use `struct@` to refer to an enum), will work for the other (i.e. you can use `struct@` to refer to an enum),
but do not rely on this. but do not rely on this.
- Modules exist in both the type and value namespace and can be disambiguated
with a `mod@` or `module@`, e.g. `[module@foo]`
- In links to macros, - In links to macros,
the link label can end with a `!`, the link label can end with a `!`,
e.g., `Look at the [FOO!] macro`. You can alternatively use a `macro@` prefix, e.g., `Look at the [FOO!] macro`. You can alternatively use a `macro@` prefix,
@ -314,8 +316,9 @@ Our proposal is this:
- For disambiguating links to values, we differentiate three cases: - For disambiguating links to values, we differentiate three cases:
- Links to any kind of value (function, const, static) can be prefixed with `value@`, - Links to any kind of value (function, const, static) can be prefixed with `value@`,
e.g., `See [value@foo]`. e.g., `See [value@foo]`.
- Links to functions can be written with a `()` suffix, - Links to functions and methods can be written with a `()` suffix,
e.g., `Also see the [foo()] function`. You can also use `function@`. e.g., `Also see the [foo()] function`. You can also use `function@`, `fn@`,
or `method@`.
- Links to constants are prefixed with `const@`, - Links to constants are prefixed with `const@`,
e.g., `As defined in [const@FOO].` e.g., `As defined in [const@FOO].`
- Links to statics are prefixed with `static@`, - Links to statics are prefixed with `static@`,