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
