http://d.puremagic.com/issues/show_bug.cgi?id=9758
Summary: Ddoc: empty ddoc comment and unittest block generates
no Examples section
Product: D
Version: D2
Platform: All
OS/Version: All
Status: NEW
Keywords: ddoc
Severity: minor
Priority: P2
Component: DMD
AssignedTo: [email protected]
ReportedBy: [email protected]
--- Comment #0 from Kenji Hara <[email protected]> 2013-03-19 08:24:08 PDT ---
>From the discussion in https://github.com/D-Programming-Language/dmd/pull/1765
Currently, this code:
/// test
void foo(){}
///
unittest { }
Will generate:
void foo();
test
There is no "Examples:" section, because unittest block has empty ddoc comment
and code block. But I think generating "Examples:" section is sometimes useful,
even if there is no text. For example making placeholder to represent necessity
of later documentation writing.
--
Configure issuemail: http://d.puremagic.com/issues/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
