Improving ddoc

[Andrei Alexandrescu via Digitalmars-d]

On 1/1/15 2:10 AM, Joseph Rushton Wakeling via Digitalmars-d wrote:
> On 01/01/15 05:48, Andrei Alexandrescu via Digitalmars-d wrote:
>>> But on a deeper note, perhaps the issue isn't really ddoc syntax per se,
>>> but the fact that doc comments can *only* be processed by ddoc. If there
>>> was a way to get the raw text out, the people who dislike ddoc can pipe
>>> it to the formatter of their own choice, and they would be happy. People
>>> who are indifferent will get ddoc by default, which, despite its flaws,
>>> isn't really *that* horrible.
>>
>> That's pretty much the very charter of ddoc- most misunderstood tool
>> ever.
>> Luckily I'll send some pull requests that simplify generation - some time
>> next year :o)
>
> My problem is very much the opposite: it's not that only ddoc can
> process ddoc syntax, it's that raw ddoc syntax is, often, not very
> human-readable.  For me it's very important that the documentation
> should be trivially comprehensible _when browsing source code_, and too
> often Ddoc markup prevents that.

Got it. I think auto-macroizing would help with that. -- Andrei