rust/src/test/rustdoc-ui/intra-doc/malformed-generics.rs

#![deny(rustdoc::broken_intra_doc_links)]

//! [Vec<] //~ ERROR
//! [Vec<Box<T] //~ ERROR
//! [Vec<Box<T>] //~ ERROR
//! [Vec<Box<T>>>] //~ ERROR
//! [Vec<T>>>] //~ ERROR
//! [<Vec] //~ ERROR
//! [Vec::<] //~ ERROR
//! [<T>] //~ ERROR
//! [<invalid syntax>] //~ ERROR
//! [Vec:<T>:new()] //~ ERROR
//! [Vec<<T>>] //~ ERROR
//! [Vec<>] //~ ERROR
//! [Vec<<>>] //~ ERROR

// FIXME(#74563) support UFCS
//! [<Vec as IntoIterator>::into_iter] //~ ERROR
//! [<Vec<T> as IntoIterator>::iter] //~ ERROR
Rename rustdoc lints to be a tool lint instead of built-in. - Rename `broken_intra_doc_links` to `rustdoc::broken_intra_doc_links` - Ensure that the old lint names still work and give deprecation errors - Register lints even when running doctests Otherwise, all `rustdoc::` lints would be ignored. - Register all existing lints as removed This unfortunately doesn't work with `register_renamed` because tool lints have not yet been registered when rustc is running. For similar reasons, `check_backwards_compat` doesn't work either. Call `register_removed` directly instead. - Fix fallout + Rustdoc lints for compiler/ + Rustdoc lints for library/ Note that this does not suggest `rustdoc::broken_intra_doc_links` for `rustdoc::intra_doc_link_resolution_failure`, since there was no time when the latter was valid. 2020-12-29 23:16:16 -05:00			`#![deny(rustdoc::broken_intra_doc_links)]`
Allow generic parameters in intra-doc links The contents of the generics will be mostly ignored (except for warning if fully-qualified syntax is used, which is currently unsupported in intra-doc links - see issue #74563). * Allow links like `Vec<T>`, `Result<T, E>`, and `Option<Box<T>>` * Allow links like `Vec::<T>::new()` * Warn on * Unbalanced angle brackets (e.g. `Vec<T` or `Vec<T>>`) * Missing type to apply generics to (`<T>` or `<Box<T>>`) * Use of fully-qualified syntax (`<Vec as IntoIterator>::into_iter`) * Invalid path separator (`Vec:<T>:new`) * Too many angle brackets (`Vec<<T>>`) * Empty angle brackets (`Vec<>`) Note that this implementation does allow some constructs that aren't valid in the actual Rust syntax, for example `Box::<T>new()`. That may not be supported in rustdoc in the future; it is an implementation detail. 2020-10-08 22:24:34 -07:00
			`//! [Vec<] //~ ERROR`
			`//! [Vec<Box<T] //~ ERROR`
			`//! [Vec<Box<T>] //~ ERROR`
			`//! [Vec<Box<T>>>] //~ ERROR`
			`//! [Vec<T>>>] //~ ERROR`
			`//! [<Vec] //~ ERROR`
			`//! [Vec::<] //~ ERROR`
			`//! [<T>] //~ ERROR`
			`//! [<invalid syntax>] //~ ERROR`
			`//! [Vec:<T>:new()] //~ ERROR`
			`//! [Vec<<T>>] //~ ERROR`
			`//! [Vec<>] //~ ERROR`
			`//! [Vec<<>>] //~ ERROR`

			`// FIXME(#74563) support UFCS`
			`//! [<Vec as IntoIterator>::into_iter] //~ ERROR`
			`//! [<Vec<T> as IntoIterator>::iter] //~ ERROR`