On Jun 30, 11 13:20, Walter Bright wrote:
On 6/29/2011 8:35 PM, Ary Manzana wrote:
On 6/30/11 1:00 AM, Walter Bright wrote:
On 6/29/2011 4:25 AM, Walter Bright wrote:
Ddoc is:
7. We don't get left in the lurch if said third party quits.
8. Ddoc understands the semantics of D code. Third party doc generators
never will.
So the semantics of D code can only be understood by the compiler?
Hmmm...
How many third party doc generators include essentially a compiler for
every language they support - or even for any of them?
You don't need a compiler to understand a language for documenting the
code. A lexer is enough. And Pygment does support D.
http://pygments.org/languages/
Note that I and likely James Fisher are not talking about generating
header docs (i.e. Phobos docs), which point 8 will be valid. We're
talking about http://d-programming-language.org/language-reference.html
which restricting the choice to DDoc is unnecessary.