RE: [Doxygen-develop] is it allowed to post an file-attachment over this mailing-list

[Michael M. <Mic...@tt...>]

Hi Eckard,

Your request sounds similar to something I did, although I'm not entirely
sure so tell me if I'm wrong :)

I wished to add message sequence charts as diagrams to the documentation,
but by adding a textual description of the MSC to the doxygen comments, in
the same way that DOT diagrams can be added.  

To make this easy to integrate into Doxygen, I enhanced doxygen with a \cmd
and \endcmd special command that would run a shell command.  The format is
something like this:

\cmd eps{mscgen -T eps -i $in -o $out} png{mscgen -T png -i $in -o $out}
ismap{mscgen -T ismap -i $in -o $out}
   ...
\endcmd

Doxygen looks at the line and depending on the type of output it requires
(eps for LaTeX, png and imagemaps for HTML etc..), then selects the command
line to use.  $in is replaced by a temporary file that contains any text
between the \cmd and \endcmd, and $out is the desired output name.
Generally I use ALIASES to make the command friendlier by substituting the
full \cmd and \endcmd lines to something easier to use. 

This change made it easy for me to call sub-programs for rendering any
textual data embedded into Doxygen comments. 

If you are interested, look at http://www.mcternan.co.uk/mscgen/index.html.
The doxygen bit is at the bottom, together with the source of course!

Regards,

Mike

> -----Original Message-----
> From: dox...@li... [mailto:doxygen-develop-
> ad...@li...] On Behalf Of Eck...@t-...
> Sent: 13 March 2006 18:34
> Cc: Erik Zeek
> Subject: Re: [Doxygen-develop] is it allowed to post an file-attachment
> over this mailing-list
> 
> Hello Dr. Zeek.
> 
> Thank you for your answer.
> 
> My English is not very good, so may be I didn't wrote what I mean or I
> misunderstood your answer.
> The program I'm working on is not an origin part of doxygen. It should be
> a
> tool for doxygen like dot. So I wonder, if it is a good idea to report my
> problems as bugs of doxygen.
> 
> On the other hand I'm searching for a possibility to offer the developers
> (and, if they are interested in, the users) the possibility to test my
> program. I have no own home-page so I'm  thinking about posting the
> program
> on source-forge as own project. But this means for me to spend some time
> as
> project-administrator and time is a scarce good for me too.
> 
> I know that the developers of doxygen are volunteers which couldn't work
> on
> the project around the clock. But how should they respond without the
> chance
> to test my tool?
> 
> Eckard.
> 
> PS. Please forgive me if my mail sounds a little bit rough. It's always a
> little bit difficult for me to find the right words.
> 
> 
> 
> 
> ----- Original Message -----
> From: "Erik Zeek" <ze...@ma...>
> To: <dox...@li...>
> Cc: <Eck...@t-...>
> Sent: Sunday, March 12, 2006 7:39 PM
> Subject: Re: [Doxygen-develop] is it allowed to post an file-attachment
> over
> this mailing-list
> 
> 
> 
> 
> 
> -------------------------------------------------------
> This SF.Net email is sponsored by xPML, a groundbreaking scripting
> language
> that extends applications into web and mobile media. Attend the live
> webcast
> and join the prime developer group breaking into this new coding
> territory!
> http://sel.as-us.falkag.net/sel?cmd=lnk&kid=110944&bid=241720&dat=121642
> _______________________________________________
> Doxygen-develop mailing list
> Dox...@li...
> https://lists.sourceforge.net/lists/listinfo/doxygen-develop