www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.bugs - [Issue 14608] New: Enum members should be formatted as a table

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

          Issue ID: 14608
           Summary: Enum members should be formatted as a table
           Product: D
           Version: D2
          Hardware: All
                OS: All
            Status: NEW
          Severity: enhancement
          Priority: P1
         Component: websites
          Assignee: nobody puremagic.com
          Reporter: andrei erdani.com

Consider e.g.
http://dlang.org/phobos-prerelease/std_algorithm_searching.html#.OpenRight.
There, we have a lavishly laid itemization for only little content.

All enum values have one-word declarations and short descriptions. It would be
great if they were laid instead as a table (similar to "Params:") with two
columns (name and description). There should be no "Jump to" for the values.

The ddox-based documentation is actually worse - it generates one page per enum
value (see e.g.
http://dlang.org/library/std/algorithm/searching/open_right.no.html. Most of
those pages are fluff. Enums should be compressed to one page with all values
and their descriptions on it.

--
May 19 2015