www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.bugs - [Issue 17171] New: ddoc: enum misses some values + wrong order +

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

          Issue ID: 17171
           Summary: ddoc: enum misses some values + wrong order + missing
                    member initializers
           Product: D
           Version: D2
          Hardware: x86
                OS: Mac OS X
            Status: NEW
          Severity: critical
          Priority: P1
         Component: tools
          Assignee: nobody puremagic.com
          Reporter: timothee.cour2 gmail.com

std.process.d:
```
enum Config
{
    none = 0,
...
}
```

https://dlang.org/library/std/process/config.html:

* A1 the `none` entry doesn't appear.

* A2 the entries are out of order

* A3 the automatic splitting with a hyphen (re-tain-Stderr) is very annoying,
at least use a bigger margin than 6

* A4 the member initializers are not shown
For A4, https://issues.dlang.org/show_bug.cgi?id=9695 was marked as closed
however it's very arguable, it could be part of documentation (even if with a
CAVEAT mentioning implementation detail); for example: I reopened
https://issues.dlang.org/show_bug.cgi?id=129 because the enums in ddoc are
downgraded to their integral counterparts, which creates a catch 22 situation,
since we can't look up the enum values from ddoc because of A4 !

--
Feb 09