Andre Poenitz wrote:
On Fri, Mar 28, 2008 at 08:47:45AM +0100, Abdelrazak Younes wrote:
[EMAIL PROTECTED] wrote:
-/** Used to insert bibitem's information (key and label)
+/////////////////////////////////////////////////////////////////////////
+//
+// InsetBibItem
+//
+/////////////////////////////////////////////////////////////////////////
- Must be automatically inserted as the first object in a
- bibliography paragraph.
- */
-class InsetBibitem : public InsetCommand {
+/// Used to insert bibitem's information (key and label)
+
+// Must be automatically inserted as the first object in a
+// bibliography paragraph.
+class InsetBibitem : public InsetCommand
+{
Andre',
You are broking the doxygen tags. The style is more or less uniform in the
code:
/// Short Description.
/**
Long description...
*/
The three slashes in the first line are important, so is the trailing dot
at the end of the line.
The _two_ stars in the second line are important too.
Please don't change this style now.
Btw, is there a way to change the /** ... */ to something more
'C++-ish' (like any number of ///?) The non-balanced /**...*/
somehow hurts my sense of symmetry...
As I said in my other message, this is just our convention. We can as
well use this:
/// Short Description.
///
/// Long description...
/// bla bla
///
I am OK with this later style personally but most classes in our source
use the former.
Abdel.
