DDoc and logically structured HTML

[Stewart Gordon]

On 11/03/2012 02:26, Kevin Cox wrote:
<snip>
> I hate to say it but I think the ddoc system was way overthought.  It would be better to
> use a markup language such as Creole that is meant to look nice and you can convert that
> into anything you want.  You could leave the default html but provide an api for accessing
> a parsed tree.

I think this is more or less how Java doclets work.  It works because Java's bytecode and 
dynamic class loading provide a means to call an arbitrary method of an arbitrary compiled 
class that need not be part of the same app.

But how are we going to do this with D?  It seems we would need to either:
(a) compile the doclet on the fly and pass the parse tree into it
(b) have in said API a parse tree constructor that translates it from a textual 
representation received through stdin.

Stewart.