[Issue 14413] Spurious newline in ddoc JSON output for multiple successive line doc comments

[via Digitalmars-d-bugs]

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

--- Comment #6 from Nick Sabalausky <cbkbbejeap at mailinator.com> ---
This is happening in function "Lexer::combineComments" in "lexer.c". The
function combines consecutive doc comments, like:

/++ comment 1 +/

/++
  comment 2
+/

/** comment 3 */
/** comment 4 */

/// comment 5
/// comment 6

Note that the lexer treats each line of a line comment as a separate comment.

Those all get combined and each one becomes a separate paragraph (by way of
"Lexer::combineComments" concatenating them with an extra \n added in between
each one).

Ideally, IMO, "Lexer::combineComments" should only add the \n if there's at
least one blank line between two comments. I'm not sure how feasable that is,
but at the very least omitting the extra \n in between each would be an
improvement, because I can't imagine that consecutive doc comments are really
all that common, aside from the case in question here (immediately consecutive
line comments).

--