ddoc latex/formulas?

[bachmeier via Digitalmars-d]

On Wednesday, 14 September 2016 at 13:38:21 UTC, Manu wrote:
> On 14 September 2016 at 21:36, Andrei Alexandrescu via 
> Digitalmars-d <digitalmars-d at puremagic.com> wrote:
>> On 9/14/16 1:50 AM, Manu via Digitalmars-d wrote:
>>>
>>> Can we produce formulas, or latex in ddoc? Are there any 
>>> examples in phobos I can refer to?
>>
>>
>> https://github.com/dlang/dlang.org/blob/master/latex.ddoc
>>
>> That's the macros file for generating the language spec in 
>> LaTeX format.
>
> Ah, wow, yeah I actually saw this when I googled for it before 
> posting here.
>
> I'm just gonna come out and say that I really don't feel like 
> taking
> the few hours it might take me to try and understand what's 
> going on
> here. I really have better things to do...
> Considering I don't really know latex either, I just have to 
> wing
> that, this is like 721 lines of tedious double-indirection, 
> with no
> examples in sight ;) (yet I'm being hassled about lack of 
> examples!)
>
> I'm kinda feeling ddoc is fairy serious problem. Doxygen is 
> like... a
> lot better :/
> I'm struggling to produce docs I'm happy with. Formatting is 
> hard,
> macros for everything really sucks!

I agree. That's why I quickly gave up on ddoc. The macro system 
needs to be better designed and documented if that's the route 
you're going to choose.

That said, if all you want to do is insert equations in the 
finished documentation, can't you do a simple text substitution 
on the ddoc output file? I needed equations so I did that when I 
started. It was a D script with only a few lines of code.