Bug 17618 – parse booktables manually to check whether symbols haven't been mentioned

Status
NEW
Severity
enhancement
Priority
P4
Component
dlang.org
Product
D
Version
D2
Platform
x86_64
OS
Linux
Creation time
2017-07-07T17:13:12Z
Last change time
2024-12-15T15:24:08Z
Assigned to
No Owner
Creator
Seb
Moved to GitHub: dlang.org#3963 →

Comments

Comment #0 by greensunny12 — 2017-07-07T17:13:12Z
Grouped booktables are awesome - they look very nice and give the reader and quick overview (except for std.traits). However, it repeatedly happened that when new symbols get added, these booktables aren't updated. Two ideas: For all modules with a booktable 1) Parse the public symbols and check whether all have been mentioned in the module comment (a simple `find` could do) 2) Use a Group: xxx key in the function comment header and build the booktable as postprocessing of Ddoc. Probably doing (1) as a DScanner check is the easiest. https://github.com/dlang/phobos/pull/5570/files
Comment #1 by greensunny12 — 2017-07-07T17:14:49Z
Comment #2 by robert.schadek — 2024-12-15T15:24:08Z
THIS ISSUE HAS BEEN MOVED TO GITHUB https://github.com/dlang/dlang.org/issues/3963 DO NOT COMMENT HERE ANYMORE, NOBODY WILL SEE IT, THIS ISSUE HAS BEEN MOVED TO GITHUB