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