Auto merge of #84494 - tdelabro:84304-bis, r=jyn514
84304 - rustdoc: shrink Item::Attributes Helps with https://github.com/rust-lang/rust/issues/84304
This commit is contained in:
commit
727d101561
@ -126,6 +126,7 @@ fn generate_for_trait(
|
||||
synthetic: true,
|
||||
blanket_impl: None,
|
||||
}),
|
||||
cfg: None,
|
||||
})
|
||||
}
|
||||
|
||||
|
@ -128,6 +128,7 @@ impl<'a, 'tcx> BlanketImplFinder<'a, 'tcx> {
|
||||
synthetic: false,
|
||||
blanket_impl: Some(trait_ref.self_ty().clean(self.cx)),
|
||||
}),
|
||||
cfg: None,
|
||||
});
|
||||
}
|
||||
}
|
||||
|
@ -1,6 +1,7 @@
|
||||
//! Support for inlining external documentation into the current AST.
|
||||
|
||||
use std::iter::once;
|
||||
use std::sync::Arc;
|
||||
|
||||
use rustc_ast as ast;
|
||||
use rustc_data_structures::fx::FxHashSet;
|
||||
@ -14,7 +15,7 @@
|
||||
use rustc_span::symbol::{kw, sym, Symbol};
|
||||
use rustc_span::Span;
|
||||
|
||||
use crate::clean::{self, Attributes, GetDefId, ToSource};
|
||||
use crate::clean::{self, Attributes, AttributesExt, GetDefId, ToSource};
|
||||
use crate::core::DocContext;
|
||||
use crate::formats::item_type::ItemType;
|
||||
|
||||
@ -119,12 +120,16 @@
|
||||
_ => return None,
|
||||
};
|
||||
|
||||
let target_attrs = load_attrs(cx, did);
|
||||
let attrs = box merge_attrs(cx, Some(parent_module), target_attrs, attrs_clone);
|
||||
|
||||
let (attrs, cfg) = merge_attrs(cx, Some(parent_module), load_attrs(cx, did), attrs_clone);
|
||||
cx.inlined.insert(did);
|
||||
let what_rustc_thinks = clean::Item::from_def_id_and_parts(did, Some(name), kind, cx);
|
||||
ret.push(clean::Item { attrs, ..what_rustc_thinks });
|
||||
ret.push(clean::Item::from_def_id_and_attrs_and_parts(
|
||||
did,
|
||||
Some(name),
|
||||
kind,
|
||||
box attrs,
|
||||
cx,
|
||||
cfg,
|
||||
));
|
||||
Some(ret)
|
||||
}
|
||||
|
||||
@ -288,22 +293,24 @@ fn merge_attrs(
|
||||
parent_module: Option<DefId>,
|
||||
old_attrs: Attrs<'_>,
|
||||
new_attrs: Option<Attrs<'_>>,
|
||||
) -> clean::Attributes {
|
||||
) -> (clean::Attributes, Option<Arc<clean::cfg::Cfg>>) {
|
||||
// NOTE: If we have additional attributes (from a re-export),
|
||||
// always insert them first. This ensure that re-export
|
||||
// doc comments show up before the original doc comments
|
||||
// when we render them.
|
||||
if let Some(inner) = new_attrs {
|
||||
if let Some(new_id) = parent_module {
|
||||
let diag = cx.sess().diagnostic();
|
||||
Attributes::from_ast(diag, old_attrs, Some((inner, new_id)))
|
||||
} else {
|
||||
let mut both = inner.to_vec();
|
||||
both.extend_from_slice(old_attrs);
|
||||
both.clean(cx)
|
||||
}
|
||||
(
|
||||
if let Some(new_id) = parent_module {
|
||||
Attributes::from_ast(old_attrs, Some((inner, new_id)))
|
||||
} else {
|
||||
old_attrs.clean(cx)
|
||||
Attributes::from_ast(&both, None)
|
||||
},
|
||||
both.cfg(cx.sess().diagnostic()),
|
||||
)
|
||||
} else {
|
||||
(old_attrs.clean(cx), old_attrs.cfg(cx.sess().diagnostic()))
|
||||
}
|
||||
}
|
||||
|
||||
@ -414,8 +421,8 @@ fn merge_attrs(
|
||||
|
||||
debug!("build_impl: impl {:?} for {:?}", trait_.def_id(), for_.def_id());
|
||||
|
||||
let attrs = box merge_attrs(cx, parent_module.into(), load_attrs(cx, did), attrs);
|
||||
debug!("merged_attrs={:?}", attrs);
|
||||
let (merged_attrs, cfg) = merge_attrs(cx, parent_module.into(), load_attrs(cx, did), attrs);
|
||||
debug!("merged_attrs={:?}", merged_attrs);
|
||||
|
||||
ret.push(clean::Item::from_def_id_and_attrs_and_parts(
|
||||
did,
|
||||
@ -432,8 +439,9 @@ fn merge_attrs(
|
||||
synthetic: false,
|
||||
blanket_impl: None,
|
||||
}),
|
||||
attrs,
|
||||
box merged_attrs,
|
||||
cx,
|
||||
cfg,
|
||||
));
|
||||
}
|
||||
|
||||
@ -479,6 +487,7 @@ fn build_module(
|
||||
},
|
||||
true,
|
||||
)),
|
||||
cfg: None,
|
||||
});
|
||||
} else if let Some(i) = try_inline(cx, did, item.res, item.ident.name, None, visited) {
|
||||
items.extend(i)
|
||||
|
@ -84,9 +84,8 @@ fn clean(&self, cx: &mut DocContext<'_>) -> Option<U> {
|
||||
}
|
||||
|
||||
impl Clean<ExternalCrate> for CrateNum {
|
||||
fn clean(&self, cx: &mut DocContext<'_>) -> ExternalCrate {
|
||||
let root = DefId { krate: *self, index: CRATE_DEF_INDEX };
|
||||
ExternalCrate { crate_num: *self, attrs: cx.tcx.get_attrs(root).clean(cx) }
|
||||
fn clean(&self, _cx: &mut DocContext<'_>) -> ExternalCrate {
|
||||
ExternalCrate { crate_num: *self }
|
||||
}
|
||||
}
|
||||
|
||||
@ -123,8 +122,8 @@ fn clean(&self, cx: &mut DocContext<'_>) -> Item {
|
||||
}
|
||||
|
||||
impl Clean<Attributes> for [ast::Attribute] {
|
||||
fn clean(&self, cx: &mut DocContext<'_>) -> Attributes {
|
||||
Attributes::from_ast(cx.sess().diagnostic(), self, None)
|
||||
fn clean(&self, _cx: &mut DocContext<'_>) -> Attributes {
|
||||
Attributes::from_ast(self, None)
|
||||
}
|
||||
}
|
||||
|
||||
@ -850,7 +849,6 @@ fn clean(&self, cx: &mut DocContext<'_>) -> FnDecl {
|
||||
inputs: (self.0.inputs, self.1).clean(cx),
|
||||
output: self.0.output.clean(cx),
|
||||
c_variadic: self.0.c_variadic,
|
||||
attrs: Attributes::default(),
|
||||
}
|
||||
}
|
||||
}
|
||||
@ -862,7 +860,6 @@ fn clean(&self, cx: &mut DocContext<'_>) -> FnDecl {
|
||||
|
||||
FnDecl {
|
||||
output: Return(sig.skip_binder().output().clean(cx)),
|
||||
attrs: Attributes::default(),
|
||||
c_variadic: sig.skip_binder().c_variadic,
|
||||
inputs: Arguments {
|
||||
values: sig
|
||||
@ -2001,6 +1998,7 @@ fn clean_extern_crate(
|
||||
return items;
|
||||
}
|
||||
}
|
||||
|
||||
// FIXME: using `from_def_id_and_kind` breaks `rustdoc/masked` for some reason
|
||||
vec![Item {
|
||||
name: Some(name),
|
||||
@ -2008,6 +2006,7 @@ fn clean_extern_crate(
|
||||
def_id: crate_def_id,
|
||||
visibility: krate.vis.clean(cx),
|
||||
kind: box ExternCrateItem { src: orig_name },
|
||||
cfg: attrs.cfg(cx.sess().diagnostic()),
|
||||
}]
|
||||
}
|
||||
|
||||
|
@ -73,7 +73,6 @@
|
||||
#[derive(Clone, Debug)]
|
||||
crate struct ExternalCrate {
|
||||
crate crate_num: CrateNum,
|
||||
crate attrs: Attributes,
|
||||
}
|
||||
|
||||
impl ExternalCrate {
|
||||
@ -220,11 +219,13 @@ fn def_id(&self) -> DefId {
|
||||
/// E.g., struct vs enum vs function.
|
||||
crate kind: Box<ItemKind>,
|
||||
crate def_id: DefId,
|
||||
|
||||
crate cfg: Option<Arc<Cfg>>,
|
||||
}
|
||||
|
||||
// `Item` is used a lot. Make sure it doesn't unintentionally get bigger.
|
||||
#[cfg(all(target_arch = "x86_64", target_pointer_width = "64"))]
|
||||
rustc_data_structures::static_assert_size!(Item, 40);
|
||||
rustc_data_structures::static_assert_size!(Item, 48);
|
||||
|
||||
impl fmt::Debug for Item {
|
||||
fn fmt(&self, fmt: &mut fmt::Formatter<'_>) -> fmt::Result {
|
||||
@ -236,6 +237,7 @@ fn fmt(&self, fmt: &mut fmt::Formatter<'_>) -> fmt::Result {
|
||||
.field("kind", &self.kind)
|
||||
.field("visibility", &self.visibility)
|
||||
.field("def_id", def_id)
|
||||
.field("cfg", &self.cfg)
|
||||
.finish()
|
||||
}
|
||||
}
|
||||
@ -263,6 +265,10 @@ impl Item {
|
||||
if self.is_fake() { None } else { tcx.lookup_deprecation(self.def_id) }
|
||||
}
|
||||
|
||||
crate fn inner_docs(&self, tcx: TyCtxt<'_>) -> bool {
|
||||
if self.is_fake() { false } else { tcx.get_attrs(self.def_id).inner_docs() }
|
||||
}
|
||||
|
||||
crate fn span(&self, tcx: TyCtxt<'_>) -> Span {
|
||||
let kind = match &*self.kind {
|
||||
ItemKind::StrippedItem(k) => k,
|
||||
@ -306,12 +312,15 @@ pub fn from_def_id_and_parts(
|
||||
kind: ItemKind,
|
||||
cx: &mut DocContext<'_>,
|
||||
) -> Item {
|
||||
let ast_attrs = cx.tcx.get_attrs(def_id);
|
||||
|
||||
Self::from_def_id_and_attrs_and_parts(
|
||||
def_id,
|
||||
name,
|
||||
kind,
|
||||
box cx.tcx.get_attrs(def_id).clean(cx),
|
||||
box ast_attrs.clean(cx),
|
||||
cx,
|
||||
ast_attrs.cfg(cx.sess().diagnostic()),
|
||||
)
|
||||
}
|
||||
|
||||
@ -321,6 +330,7 @@ pub fn from_def_id_and_attrs_and_parts(
|
||||
kind: ItemKind,
|
||||
attrs: Box<Attributes>,
|
||||
cx: &mut DocContext<'_>,
|
||||
cfg: Option<Arc<Cfg>>,
|
||||
) -> Item {
|
||||
debug!("name={:?}, def_id={:?}", name, def_id);
|
||||
|
||||
@ -330,6 +340,7 @@ pub fn from_def_id_and_attrs_and_parts(
|
||||
name,
|
||||
attrs,
|
||||
visibility: cx.tcx.visibility(def_id).clean(cx),
|
||||
cfg,
|
||||
}
|
||||
}
|
||||
|
||||
@ -663,12 +674,72 @@ fn size_hint(&self) -> (usize, Option<usize>) {
|
||||
crate trait AttributesExt {
|
||||
/// Finds an attribute as List and returns the list of attributes nested inside.
|
||||
fn lists(&self, name: Symbol) -> ListAttributesIter<'_>;
|
||||
|
||||
fn span(&self) -> Option<rustc_span::Span>;
|
||||
|
||||
fn inner_docs(&self) -> bool;
|
||||
|
||||
fn other_attrs(&self) -> Vec<ast::Attribute>;
|
||||
|
||||
fn cfg(&self, diagnostic: &::rustc_errors::Handler) -> Option<Arc<Cfg>>;
|
||||
}
|
||||
|
||||
impl AttributesExt for [ast::Attribute] {
|
||||
fn lists(&self, name: Symbol) -> ListAttributesIter<'_> {
|
||||
ListAttributesIter { attrs: self.iter(), current_list: Vec::new().into_iter(), name }
|
||||
}
|
||||
|
||||
/// Return the span of the first doc-comment, if it exists.
|
||||
fn span(&self) -> Option<rustc_span::Span> {
|
||||
self.iter().find(|attr| attr.doc_str().is_some()).map(|attr| attr.span)
|
||||
}
|
||||
|
||||
/// Returns whether the first doc-comment is an inner attribute.
|
||||
///
|
||||
//// If there are no doc-comments, return true.
|
||||
/// FIXME(#78591): Support both inner and outer attributes on the same item.
|
||||
fn inner_docs(&self) -> bool {
|
||||
self.iter().find(|a| a.doc_str().is_some()).map_or(true, |a| a.style == AttrStyle::Inner)
|
||||
}
|
||||
|
||||
fn other_attrs(&self) -> Vec<ast::Attribute> {
|
||||
self.iter().filter(|attr| attr.doc_str().is_none()).cloned().collect()
|
||||
}
|
||||
|
||||
fn cfg(&self, diagnostic: &::rustc_errors::Handler) -> Option<Arc<Cfg>> {
|
||||
let mut cfg = Cfg::True;
|
||||
|
||||
for attr in self.iter() {
|
||||
if attr.doc_str().is_none() && attr.has_name(sym::doc) {
|
||||
if let Some(mi) = attr.meta() {
|
||||
if let Some(cfg_mi) = Attributes::extract_cfg(&mi) {
|
||||
// Extracted #[doc(cfg(...))]
|
||||
match Cfg::parse(cfg_mi) {
|
||||
Ok(new_cfg) => cfg &= new_cfg,
|
||||
Err(e) => diagnostic.span_err(e.span, e.msg),
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
for attr in self.lists(sym::target_feature) {
|
||||
if attr.has_name(sym::enable) {
|
||||
if let Some(feat) = attr.value_str() {
|
||||
let meta = attr::mk_name_value_item_str(
|
||||
Ident::with_dummy_span(sym::target_feature),
|
||||
feat,
|
||||
DUMMY_SP,
|
||||
);
|
||||
if let Ok(feat_cfg) = Cfg::parse(&meta) {
|
||||
cfg &= feat_cfg;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
if cfg == Cfg::True { None } else { Some(Arc::new(cfg)) }
|
||||
}
|
||||
}
|
||||
|
||||
crate trait NestedAttributesExt {
|
||||
@ -777,9 +848,6 @@ fn from_iter<T>(iter: T) -> Self
|
||||
crate struct Attributes {
|
||||
crate doc_strings: Vec<DocFragment>,
|
||||
crate other_attrs: Vec<ast::Attribute>,
|
||||
crate cfg: Option<Arc<Cfg>>,
|
||||
crate span: Option<rustc_span::Span>,
|
||||
crate inner_docs: bool,
|
||||
}
|
||||
|
||||
#[derive(Clone, Debug, Default, PartialEq, Eq, Hash)]
|
||||
@ -811,6 +879,10 @@ pub struct RenderedLink {
|
||||
}
|
||||
|
||||
impl Attributes {
|
||||
crate fn lists(&self, name: Symbol) -> ListAttributesIter<'_> {
|
||||
self.other_attrs.lists(name)
|
||||
}
|
||||
|
||||
/// Extracts the content from an attribute `#[doc(cfg(content))]`.
|
||||
crate fn extract_cfg(mi: &ast::MetaItem) -> Option<&ast::MetaItem> {
|
||||
use rustc_ast::NestedMetaItem::MetaItem;
|
||||
@ -890,13 +962,10 @@ impl Attributes {
|
||||
}
|
||||
|
||||
crate fn from_ast(
|
||||
diagnostic: &::rustc_errors::Handler,
|
||||
attrs: &[ast::Attribute],
|
||||
additional_attrs: Option<(&[ast::Attribute], DefId)>,
|
||||
) -> Attributes {
|
||||
let mut doc_strings: Vec<DocFragment> = vec![];
|
||||
let mut sp = None;
|
||||
let mut cfg = Cfg::True;
|
||||
let mut doc_line = 0;
|
||||
|
||||
fn update_need_backline(doc_strings: &mut Vec<DocFragment>, frag: &DocFragment) {
|
||||
@ -940,21 +1009,11 @@ fn update_need_backline(doc_strings: &mut Vec<DocFragment>, frag: &DocFragment)
|
||||
|
||||
doc_strings.push(frag);
|
||||
|
||||
if sp.is_none() {
|
||||
sp = Some(attr.span);
|
||||
}
|
||||
None
|
||||
} else {
|
||||
if attr.has_name(sym::doc) {
|
||||
if let Some(mi) = attr.meta() {
|
||||
if let Some(cfg_mi) = Attributes::extract_cfg(&mi) {
|
||||
// Extracted #[doc(cfg(...))]
|
||||
match Cfg::parse(cfg_mi) {
|
||||
Ok(new_cfg) => cfg &= new_cfg,
|
||||
Err(e) => diagnostic.span_err(e.span, e.msg),
|
||||
}
|
||||
} else if let Some((filename, contents)) = Attributes::extract_include(&mi)
|
||||
{
|
||||
if let Some((filename, contents)) = Attributes::extract_include(&mi) {
|
||||
let line = doc_line;
|
||||
doc_line += contents.as_str().lines().count();
|
||||
let frag = DocFragment {
|
||||
@ -984,35 +1043,7 @@ fn update_need_backline(doc_strings: &mut Vec<DocFragment>, frag: &DocFragment)
|
||||
.filter_map(clean_attr)
|
||||
.collect();
|
||||
|
||||
// treat #[target_feature(enable = "feat")] attributes as if they were
|
||||
// #[doc(cfg(target_feature = "feat"))] attributes as well
|
||||
for attr in attrs.lists(sym::target_feature) {
|
||||
if attr.has_name(sym::enable) {
|
||||
if let Some(feat) = attr.value_str() {
|
||||
let meta = attr::mk_name_value_item_str(
|
||||
Ident::with_dummy_span(sym::target_feature),
|
||||
feat,
|
||||
DUMMY_SP,
|
||||
);
|
||||
if let Ok(feat_cfg) = Cfg::parse(&meta) {
|
||||
cfg &= feat_cfg;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
let inner_docs = attrs
|
||||
.iter()
|
||||
.find(|a| a.doc_str().is_some())
|
||||
.map_or(true, |a| a.style == AttrStyle::Inner);
|
||||
|
||||
Attributes {
|
||||
doc_strings,
|
||||
other_attrs,
|
||||
cfg: if cfg == Cfg::True { None } else { Some(Arc::new(cfg)) },
|
||||
span: sp,
|
||||
inner_docs,
|
||||
}
|
||||
Attributes { doc_strings, other_attrs }
|
||||
}
|
||||
|
||||
/// Finds the `doc` attribute as a NameValue and returns the corresponding
|
||||
@ -1078,8 +1109,6 @@ fn update_need_backline(doc_strings: &mut Vec<DocFragment>, frag: &DocFragment)
|
||||
impl PartialEq for Attributes {
|
||||
fn eq(&self, rhs: &Self) -> bool {
|
||||
self.doc_strings == rhs.doc_strings
|
||||
&& self.cfg == rhs.cfg
|
||||
&& self.span == rhs.span
|
||||
&& self
|
||||
.other_attrs
|
||||
.iter()
|
||||
@ -1093,20 +1122,12 @@ impl Eq for Attributes {}
|
||||
impl Hash for Attributes {
|
||||
fn hash<H: Hasher>(&self, hasher: &mut H) {
|
||||
self.doc_strings.hash(hasher);
|
||||
self.cfg.hash(hasher);
|
||||
self.span.hash(hasher);
|
||||
for attr in &self.other_attrs {
|
||||
attr.id.hash(hasher);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
impl AttributesExt for Attributes {
|
||||
fn lists(&self, name: Symbol) -> ListAttributesIter<'_> {
|
||||
self.other_attrs.lists(name)
|
||||
}
|
||||
}
|
||||
|
||||
#[derive(Clone, PartialEq, Eq, Debug, Hash)]
|
||||
crate enum GenericBound {
|
||||
TraitBound(PolyTrait, hir::TraitBoundModifier),
|
||||
@ -1269,7 +1290,6 @@ impl GenericParamDef {
|
||||
crate inputs: Arguments,
|
||||
crate output: FnRetTy,
|
||||
crate c_variadic: bool,
|
||||
crate attrs: Attributes,
|
||||
}
|
||||
|
||||
impl FnDecl {
|
||||
|
@ -32,7 +32,7 @@
|
||||
|
||||
use crate::clean;
|
||||
use crate::clean::inline::build_external_trait;
|
||||
use crate::clean::{AttributesExt, TraitWithExtraInfo, MAX_DEF_IDX};
|
||||
use crate::clean::{TraitWithExtraInfo, MAX_DEF_IDX};
|
||||
use crate::config::{Options as RustdocOptions, OutputFormat, RenderOptions};
|
||||
use crate::formats::cache::Cache;
|
||||
use crate::passes::{self, Condition::*, ConditionalPass};
|
||||
|
@ -26,7 +26,7 @@
|
||||
use std::sync::atomic::{AtomicUsize, Ordering};
|
||||
use std::sync::{Arc, Mutex};
|
||||
|
||||
use crate::clean::Attributes;
|
||||
use crate::clean::{types::AttributesExt, Attributes};
|
||||
use crate::config::Options;
|
||||
use crate::html::markdown::{self, ErrorCodes, Ignore, LangString};
|
||||
use crate::lint::init_lints;
|
||||
@ -1092,9 +1092,10 @@ fn visit_testable<F: FnOnce(&mut Self)>(
|
||||
sp: Span,
|
||||
nested: F,
|
||||
) {
|
||||
let attrs = self.tcx.hir().attrs(hir_id);
|
||||
let mut attrs = Attributes::from_ast(self.sess.diagnostic(), attrs, None);
|
||||
if let Some(ref cfg) = attrs.cfg {
|
||||
let ast_attrs = self.tcx.hir().attrs(hir_id);
|
||||
let mut attrs = Attributes::from_ast(ast_attrs, None);
|
||||
|
||||
if let Some(ref cfg) = ast_attrs.cfg(self.sess.diagnostic()) {
|
||||
if !cfg.matches(&self.sess.parse_sess, Some(&self.sess.features_untracked())) {
|
||||
return;
|
||||
}
|
||||
@ -1110,8 +1111,8 @@ fn visit_testable<F: FnOnce(&mut Self)>(
|
||||
// anything else, this will combine them for us.
|
||||
if let Some(doc) = attrs.collapsed_doc_value() {
|
||||
// Use the outermost invocation, so that doctest names come from where the docs were written.
|
||||
let span = attrs
|
||||
.span
|
||||
let span = ast_attrs
|
||||
.span()
|
||||
.map(|span| span.ctxt().outer_expn().expansion_cause().unwrap_or(span))
|
||||
.unwrap_or(DUMMY_SP);
|
||||
self.collector.set_position(span);
|
||||
|
@ -164,10 +164,12 @@ impl Cache {
|
||||
};
|
||||
let name = e.name(tcx);
|
||||
let extern_url = extern_html_root_urls.get(&*name.as_str()).map(|u| &**u);
|
||||
self.extern_locations
|
||||
.insert(n, (name, src_root, extern_location(e, extern_url, &dst, tcx)));
|
||||
|
||||
let did = DefId { krate: n, index: CRATE_DEF_INDEX };
|
||||
self.extern_locations.insert(
|
||||
n,
|
||||
(name, src_root, extern_location(e, extern_url, tcx.get_attrs(did), &dst, tcx)),
|
||||
);
|
||||
|
||||
self.external_paths.insert(did, (vec![name.to_string()], ItemType::Module));
|
||||
}
|
||||
|
||||
|
@ -1,15 +1,16 @@
|
||||
use std::collections::BTreeMap;
|
||||
use std::path::Path;
|
||||
|
||||
use rustc_ast::ast;
|
||||
use rustc_data_structures::fx::{FxHashMap, FxHashSet};
|
||||
use rustc_middle::ty::TyCtxt;
|
||||
use rustc_span::symbol::{sym, Symbol};
|
||||
use serde::ser::{Serialize, SerializeStruct, Serializer};
|
||||
|
||||
use crate::clean;
|
||||
use crate::clean::types::{
|
||||
FnDecl, FnRetTy, GenericBound, Generics, GetDefId, Type, WherePredicate,
|
||||
AttributesExt, FnDecl, FnRetTy, GenericBound, Generics, GetDefId, Type, WherePredicate,
|
||||
};
|
||||
use crate::clean::{self, AttributesExt};
|
||||
use crate::formats::cache::Cache;
|
||||
use crate::formats::item_type::ItemType;
|
||||
use crate::html::markdown::short_markdown_summary;
|
||||
@ -30,6 +31,7 @@
|
||||
crate fn extern_location(
|
||||
e: &clean::ExternalCrate,
|
||||
extern_url: Option<&str>,
|
||||
ast_attrs: &[ast::Attribute],
|
||||
dst: &Path,
|
||||
tcx: TyCtxt<'_>,
|
||||
) -> ExternalLocation {
|
||||
@ -50,7 +52,7 @@
|
||||
|
||||
// Failing that, see if there's an attribute specifying where to find this
|
||||
// external crate
|
||||
e.attrs
|
||||
ast_attrs
|
||||
.lists(sym::doc)
|
||||
.filter(|a| a.has_name(sym::html_root_url))
|
||||
.filter_map(|a| a.value_str())
|
||||
|
@ -18,7 +18,7 @@
|
||||
use super::write_shared::write_shared;
|
||||
use super::{print_sidebar, settings, AllTypes, NameDoc, StylePath, BASIC_KEYWORDS};
|
||||
|
||||
use crate::clean::{self, AttributesExt};
|
||||
use crate::clean;
|
||||
use crate::config::RenderOptions;
|
||||
use crate::docfs::{DocFS, PathError};
|
||||
use crate::error::Error;
|
||||
|
@ -608,17 +608,12 @@ fn document_item_info(
|
||||
}
|
||||
|
||||
fn portability(item: &clean::Item, parent: Option<&clean::Item>) -> Option<String> {
|
||||
let cfg = match (&item.attrs.cfg, parent.and_then(|p| p.attrs.cfg.as_ref())) {
|
||||
let cfg = match (&item.cfg, parent.and_then(|p| p.cfg.as_ref())) {
|
||||
(Some(cfg), Some(parent_cfg)) => cfg.simplify_with(parent_cfg),
|
||||
(cfg, _) => cfg.as_deref().cloned(),
|
||||
};
|
||||
|
||||
debug!(
|
||||
"Portability {:?} - {:?} = {:?}",
|
||||
item.attrs.cfg,
|
||||
parent.and_then(|p| p.attrs.cfg.as_ref()),
|
||||
cfg
|
||||
);
|
||||
debug!("Portability {:?} - {:?} = {:?}", item.cfg, parent.and_then(|p| p.cfg.as_ref()), cfg);
|
||||
|
||||
Some(format!("<div class=\"stab portability\">{}</div>", cfg?.render_long_html()))
|
||||
}
|
||||
|
@ -1,10 +1,11 @@
|
||||
use clean::AttributesExt;
|
||||
|
||||
use std::cmp::Ordering;
|
||||
|
||||
use rustc_data_structures::fx::FxHashMap;
|
||||
use rustc_hir as hir;
|
||||
use rustc_hir::def::CtorKind;
|
||||
use rustc_hir::def_id::DefId;
|
||||
use rustc_middle::dep_graph::DepContext;
|
||||
use rustc_middle::middle::stability;
|
||||
use rustc_middle::ty::TyCtxt;
|
||||
use rustc_span::hygiene::MacroKind;
|
||||
@ -284,16 +285,14 @@ fn cmp(
|
||||
|
||||
clean::ImportItem(ref import) => {
|
||||
let (stab, stab_tags) = if let Some(import_def_id) = import.source.did {
|
||||
let import_attrs = Box::new(clean::Attributes::from_ast(
|
||||
cx.tcx().sess().diagnostic(),
|
||||
cx.tcx().get_attrs(import_def_id),
|
||||
None,
|
||||
));
|
||||
let ast_attrs = cx.tcx().get_attrs(import_def_id);
|
||||
let import_attrs = Box::new(clean::Attributes::from_ast(ast_attrs, None));
|
||||
|
||||
// Just need an item with the correct def_id and attrs
|
||||
let import_item = clean::Item {
|
||||
def_id: import_def_id,
|
||||
attrs: import_attrs,
|
||||
cfg: ast_attrs.cfg(cx.tcx().sess.diagnostic()),
|
||||
..myitem.clone()
|
||||
};
|
||||
|
||||
@ -400,12 +399,12 @@ fn tag_html(class: &str, title: &str, contents: &str) -> String {
|
||||
tags += &tag_html("unstable", "", "Experimental");
|
||||
}
|
||||
|
||||
let cfg = match (&item.attrs.cfg, parent.attrs.cfg.as_ref()) {
|
||||
let cfg = match (&item.cfg, parent.cfg.as_ref()) {
|
||||
(Some(cfg), Some(parent_cfg)) => cfg.simplify_with(parent_cfg),
|
||||
(cfg, _) => cfg.as_deref().cloned(),
|
||||
};
|
||||
|
||||
debug!("Portability {:?} - {:?} = {:?}", item.attrs.cfg, parent.attrs.cfg, cfg);
|
||||
debug!("Portability {:?} - {:?} = {:?}", item.cfg, parent.cfg, cfg);
|
||||
if let Some(ref cfg) = cfg {
|
||||
tags += &tag_html("portability", &cfg.render_long_plain(), &cfg.render_short_html());
|
||||
}
|
||||
|
@ -41,7 +41,7 @@ pub(super) fn convert_item(&self, item: clean::Item) -> Option<Item> {
|
||||
.map(rustc_ast_pretty::pprust::attribute_to_string)
|
||||
.collect();
|
||||
let span = item.span(self.tcx);
|
||||
let clean::Item { name, attrs: _, kind: _, visibility, def_id } = item;
|
||||
let clean::Item { name, attrs: _, kind: _, visibility, def_id, cfg: _ } = item;
|
||||
let inner = match *item.kind {
|
||||
clean::StrippedItem(_) => return None,
|
||||
_ => from_clean_item(item, self.tcx),
|
||||
@ -421,7 +421,7 @@ fn from_tcx(bare_decl: clean::BareFunctionDecl, tcx: TyCtxt<'_>) -> Self {
|
||||
|
||||
impl FromWithTcx<clean::FnDecl> for FnDecl {
|
||||
fn from_tcx(decl: clean::FnDecl, tcx: TyCtxt<'_>) -> Self {
|
||||
let clean::FnDecl { inputs, output, c_variadic, attrs: _ } = decl;
|
||||
let clean::FnDecl { inputs, output, c_variadic } = decl;
|
||||
FnDecl {
|
||||
inputs: inputs
|
||||
.values
|
||||
|
@ -853,7 +853,9 @@ fn fold_item(&mut self, item: Item) -> Option<Item> {
|
||||
}
|
||||
});
|
||||
|
||||
if item.is_mod() && item.attrs.inner_docs {
|
||||
let inner_docs = item.inner_docs(self.cx.tcx);
|
||||
|
||||
if item.is_mod() && inner_docs {
|
||||
self.mod_ids.push(item.def_id);
|
||||
}
|
||||
|
||||
@ -880,7 +882,7 @@ fn fold_item(&mut self, item: Item) -> Option<Item> {
|
||||
}
|
||||
|
||||
Some(if item.is_mod() {
|
||||
if !item.attrs.inner_docs {
|
||||
if !inner_docs {
|
||||
self.mod_ids.push(item.def_id);
|
||||
}
|
||||
|
||||
@ -1050,6 +1052,8 @@ fn resolve_link(
|
||||
};
|
||||
let mut path_str = &*path_str;
|
||||
|
||||
let inner_docs = item.inner_docs(self.cx.tcx);
|
||||
|
||||
// In order to correctly resolve intra-doc links we need to
|
||||
// pick a base AST node to work from. If the documentation for
|
||||
// this module came from an inner comment (//!) then we anchor
|
||||
@ -1061,11 +1065,8 @@ fn resolve_link(
|
||||
// we've already pushed this node onto the resolution stack but
|
||||
// for outer comments we explicitly try and resolve against the
|
||||
// parent_node first.
|
||||
let base_node = if item.is_mod() && item.attrs.inner_docs {
|
||||
self.mod_ids.last().copied()
|
||||
} else {
|
||||
parent_node
|
||||
};
|
||||
let base_node =
|
||||
if item.is_mod() && inner_docs { self.mod_ids.last().copied() } else { parent_node };
|
||||
|
||||
let mut module_id = if let Some(id) = base_node {
|
||||
id
|
||||
|
@ -24,7 +24,7 @@ impl DocFolder for CfgPropagator {
|
||||
fn fold_item(&mut self, mut item: Item) -> Option<Item> {
|
||||
let old_parent_cfg = self.parent_cfg.clone();
|
||||
|
||||
let new_cfg = match (self.parent_cfg.take(), item.attrs.cfg.take()) {
|
||||
let new_cfg = match (self.parent_cfg.take(), item.cfg.take()) {
|
||||
(None, None) => None,
|
||||
(Some(rc), None) | (None, Some(rc)) => Some(rc),
|
||||
(Some(mut a), Some(b)) => {
|
||||
@ -34,7 +34,7 @@ fn fold_item(&mut self, mut item: Item) -> Option<Item> {
|
||||
}
|
||||
};
|
||||
self.parent_cfg = new_cfg.clone();
|
||||
item.attrs.cfg = new_cfg;
|
||||
item.cfg = new_cfg;
|
||||
|
||||
let result = self.fold_item_recur(item);
|
||||
self.parent_cfg = old_parent_cfg;
|
||||
|
@ -2,8 +2,8 @@
|
||||
use rustc_span::symbol::sym;
|
||||
use std::mem;
|
||||
|
||||
use crate::clean::Item;
|
||||
use crate::clean::{self, AttributesExt, NestedAttributesExt};
|
||||
use crate::clean;
|
||||
use crate::clean::{Item, NestedAttributesExt};
|
||||
use crate::core::DocContext;
|
||||
use crate::fold::{DocFolder, StripItem};
|
||||
use crate::passes::{ImplStripper, Pass};
|
||||
|
Loading…
Reference in New Issue
Block a user