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.
