[Issue 17618] New: parse booktables manually to check whether symbols haven't been mentioned
via Digitalmars-d-bugs
digitalmars-d-bugs at puremagic.com
Fri Jul 7 10:13:12 PDT 2017
https://issues.dlang.org/show_bug.cgi?id=17618
Issue ID: 17618
Summary: parse booktables manually to check whether symbols
haven't been mentioned
Product: D
Version: D2
Hardware: x86_64
OS: Linux
Status: NEW
Severity: enhancement
Priority: P1
Component: dlang.org
Assignee: nobody at puremagic.com
Reporter: greensunny12 at gmail.com
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
--
More information about the Digitalmars-d-bugs
mailing list