On Jul 9, 2012, at 20:17 , <michael.bro...@thomsonreuters.com> <michael.bro...@thomsonreuters.com> wrote:
> ((I hope Outlook doesn't mess up this formatting...)) > > Still, the conversions Doxygen did on the <list> and </list> tags are really > weird. > > Here is a complete but silly example of XML in a <pre> block: > > /*! \page junkid JunkTitle > <pre> > <xxx> > <list> > <yyy>foo</yyy> > <zzz>bar</zzz> > </list> > </xxx> > </pre> > */ > > Doxygen generates this HTML (inside a class="textblock" div tag): > > <pre> > <xxx> > </p> > <ul> > </ul> > <p><yyy>foo</yyy> > <zzz>bar</zzz> > </pre><pre> > </xxx> > </pre> > > which is not correct and renders -very- badly. That's because <list> is an XML command doxygen supports: http://www.stack.nl/~dimitri/doxygen/xmlcmds.html > > (My original file, with the <pre> inside a cell of a table, also generated > </li></ul> between the first </pre> and second <pre> tags, so maybe this is > partially dependent on other content.) > > > BTW: \verbatim works but since my <pre> is in a cell in a table, the > resulting colored block around the \verbatim adds another border inside that > cell. Using <pre> and escaping <list> and </list> looks cleaner in this > case. :) But it does mean I have to watch the output closely to catch any > other glitches like that. > > I'm using a table so I can give the block a title in one row and put the > block in the second row. Is there a way to "title" a \verbatim or \code > block? (<pre> has a "title" attribute, but it's only visible when mousing > over the block.) You could use: /*! \page junkid JunkTitle Some text \myblock <xxx> <list> <yyy>foo</yyy> <zzz>bar</zzz> </list> </xxx> \endmyblock{some title} More text */ along with the following alias definitions in the config file: ALIASES = myblock=\verbatim endmyblock{1}=\endverbatim<center><b>\1</b></center> for a verbatim block with caption. Regards, Dimitri ------------------------------------------------------------------------------ Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/ _______________________________________________ Doxygen-users mailing list Doxygen-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/doxygen-users
