http://d.puremagic.com/issues/show_bug.cgi?id=3554
Summary: Ddoc generats invalid output for documentation
comments with non paired paranthasis
Product: D
Version: 2.032
Platform: Other
OS/Version: Linux
Status: NEW
Severity: normal
Priority: P2
Component: DMD
AssignedTo: [email protected]
ReportedBy: [email protected]
--- Comment #0 from Witold Baryluk <[email protected]> 2009-11-27
08:07:12 PST ---
Both this code:
/** Produces something in (a;b] */
float f(float a, float b) { return (a+b)/2.0; }
produces:
=====
<br><br>
$(DDOC_MODULE_MEMBERS
<dt><big>float <u>f</u>(float <i>a</i>, float <i>b</i>);
</big></dt>
<dd>Produces something in (<i>a</i>;<i>b</i>]
)
<br><br>
</dd>
=====
and this:
/** Produces something in [a;b) */
float f(float a, float b) { return (a+b)/2.0; }
produces
=====
<br><br>
<dl><dt><big>float <u>f</u>(float <i>a</i>, float <i>b</i>);
</big></dt>
<dd>Produces something in [<i>a</i>;<i>b</i><br><br>
</dd>
</dl>
)
=====
Produces very broken HTML files.
It should be somthing like:
======
<br><br>
<dl><dt><big>float <u>f</u>(float <i>a</i>, float <i>b</i>);
</big></dt>
<dd>Produces something in [<i>a</i>;<i>b</i>)
<br><br>
</dd>
</dl>
======
Of course i can use HTML entities, or other tricks, but this breaks assumption
that ddoc comments should be both readble in code and in HTML.
--
Configure issuemail: http://d.puremagic.com/issues/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
