Bug 11892 – Ddoc should organize a module by symbol category

Status
NEW
Severity
enhancement
Priority
P4
Component
dmd
Product
D
Version
D2
Platform
All
OS
All
Creation time
2014-01-10T01:44:18Z
Last change time
2024-12-13T18:15:49Z
Keywords
ddoc
Assigned to
No Owner
Creator
Jacob Carlborg
Moved to GitHub: dmd#18752 →

Comments

Comment #0 by doob — 2014-01-10T01:44:18Z
If the $(CATEGORY) [1] macro is added, ddoc could organize all symbols in a module per category when generating the documentation. [1] https://d.puremagic.com/issues/show_bug.cgi?id=11891
Comment #1 by hsteoh — 2014-06-26T05:20:49Z
This may have impact on compilation times, since the ddoc generation code will have to walk the AST twice, once to categorize the symbols, the second time to output them in sorted order.
Comment #2 by doob — 2014-06-26T21:05:12Z
How about having one buffer per category and then merging them at the end before outputting them. Will that help?
Comment #3 by hsteoh — 2014-06-26T21:12:36Z
That might work, though it does significantly change the way the ddoc code works right now. But I'm no expert in the ddoc code, so I could be wrong (I've only seen bits and pieces of it, just enough to fix some bugs, not enough to have an accurate overview of how it works).
Comment #4 by robert.schadek — 2024-12-13T18:15:49Z
THIS ISSUE HAS BEEN MOVED TO GITHUB https://github.com/dlang/dmd/issues/18752 DO NOT COMMENT HERE ANYMORE, NOBODY WILL SEE IT, THIS ISSUE HAS BEEN MOVED TO GITHUB