www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.bugs - [Issue 17209] New: Fix warning: public symbol is undocumented

https://issues.dlang.org/show_bug.cgi?id=17209

          Issue ID: 17209
           Summary: Fix warning: public symbol is undocumented
           Product: D
           Version: D2
          Hardware: x86_64
                OS: Linux
            Status: NEW
          Severity: enhancement
          Priority: P1
         Component: phobos
          Assignee: nobody puremagic.com
          Reporter: greeenify gmail.com

There's a dscanner check to look for undocumented public symbols.
It finds about 3K symbols. This means Phobos is massively "leaking" symbols.
Most of them can simply be set to private, but others may need to undergo a
deprecation process.
For the full result see:

http://pastebin.com/6rygthes

(or run make -f posix.mak style with the `undocumented_declaration_check`
enabled)

--
Feb 20