Allow deeply nested modules to be collapsed to a single page in rustdoc #5952
Comments
|
From looking at the docs, it seems as though all the "nesting" modules contain nothing but other modules. Perhaps rather than an attribute we could simply have a rule that if a module's only exported items are other modules, we simply flatten it into a single page with its submodules. |
|
Visiting for bug triage, email 2013-07-29. @cmr: Can this be subsumed under rustdoc_ng? (Also, is there a metabug for rustdoc_ng?) |
|
@pcwalton would a tree browser as in #1960 (comment) be suitable for closing this? |
|
@cmr Any thoughts? |
|
I agree that this should be done. The best method would probably be a tree browser, ala http://docs.sencha.com/extjs/4.2.1/#!/api. Since rustdoc now handles reexports and links things properly (ex the libc doc page), I don't think this as important as it was with the old rustdoc. |
|
I believe that this bug is describe the quite ancient old rustdoc at this point, not the rustdoc in its current revision. The current rustdoc I don't believe is perfect in its design, but it doesn't suffer from this same problem the old rustdoc did. In lieu of closing old and crufty issues, I'm going to close this and leave room for a more specific bug targeted at today's rustdoc design. |
Added a lint which corrects expressions like (a - b) < f32::EPSILON, according to rust-lang#5819 Fixes rust-lang#5819 changelog: none
Corrects the float_equality_without_abs lint Fixes an issue in the `float_equality_without_abs` lint. The lint suggestion was configured in a way that it lints the whole error and not just the subtraction part. In the current configuration the lint would suggest to change the expression in a wrong way, e.g. ```rust let _ = (a - b) < f32::EPSILON; // before let _ = (a - b).abs(); // after ``` This was dicovered by @flip1995. (See discussion of PR rust-lang#5952). Also the suggestion is now formatted via `utils::sugg`. changelog: none
For deeply nested module structures like those of
core::libc, having to click through all the time is terribly annoying. It would be nice to have an attribute that allows all the modules to be listed on one page.The text was updated successfully, but these errors were encountered: