[Doxygen-users] \n newline in aliases

[Friedrich, L. <lar...@wa...>]

I was trying to generate a list which looks like this:

24.05.2005 Theory of a dead man
22.07.2006 Can't think of something

This is how I would use it inside doxygen:
\par History:
\c 24.05.2005 Theory of a dead man\n
\c 22.07.2006 Can't think of something\n

But as this doesn't look that much like doxygen,
I made an alias
ALIASES=3D"history=3D\n \c"
(as you can't put something behind the text,
the newline is in front so it generates the
newline for the previous text).

so I can just write:
\history 24.05.2005 Theory of a dead man
\history 22.07.2006 Can't think of something

This should output
\n \c 24.05.2005 Theory of a dead man
\n \c 22.07.2006 Can't think of something

In HTML I would expect to see something like
<br /><code>24.05.2005</code>Theory of a dead man<br =
/><code>22.07.2006</code>Can't think of something

According to the documentation:
"\n Forces a new line. Equivalent to <br> and inspired by the printf =
function."

But the HTML output generator does not put <br> into the HTML code.
I assumed this was a bug, filed a bug report and it was set to resolved
as \n is not supposed to generate a HTML <br>. As I don't want to
clutter bugzilla, I hope I can get some rationale behind this here.
HTML does not care about pure newlines in the code (neither does Latex)
so there would be no point at all to use \n in aliases. Using <br> in
the aliases does the correct thing and according to the documentation
\n is equivalent to <br>.

(I'm using \li \c now and <br> \c will work, too, I just don't =
understand
the reasoning that \n does not generate <br>.)

Best regards,
Lars Friedrich