[Doxygen-develop] Comment diagrams

[Stathis S. <im...@sa...>]

Hello,

I'm really glad that you liked ditaa, and that you tought it would be
useful. :-)

Before diving too deep into the (120k lines!) code to add the \ditaa and
\endditaa tags, I would like to ask for some pointers so that I don't
get lost.

It seems that I would need to add ditta and edditta to to cmdmapper.cpp
and cmdmapper.h.

Then I would need to modify config.l I'm not familiar with flex, so this
will be tricky...

I would propose to add the following entries in the configuration:

HAVE_DITAA: whether ditaa processing occurs (like HAVE_DOT)
DITAA_JAR: filename (with full path) of the ditaa jar file

Another thing is how you would pass command line parameters to ditaa
itself. How about the line after the \ditaa tag being reserved for that?
Example:

\ditaa no-shadows round-corners
+--+
|  |
+--+
\endditaa

or something of the kind.

Then I would probably have to add something to docparser.cpp so that
ditaa starts if the \ditaa tag is found in a comment. Also the
appropriate changes in htmlgen.cpp for the <img> tags to be inserted (I
suppose ditta would not be possible for other formats, it doesn't make
postscript yet!),

Am I making any sense at all? :-) Any tips/help would be very welcome.

Thanks

Stathis


-- 
________

Efstathios Sideris
Biomolecular Structure and Modelling Unit
Department of Biochemistry and Molecular Biology
University College London
Darwin Building, Gower Street
London WC1E 6BT, UK