[Issue 14307] Ddoc: issue error on all functions that are missing ddoc sections

via Digitalmars-d-bugs digitalmars-d-bugs at puremagic.com
Wed Mar 18 12:02:36 PDT 2015


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

Jonathan M Davis <issues.dlang at jmdavisProg.com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |issues.dlang at jmdavisProg.co
                   |                            |m

--- Comment #1 from Jonathan M Davis <issues.dlang at jmdavisProg.com> ---
In principle, I like the idea. However, I don't know about requiring Returns
and Params sections and examples. There are plenty of cases where you want
them, but there are also cases where they're so obvious that documenting them
is redundant and therefore just creates noise in the file - especially on stuff
like property functions.

--


More information about the Digitalmars-d-bugs mailing list