[Issue 17169] New default ddoc theme merges all paragraphs except the first

via Digitalmars-d-bugs digitalmars-d-bugs at puremagic.com
Mon Feb 13 19:58:35 PST 2017


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

--- Comment #3 from Nick Sabalausky <bus_dbugzilla at semitwist.com> ---
P1 is in a separate "Summary" div further up from the Description div shown
here. This, I understand, is intentional as the first paragraph is considered
to be the "summary", and the rest, "discussion"
<http://dlang.org/spec/ddoc.html#sections>.

Taking a look at the PR, and the test file changes in it, it appears it would
add <br><br> between P2 and P3 (just like the old theme did), although I havent
actually run the PR myself. There was some discussion in DMD PR#4745
<https://github.com/dlang/dmd/pull/4745#issuecomment-278841601> that this isn't
intended to be the ideal long-term aaproach, however it seemed generally agreed
that the "proper" aaproach would be tricky and involved, and that this <br><br>
was a better than nothing in the meantime.

--


More information about the Digitalmars-d-bugs mailing list