Abstract DDoc output for better document generation

[Sönke Ludwig via Digitalmars-d]

Am 17.05.2014 20:28, schrieb Mason McGill:
> On Saturday, 17 May 2014 at 18:03:53 UTC, Tolga Cakiroglu wrote:
>> After having some experience with documentation generation from
>> dmd command like, and seeing outputs, I wasn't satisfied with it.
>> Other alternatives as Doxygen is available, though it parses
>> codes itself that is not based on what version of DMD is
>> installed on system.
>>
>> Since the structure of DDoc is already defined, instead of
>> generating HTML output, I would propose to generate an XML file
>> that contains meta data about codes and comments which can be
>> used by 3rd party documentation generator programmes to generate
>> HTML files. This way DDoc definitions can be simplified, better
>> looking documents can be generated much easily.
>
> Try compiling with the -X flag to generate a JSON file describing
> the source. Add the -D flag if you want documentation comments in
> the JSON output.
>
> Hope that helps!

Also see https://github.com/rejectedsoftware/ddox for DDOC compatible 
documentation generator that uses the JSON output. However, due to 
various shortcomings, of which not all are easy to resolve, I'm planning 
to instead directly use a D parser at some point.