This is an improved version of my previous patch to add '\li2' and
'\li3' tags to Doxygen.
This adds \li2 and \li3 tags to Doxygen (diff'd against 1.4.7). \li2 is
identical to \param except that it does not cause a section to be
created, and so can be used with custom sections (\par) or in the
detailed description. \li3 uses the first (typically unused, except for
\param with [in], [out], [in,out]) column to make three-column lists
(\li2 does 2-column lists, obviously); it treats '-' as an empty cell.
This second version attempts to support the other formats (man, rtf,
latex) as well, although the latex support is a WAG (because I don't
know latex and don't have latex to play around with it); man however I
do know and should be OK. This also contains a file with suggested doc,
although I didn't patch it because my cursory glance at the existing doc
did not reveal any obvious logic for where in the existing doc this
should be placed (the order is not simply alphabetical).
This could still benefit from allowing \li2 and \li3 to be mixed,
although that would either violate some coding principles (assign both
the same internal type, but parse differently) or make the code a good
deal more complicated than the existing hack of treating '-' as an empty
word.
--
Matthew
"Try to bring it back in one piece this time." -- Q (MI6)
|
