Re: [Doxygen-develop] Grouping Of Simple Sections

[Jake C. <co...@pp...>]

>>>>> "s" == smokingrope  <smo...@gm...> writes:

   s> I put together a feature request in bugzilla and have now submitted a patch
   s> which implements the desired functionality.

   s> http://bugzilla.gnome.org/show_bug.cgi?id=539333

   s> The idea was to allow certain paragraphs to be merged into a single
   s> paragraph before appearing int the final output formats created by doxygen.
   s> My reasoning behind doing this was to make a robust way for capturing the
   s> progression of events within a function. It just so happened that allowing
   s> existing paragraph commands such as note, return, author, etc... was very
   s> little trouble.

   s> This feature is similar to the addendum functionality described in the
   s> todo-list, however in the context of the paragraphs in a function, class or
   s> variable's documentation block.

   s> The patch has been generated against the doxygen 1.5.6 trunk, please let me
   s> know if there is anything i can do to help this feature into the codebase.

Sean,

I looked at your bugzilla entry and am confused about what your patch
does - although I think I'm quite interested.  

It always bothered me that the various sections of the documentation
appear strictly in the order that they were written.  Given multiple
developers, I cannot guarantee that they all do it the same way.  Does
your patch enforce the output ordering of those sections?

Also, how would someone use your new "merging" feature and what is its
point?  Why would you have the same section command multiple times for a
single block?  Or am I misunderstanding the point?

...Jake


-- 
Jake Colman
Director of Software Development
Principia Partners LLC
101 West Elm Street
Suite 620
Conshohocken, PA  19428
+1 (610) 755-9786
www.principiapartners.com