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
