A few notes on the ddox-based documentation
Adam D. Ruppe via Digitalmars-d
digitalmars-d at puremagic.com
Sat Mar 4 19:19:15 PST 2017
On Sunday, 5 March 2017 at 03:14:14 UTC, Adam D. Ruppe wrote:
> So it illegally nested a link inside a link, which the browser
> interpreted as two adjacent links... and both got that
> padding-right from the rule I quoted in my last email, thus
> getting some blank space on the first row.
On second thought, yes, ddox shouldn't output invalid HTML if it
can help it, but this is actually an antipattern I see a lot in
Phobos and hate:
$(D $(LREF Abort)))
That's an unnecessary repetition! If it is an LREF in a D source
file, then you *already know* it is a D symbol, so the `$(D)`
macro is redundant anyway.
I'd simplify that to just be `$(LREF ...)` in all cases it
appears in the Phobos source, and then if you want it to be
styled in the monospace font, do a css rule for *that*.
so while ddox could be better, I take back blaming it.
More information about the Digitalmars-d
mailing list