You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
should produce a doc webpage with all modules and functions being documented (except those explicitly marked doc(hidden)).
It does not do this. Instead only the contents of public modules are displayed.
For example the rust code below:
pubuse aaa::exp;/// The abc modpubmod abc {/// This is publicpubfndef(){}/// This is notfnhij(){}}/// This should be seen with --no-defaultsmod aaa {/// So should thisfnkkk(){}/// And thispubfnlll(){}/// This is exportedpubfnexp(){}}
With the default rustdoc arguments (rustdoc lib.rs) we get this page. We would expect that running the command rustdoc --no-defaults --passes unindent-comments --passes collapse-docs --passes strip-hidden lib.rs would produce a webpage where all items are shown, instead it produces this page. Note the absence of an aaa module in the page. Also note that abc::hij is shown. Finally note that although abc::hij is (correctly) included in the index nothing within the aaa module is.
(Links may take a little bit to start working, they are github pages)
This seems to be because the html renderer is the one that is actually culling private modules from the page.
Just a note. I tried to fix this before posting this issue, my (not working) CL is at #18822. After spending the better part of a week on it (and making a working fix that was rejected for being hacky) and getting almost nowhere, I do not really have much of an idea of what to do (and also not the time to do it).
According to
rustdoc
's help text and man page an invocation such asshould produce a doc webpage with all modules and functions being documented (except those explicitly marked
doc(hidden)
).It does not do this. Instead only the contents of public modules are displayed.
For example the rust code below:
With the default
rustdoc
arguments (rustdoc lib.rs
) we get this page. We would expect that running the commandrustdoc --no-defaults --passes unindent-comments --passes collapse-docs --passes strip-hidden lib.rs
would produce a webpage where all items are shown, instead it produces this page. Note the absence of anaaa
module in the page. Also note thatabc::hij
is shown. Finally note that althoughabc::hij
is (correctly) included in the index nothing within theaaa
module is.(Links may take a little bit to start working, they are github pages)
This seems to be because the html renderer is the one that is actually culling private modules from the page.
This is likely related to #19106
The text was updated successfully, but these errors were encountered: