1
Fork 0

Use spans pointing at the inside of a rustdoc attribute

This commit is contained in:
Esteban Küber 2018-06-06 00:30:25 -07:00
parent 41affd03eb
commit 507dfd2148
3 changed files with 71 additions and 52 deletions

View file

@ -1191,30 +1191,44 @@ fn resolution_failure(
link_range: Option<Range<usize>>, link_range: Option<Range<usize>>,
) { ) {
let sp = span_of_attrs(attrs); let sp = span_of_attrs(attrs);
let mut diag = cx.sess() let msg = format!("`[{}]` cannot be resolved, ignoring it...", path_str);
.struct_span_warn(sp, &format!("[{}] cannot be resolved, ignoring it...", path_str));
if let Some(link_range) = link_range { let code_dox = sp.to_src(cx);
// The whitespace before the `///` to properly find the original span location.
let dox_leading_whitespace = code_dox.lines().nth(1)
.map(|x| x.len() - x.trim_left().len()).unwrap_or(0);
let doc_comment_padding = 3;
let mut diag = if let Some(link_range) = link_range {
// blah blah blah\nblah\nblah [blah] blah blah\nblah blah // blah blah blah\nblah\nblah [blah] blah blah\nblah blah
// ^ ~~~~~~ // ^ ~~~~~~
// | link_range // | link_range
// last_new_line_offset // last_new_line_offset
let last_new_line_offset = dox[..link_range.start].rfind('\n').map_or(0, |n| n + 1); let line_offset = dox[..link_range.start].lines().count();
let line = dox[last_new_line_offset..].lines().next().unwrap_or(""); let code_dox_len = if line_offset <= 1 {
// The span starts in the `///`, so we don't have to account for the leading whitespace
doc_comment_padding
} else {
// The first `///`
doc_comment_padding +
// Each subsequent leading whitespace and `///`
(doc_comment_padding + dox_leading_whitespace)
// The line position inside the doc string
* (line_offset - 1)
};
// Print the line containing the `link_range` and manually mark it with '^'s // Extract the specific span
diag.note(&format!( let lo = sp.lo() + syntax_pos::BytePos((link_range.start + code_dox_len) as u32);
"the link appears in this line:\n\n{line}\n{indicator: <before$}{indicator:^<found$}", let hi = lo + syntax_pos::BytePos(link_range.len() as u32);
line=line, let sp = sp.with_lo(lo).with_hi(hi);
indicator="",
before=link_range.start - last_new_line_offset, let mut diag = cx.sess().struct_span_warn(sp, &msg);
found=link_range.len(), diag.span_label(sp, "cannot be resolved, ignoring");
)); diag
} else { } else {
cx.sess().struct_span_warn(sp, &msg)
} };
diag.emit(); diag.emit();
} }

View file

@ -10,10 +10,12 @@
// compile-pass // compile-pass
//! Test with [Foo::baz], [Bar::foo], ... //! Test with [Foo::baz], [Bar::foo], ...
//! //! , [Uniooon::X] and [Qux::Z].
//! and [Uniooon::X]. //! .
//! , [Uniooon::X] and [Qux::Z].
/// [Qux:Y]
pub struct Foo { pub struct Foo {
pub bar: usize, pub bar: usize,
} }

View file

@ -1,39 +1,42 @@
warning: [Foo::baz] cannot be resolved, ignoring it... warning: `[Foo::baz]` cannot be resolved, ignoring it...
--> $DIR/intra-links-warning.rs:13:1 --> $DIR/intra-links-warning.rs:13:23
| |
13 | / //! Test with [Foo::baz], [Bar::foo], ... 13 | //! Test with [Foo::baz], [Bar::foo], ...
14 | | //! | ^^^^^^^^ cannot be resolved, ignoring
15 | | //! and [Uniooon::X].
| |_____________________^
|
= note: the link appears in this line:
Test with [Foo::baz], [Bar::foo], ...
^^^^^^^^
warning: [Bar::foo] cannot be resolved, ignoring it... warning: `[Bar::foo]` cannot be resolved, ignoring it...
--> $DIR/intra-links-warning.rs:13:1 --> $DIR/intra-links-warning.rs:13:35
| |
13 | / //! Test with [Foo::baz], [Bar::foo], ... 13 | //! Test with [Foo::baz], [Bar::foo], ...
14 | | //! | ^^^^^^^^ cannot be resolved, ignoring
15 | | //! and [Uniooon::X].
| |_____________________^
|
= note: the link appears in this line:
Test with [Foo::baz], [Bar::foo], ...
^^^^^^^^
warning: [Uniooon::X] cannot be resolved, ignoring it... warning: `[Uniooon::X]` cannot be resolved, ignoring it...
--> $DIR/intra-links-warning.rs:13:1 --> $DIR/intra-links-warning.rs:14:15
| |
13 | / //! Test with [Foo::baz], [Bar::foo], ... 14 | //! , [Uniooon::X] and [Qux::Z].
14 | | //! | ^^^^^^^^^^ cannot be resolved, ignoring
15 | | //! and [Uniooon::X].
| |_____________________^ warning: `[Qux::Z]` cannot be resolved, ignoring it...
| --> $DIR/intra-links-warning.rs:14:32
= note: the link appears in this line: |
14 | //! , [Uniooon::X] and [Qux::Z].
and [Uniooon::X]. | ^^^^^^ cannot be resolved, ignoring
^^^^^^^^^^
warning: `[Uniooon::X]` cannot be resolved, ignoring it...
--> $DIR/intra-links-warning.rs:16:15
|
16 | //! , [Uniooon::X] and [Qux::Z].
| ^^^^^^^^^^ cannot be resolved, ignoring
warning: `[Qux::Z]` cannot be resolved, ignoring it...
--> $DIR/intra-links-warning.rs:16:32
|
16 | //! , [Uniooon::X] and [Qux::Z].
| ^^^^^^ cannot be resolved, ignoring
warning: `[Qux:Y]` cannot be resolved, ignoring it...
--> $DIR/intra-links-warning.rs:18:13
|
18 | /// [Qux:Y]
| ^^^^^ cannot be resolved, ignoring