Re: [Doxygen-users] [Fwd: Doxygen Question]

[Dimitri v. H. <di...@st...>]

On Sun, Dec 30, 2001 at 09:39:58AM +0200, Zvi Mizrahi wrote:
> Trying to forward again this question to teh mailing list.
> Thanks
> zv...@ga...
> www.marvell.com
> 

> X-Mozilla-Status2: 00000000
> Date: Sun, 23 Dec 2001 09:16:34 +0200
> From: Zvi Mizrahi <zv...@ga...>
> X-Mailer: Mozilla 4.74 [en] (Windows NT 5.0; U)
> X-Accept-Language: en
> To: dox...@li...
> Subject: Doxygen Question
> 
> Hi,
> We have enjoyed very much from evaluating the Doxygen
> tool for our code.  We have a question:
> 
> How we can cause Doxygen to insert Carriage returns that
> exist in the source code comments into the HTML/RTF
> documentation?
> 
> For example, Suppose we have the following code comment :
> 
> 
> /*!***************************************************************
>  * .............(other doxygen commands)
>  * @COMMENTS:
>  *       1. Comment1....
>  *       2. Comment2....
>  *
>  *****************************************************************/
> 
> In the configuration file, we have :
>      ALIASES = "COMMENTS=\par General Comments"
> 
> However, in the output we get comment 1 and comment 2
> in the same line:
> 
>     General Comments:
>            Comment 1....Comment 2....
> 
> The two comments appears in the same line since it is
> the same HTML paragraph.

The documentation you type in the comments works mostly as text
in HTML (i.e. text and markup commands), so this is not a bug!
Use
  -# Comment1
  -# Comment2

To get the ordered list you want (without even having to do the
counting yourself). This can of course also be read in the 
documentation (which is probably why nobody answered your question)...

Regards,
  Dimitri