[Issue 1797] Documentation comments - ///

[d-bugmail at puremagic.com]

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


unknown at simplemachines.org changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
         AssignedTo|bugzilla at digitalmars.com    |unknown at simplemachines.org
             Status|NEW                         |ASSIGNED




------- Comment #2 from unknown at simplemachines.org  2008-01-23 03:38 -------
Created an attachment (id=219)
 --> (http://d.puremagic.com/issues/attachment.cgi?id=219&action=view)
Simple lexer.c patch

Okay, this patch does two things.  First, it fixes this issue by not adding an
extra \n between two nearby block comments.

This does not break that this:

/**
 * Summary
 */
/**
 * Long Description
 */

Still works properly.  It does not now nor did it before work for this:

/** Summary
 */
/** Long Description
 */

So this patch doesn't (that I can tell) break anything worse than current, but
does improve ///.

Second, it fixes an issue wherein /** ... */ comments were typically not
properly being separated.  Meaning, before this did not even work:

/**
 * Summary
 */
/**
 * Long Description
 */

Based on the code, the fact that the combine comments function was trying to
make that work, and the documentation... I fixed it so this works as well (the
problem is that last line, " */".

-[Unknown]


--