Preprocessing CSS

[Andrei Alexandrescu via Digitalmars-d]

On 5/25/16 8:22 AM, Adam D. Ruppe wrote:
> On Wednesday, 25 May 2016 at 12:14:35 UTC, Steven Schveighoffer wrote:
>> So much this. And where are they defined?
>
> All over the place.
>
> Seriously, many of the Phobos modules define their own custom MYREF or
> SUBREF macros, in addition to the bazillion existing XREF and XREF2 and
> XREF3 and so on and so forth in the *.ddoc files.

Yah, consolidating those would be nice. I ran a large consolidation a 
couple years ago but didn't get to everything.

> And yes, it really is *.ddoc - dlang.org.ddoc has some, then they are
> redefined in latex.ddoc and std-ddox.ddoc and there's variants of them
> in std.ddoc.

That's by design. The whole idea here is to use a given macro and have 
latex.ddoc define it a different way than html.ddoc. Did you find macros 
with identical definitions across ddoc files? (Those would be bugs.)

> This is one of the reasons I ditched all this crap and started writing
> my own docs!

Did you consider simply fixing some of that crap?


Andrei