mirror of
https://github.com/rust-lang/rust.git
synced 2024-11-30 10:45:18 +00:00
Rollup merge of #93721 - jyn514:less-macro-special-casing, r=petrochenkov
rustdoc: Special-case macro lookups less Previously, rustdoc had 3 fallbacks it used: 1. `resolve_macro_path` 2. `all_macros` 3. `resolve_str_path_error` Ideally, it would only use `resolve_str_path_error`, to be consistent with other namespaces. Unfortunately, that doesn't consider macros that aren't defined at module scope; consider for instance ```rust { struct S; macro_rules! mac { () => {} } // `mac`'s scope starts here /// `mac` <- `resolve_str_path_error` won't see this struct Z; //`mac`'s scope ends here } ``` This changes it to only use `all_macros` and `resolve_str_path_error`, and gives `resolve_str_path_error` precedence over `all_macros` in case there are two macros with the same name in the same module. This is a smaller version of https://github.com/rust-lang/rust/pull/91427. r? `@petrochenkov`
This commit is contained in:
commit
1f90f4fb85
@ -2,10 +2,8 @@
|
|||||||
//!
|
//!
|
||||||
//! [RFC 1946]: https://github.com/rust-lang/rfcs/blob/master/text/1946-intra-rustdoc-links.md
|
//! [RFC 1946]: https://github.com/rust-lang/rfcs/blob/master/text/1946-intra-rustdoc-links.md
|
||||||
|
|
||||||
use rustc_ast as ast;
|
|
||||||
use rustc_data_structures::{fx::FxHashMap, stable_set::FxHashSet};
|
use rustc_data_structures::{fx::FxHashMap, stable_set::FxHashSet};
|
||||||
use rustc_errors::{Applicability, DiagnosticBuilder};
|
use rustc_errors::{Applicability, DiagnosticBuilder};
|
||||||
use rustc_expand::base::SyntaxExtensionKind;
|
|
||||||
use rustc_hir::def::{
|
use rustc_hir::def::{
|
||||||
DefKind,
|
DefKind,
|
||||||
Namespace::{self, *},
|
Namespace::{self, *},
|
||||||
@ -14,7 +12,6 @@ use rustc_hir::def::{
|
|||||||
use rustc_hir::def_id::{CrateNum, DefId, CRATE_DEF_ID};
|
use rustc_hir::def_id::{CrateNum, DefId, CRATE_DEF_ID};
|
||||||
use rustc_middle::ty::{DefIdTree, Ty, TyCtxt};
|
use rustc_middle::ty::{DefIdTree, Ty, TyCtxt};
|
||||||
use rustc_middle::{bug, span_bug, ty};
|
use rustc_middle::{bug, span_bug, ty};
|
||||||
use rustc_resolve::ParentScope;
|
|
||||||
use rustc_session::lint::Lint;
|
use rustc_session::lint::Lint;
|
||||||
use rustc_span::hygiene::MacroKind;
|
use rustc_span::hygiene::MacroKind;
|
||||||
use rustc_span::symbol::{sym, Ident, Symbol};
|
use rustc_span::symbol::{sym, Ident, Symbol};
|
||||||
@ -486,23 +483,9 @@ impl<'a, 'tcx> LinkCollector<'a, 'tcx> {
|
|||||||
path_str: &'a str,
|
path_str: &'a str,
|
||||||
module_id: DefId,
|
module_id: DefId,
|
||||||
) -> Result<Res, ResolutionFailure<'a>> {
|
) -> Result<Res, ResolutionFailure<'a>> {
|
||||||
let path = ast::Path::from_ident(Ident::from_str(path_str));
|
|
||||||
self.cx.enter_resolver(|resolver| {
|
self.cx.enter_resolver(|resolver| {
|
||||||
// FIXME(jynelson): does this really need 3 separate lookups?
|
// NOTE: this needs 2 separate lookups because `resolve_str_path_error` doesn't take
|
||||||
if let Ok((Some(ext), res)) = resolver.resolve_macro_path(
|
// lexical scope into account (it ignores all macros not defined at the mod-level)
|
||||||
&path,
|
|
||||||
None,
|
|
||||||
&ParentScope::module(resolver.graph_root(), resolver),
|
|
||||||
false,
|
|
||||||
false,
|
|
||||||
) {
|
|
||||||
if let SyntaxExtensionKind::LegacyBang { .. } = ext.kind {
|
|
||||||
return Ok(res.try_into().unwrap());
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if let Some(&res) = resolver.all_macros().get(&Symbol::intern(path_str)) {
|
|
||||||
return Ok(res.try_into().unwrap());
|
|
||||||
}
|
|
||||||
debug!("resolving {} as a macro in the module {:?}", path_str, module_id);
|
debug!("resolving {} as a macro in the module {:?}", path_str, module_id);
|
||||||
if let Ok((_, res)) =
|
if let Ok((_, res)) =
|
||||||
resolver.resolve_str_path_error(DUMMY_SP, path_str, MacroNS, module_id)
|
resolver.resolve_str_path_error(DUMMY_SP, path_str, MacroNS, module_id)
|
||||||
@ -512,6 +495,9 @@ impl<'a, 'tcx> LinkCollector<'a, 'tcx> {
|
|||||||
return Ok(res);
|
return Ok(res);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
if let Some(&res) = resolver.all_macros().get(&Symbol::intern(path_str)) {
|
||||||
|
return Ok(res.try_into().unwrap());
|
||||||
|
}
|
||||||
Err(ResolutionFailure::NotResolved {
|
Err(ResolutionFailure::NotResolved {
|
||||||
module_id,
|
module_id,
|
||||||
partial_res: None,
|
partial_res: None,
|
||||||
|
9
src/test/rustdoc-ui/intra-doc/macro-rules.rs
Normal file
9
src/test/rustdoc-ui/intra-doc/macro-rules.rs
Normal file
@ -0,0 +1,9 @@
|
|||||||
|
// check-pass
|
||||||
|
#![allow(rustdoc::private_intra_doc_links)]
|
||||||
|
|
||||||
|
macro_rules! foo {
|
||||||
|
() => {};
|
||||||
|
}
|
||||||
|
|
||||||
|
/// [foo!]
|
||||||
|
pub fn baz() {}
|
Loading…
Reference in New Issue
Block a user