[Issue 1797] New: Documentation comments - ///

[d-bugmail at puremagic.com]

http://d.puremagic.com/issues/show_bug.cgi?id=1797

           Summary: Documentation comments - ///
           Product: D
           Version: unspecified
          Platform: PC
        OS/Version: Windows
            Status: NEW
          Severity: normal
          Priority: P2
         Component: DMD
        AssignedTo: bugzilla at digitalmars.com
        ReportedBy: unknown at simplemachines.org


C# style documentation comments, which use lines prepended with ///, are not
being parsed correctly.  Two lines in a row are treated as separate blocks, and
separated with the DDOC_BLANKLINE macro.

It seems to me this was once supported, although ddoc.html has always
listed "///" as a single line documentation comment.

/// Summary
///
/// Example line 1
/// Example line 2

Expected Results:

Summary

Example line 1 Example line 2

Actual Results:

Summary

Example line 1

Example line 2

If I have time (won't tonight), I'll try to figure up a patch for this issue,
if I can test it with the compiler sources/latest dmdfe.

-[Unknown]


--