rustdoc: Make strip_hidden use a dedicated hidden item if any.

fixes #13806.

src/librustdoc/clean.rs

@@ -152,6 +152,21 @@ impl Item {
         return None;
     }
 
+    pub fn is_hidden_from_doc(&self) -> bool {
+        match self.doc_list() {
+            Some(ref l) => {
+                for innerattr in l.iter() {
+                    match *innerattr {
+                        Word(ref s) if "hidden" == *s => return true,
+                        _ => (),
+                    }
+                }
+            },
+            None => ()
+        }
+        return false;
+    }
+
     pub fn is_mod(&self) -> bool {
         match self.inner { ModuleItem(..) => true, _ => false }
     }
@@ -736,7 +751,7 @@ impl Clean<Type> for ast::Ty {
 
 #[deriving(Clone, Encodable, Decodable)]
 pub enum StructField {
-    HiddenStructField,
+    HiddenStructField, // inserted later by strip passes
     TypedStructField(Type),
 }
 

src/librustdoc/passes.rs

@@ -33,23 +33,24 @@ pub fn strip_hidden(krate: clean::Crate) -> plugins::PluginResult {
         };
         impl<'a> fold::DocFolder for Stripper<'a> {
             fn fold_item(&mut self, i: Item) -> Option<Item> {
-                for attr in i.attrs.iter() {
+                if i.is_hidden_from_doc() {
-                    match attr {
+                    debug!("found one in strip_hidden; removing");
-                        &clean::List(ref x, ref l) if "doc" == *x => {
+                    self.stripped.insert(i.id);
-                            for innerattr in l.iter() {
+
-                                match innerattr {
+                    // use a dedicated hidden item for given item type if any
-                                    &clean::Word(ref s) if "hidden" == *s => {
+                    match i.inner {
-                                        debug!("found one in strip_hidden; removing");
+                        clean::StructFieldItem(..) => {
-                                        self.stripped.insert(i.id);
+                            return Some(clean::Item {
-                                        return None;
+                                inner: clean::StructFieldItem(clean::HiddenStructField),
-                                    },
+                                ..i
-                                    _ => (),
+                            });
-                                }
+                        }
-                            }
+                        _ => {
-                        },
+                            return None;
-                        _ => ()
+                        }
                     }
                 }
+
                 self.fold_item_recur(i)
             }
         }