File: disambiguators-removed.rs

package info (click to toggle)
rustc 1.87.0%2Bdfsg1-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 925,564 kB
  • sloc: xml: 158,127; python: 36,039; javascript: 19,761; sh: 19,737; cpp: 18,981; ansic: 13,133; asm: 4,376; makefile: 710; perl: 29; lisp: 28; ruby: 19; sql: 11
file content (50 lines) | stat: -rw-r--r-- 1,748 bytes parent folder | download | duplicates (14)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
#![deny(rustdoc::broken_intra_doc_links)]
// first try backticks
/// Trait: [`trait@Name`], fn: [`fn@Name`], [`Name`][`macro@Name`]
//@ has disambiguators_removed/struct.AtDisambiguator.html
//@ has - '//a[@href="trait.Name.html"][code]' "Name"
//@ has - '//a[@href="fn.Name.html"][code]' "Name"
//@ has - '//a[@href="macro.Name.html"][code]' "Name"
pub struct AtDisambiguator;

/// fn: [`Name()`], macro: [`Name!`]
//@ has disambiguators_removed/struct.SymbolDisambiguator.html
//@ has - '//a[@href="fn.Name.html"][code]' "Name()"
//@ has - '//a[@href="macro.Name.html"][code]' "Name!"
pub struct SymbolDisambiguator;

// Now make sure that backticks aren't added if they weren't already there
/// [fn@Name]
//@ has disambiguators_removed/trait.Name.html
//@ has - '//a[@href="fn.Name.html"]' "Name"
//@ !has - '//a[@href="fn.Name.html"][code]' "Name"

// FIXME: this will turn !() into ! alone
/// [Name!()]
//@ has - '//a[@href="macro.Name.html"]' "Name!"
pub trait Name {}

#[allow(non_snake_case)]

// Try collapsed reference links
/// [macro@Name][]
//@ has disambiguators_removed/fn.Name.html
//@ has - '//a[@href="macro.Name.html"]' "Name"

// Try links that have the same text as a generated URL
/// Weird URL aligned [macro.Name.html][trait@Name]
//@ has - '//a[@href="trait.Name.html"]' "macro.Name.html"
pub fn Name() {}

#[macro_export]
// Rustdoc doesn't currently handle links that have weird interspersing of inline code blocks.
/// [fn@Na`m`e]
//@ has disambiguators_removed/macro.Name.html
//@ has - '//a[@href="fn.Name.html"]' "fn@Name"

// It also doesn't handle any case where the code block isn't the whole link text:
/// [trait@`Name`]
//@ has - '//a[@href="trait.Name.html"]' "trait@Name"
macro_rules! Name {
    () => ()
}