ddoc latex/formulas?

[Andrei Alexandrescu via Digitalmars-d]

On 09/14/2016 09:38 AM, Manu via Digitalmars-d 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!)

Generally speaking it's difficult to produce good latex documents 
without knowing latex, so it may be the case a latex crash course is 
needed or the task is ill-defined.

That said, the stuff I published at 
http://erdani.com/d/DIP1000-grammar.html and 
http://erdani.com/d/DIP1000-typing-baseline.html use MathJAX, you may 
want to take a look. Truth be told that's generated code (using a much 
smaller ddoc source).

> 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!

Why?


Andrei