rustdoc book: acknowlage --document-hidden-items

Author: lolbinarycat

src/doc/rustdoc/src/command-line-arguments.md

@@ -100,7 +100,16 @@ mod private { // this item is private and will not be documented
 }
 ```
 
-`--document-private-items` documents all items, even if they're not public.
+`--document-private-items` causes all items to be documented as if they were `pub`.
+
+## `--document-hidden-items`: Show items that are `#[doc(hidden)]`
+
+By default, `rustdoc` does not document items that are annotated with
+[`#[doc(hidden)]`](write-documentation/the-doc-attribute.html#hidden).
+
+`--document-hidden-items` causes all items to be documented as if they did not have `#[doc(hidden)]`.
+
+items that are hidden and private will only be documented if both `--document-hidden-items` *and* `--document-private-items` are specified.
 
 ## `-L`/`--library-path`: where to look for dependencies
 

src/doc/rustdoc/src/write-documentation/the-doc-attribute.md

@@ -230,9 +230,10 @@ If you want to know more about inlining rules, take a look at the
 
 <span id="dochidden"></span>
 
-Any item annotated with `#[doc(hidden)]` will not appear in the documentation, unless
-the `strip-hidden` pass is removed. Re-exported items where one of its ancestors has
-`#[doc(hidden)]` will be considered the same as private.
+Any item annotated with `#[doc(hidden)]` will not appear in the documentation,
+unless the `--document-hidden-items` flag is used.
+Re-exported items where one of its ancestors has
+`#[doc(hidden)]` will be considered hidden.
 
 You can find more information in the [`re-exports` chapter](./re-exports.md).