Merge pull request #1511 from dtolnay/notdoc

Add `cfg(not(doc))` to `doc(hidden)` functions
dtolnay · Sep 15, 2023 · 858e578 · 858e578
2 parents 04c9972 + 1b0d7f8
commit 858e578
Show file tree

Hide file tree

Showing 3 changed files with 5 additions and 0 deletions.
diff --git a/src/ident.rs b/src/ident.rs
@@ -4,6 +4,7 @@ use crate::lookahead;
 pub use proc_macro2::Ident;
 
 #[cfg(feature = "parsing")]
+#[cfg(not(doc))] // Rustdoc bug: does not respect the doc(hidden)
 #[doc(hidden)]
 #[allow(non_snake_case)]
 pub fn Ident(marker: lookahead::TokenMarker) -> Ident {

diff --git a/src/lifetime.rs b/src/lifetime.rs
@@ -113,6 +113,7 @@ impl Hash for Lifetime {
 }
 
 #[cfg(feature = "parsing")]
+#[cfg(not(doc))] // Rustdoc bug: does not respect the doc(hidden)
 #[doc(hidden)]
 #[allow(non_snake_case)]
 pub fn Lifetime(marker: lookahead::TokenMarker) -> Lifetime {

diff --git a/src/lit.rs b/src/lit.rs
@@ -758,6 +758,7 @@ macro_rules! lit_extra_traits {
         }
 
         #[cfg(feature = "parsing")]
+        #[cfg(not(doc))] // Rustdoc bug: does not respect the doc(hidden)
         #[doc(hidden)]
         #[allow(non_snake_case)]
         pub fn $ty(marker: lookahead::TokenMarker) -> $ty {
@@ -774,6 +775,7 @@ lit_extra_traits!(LitInt);
 lit_extra_traits!(LitFloat);
 
 #[cfg(feature = "parsing")]
+#[cfg(not(doc))] // Rustdoc bug: does not respect the doc(hidden)
 #[doc(hidden)]
 #[allow(non_snake_case)]
 pub fn LitBool(marker: lookahead::TokenMarker) -> LitBool {
@@ -794,6 +796,7 @@ ast_enum! {
 }
 
 #[cfg(feature = "parsing")]
+#[cfg(not(doc))] // Rustdoc bug: does not respect the doc(hidden)
 #[doc(hidden)]
 #[allow(non_snake_case)]
 pub fn Lit(marker: lookahead::TokenMarker) -> Lit {