1498608135
Fixes #58700 Fixes #58696 Fixes #49553 Fixes #52210 This commit removes the special rustdoc handling for proc macros, as we can now retrieve their span and attributes just like any other item. A new command-line option is added to rustdoc: `--crate-type`. This takes the same options as rustc's `--crate-type` option. However, all values other than `proc-macro` are treated the same. This allows Rustdoc to enable 'proc macro mode' when handling a proc macro crate. In compiletest, a new 'rustdoc-flags' option is added. This allows us to pass in the '--proc-macro-crate' flag in the absence of Cargo. I've opened [an additional PR to Cargo](https://github.com/rust-lang/cargo/pull/7159) to support passing in this flag. These two PRS can be merged in any order - the Cargo changes will not take effect until the 'cargo' submodule is updated in this repository.
73 lines
2.5 KiB
Rust
73 lines
2.5 KiB
Rust
// force-host
|
|
// no-prefer-dynamic
|
|
// compile-flags: --crate-type proc-macro --document-private-items
|
|
|
|
#![crate_type="proc-macro"]
|
|
#![crate_name="some_macros"]
|
|
|
|
// @has some_macros/index.html
|
|
// @has - '//a/[@href="attr.some_proc_attr.html"]' 'some_proc_attr'
|
|
|
|
//! include a link to [some_proc_macro] to make sure it works.
|
|
|
|
extern crate proc_macro;
|
|
|
|
use proc_macro::TokenStream;
|
|
|
|
// @has some_macros/index.html
|
|
// @has - '//h2' 'Macros'
|
|
// @has - '//h2' 'Attribute Macros'
|
|
// @has - '//h2' 'Derive Macros'
|
|
// @!has - '//h2' 'Functions'
|
|
|
|
// @has some_macros/all.html
|
|
// @has - '//a[@href="macro.some_proc_macro.html"]' 'some_proc_macro'
|
|
// @has - '//a[@href="attr.some_proc_attr.html"]' 'some_proc_attr'
|
|
// @has - '//a[@href="derive.SomeDerive.html"]' 'SomeDerive'
|
|
// @!has - '//a/@href' 'fn.some_proc_macro.html'
|
|
// @!has - '//a/@href' 'fn.some_proc_attr.html'
|
|
// @!has - '//a/@href' 'fn.some_derive.html'
|
|
|
|
// @has some_macros/index.html '//a/@href' 'macro.some_proc_macro.html'
|
|
// @!has - '//a/@href' 'fn.some_proc_macro.html'
|
|
// @has some_macros/macro.some_proc_macro.html
|
|
// @!has some_macros/fn.some_proc_macro.html
|
|
/// a proc-macro that swallows its input and does nothing.
|
|
#[proc_macro]
|
|
pub fn some_proc_macro(_input: TokenStream) -> TokenStream {
|
|
TokenStream::new()
|
|
}
|
|
|
|
// @has some_macros/index.html '//a/@href' 'attr.some_proc_attr.html'
|
|
// @!has - '//a/@href' 'fn.some_proc_attr.html'
|
|
// @has some_macros/attr.some_proc_attr.html
|
|
// @!has some_macros/fn.some_proc_attr.html
|
|
/// a proc-macro attribute that passes its item through verbatim.
|
|
#[proc_macro_attribute]
|
|
pub fn some_proc_attr(_attr: TokenStream, item: TokenStream) -> TokenStream {
|
|
item
|
|
}
|
|
|
|
// @has some_macros/index.html '//a/@href' 'derive.SomeDerive.html'
|
|
// @!has - '//a/@href' 'fn.some_derive.html'
|
|
// @has some_macros/derive.SomeDerive.html
|
|
// @!has some_macros/fn.some_derive.html
|
|
/// a derive attribute that adds nothing to its input.
|
|
#[proc_macro_derive(SomeDerive)]
|
|
pub fn some_derive(_item: TokenStream) -> TokenStream {
|
|
TokenStream::new()
|
|
}
|
|
|
|
// @has some_macros/foo/index.html
|
|
mod foo {
|
|
// @has - '//code' 'pub use some_proc_macro;'
|
|
// @has - '//a/@href' '../../some_macros/macro.some_proc_macro.html'
|
|
pub use some_proc_macro;
|
|
// @has - '//code' 'pub use some_proc_attr;'
|
|
// @has - '//a/@href' '../../some_macros/attr.some_proc_attr.html'
|
|
pub use some_proc_attr;
|
|
// @has - '//code' 'pub use some_derive;'
|
|
// @has - '//a/@href' '../../some_macros/derive.SomeDerive.html'
|
|
pub use some_derive;
|
|
}
|