[prev in list] [next in list] [prev in thread] [next in thread]
List: doxygen-users
Subject: [Doxygen-users] Some \code content can remove all later headers
From: <Michael.Broida () thomsonreuters ! com>
Date: 2012-08-16 21:52:28
Message-ID: 771E62E6840B744DB5E6D184D40615FC02839B () EAGE-ERFPMBX47 ! ERF ! thomson ! com
[Download RAW message or body]
Hi!
Bug. Doxygen 1.8.1.2 on 64-bit WindowsServer2008 (server version of Vista).
Sample page (in file testme.dox):
-----------------------------------------
/*! \page testme TESTME
[TOC]
# First header {#testme_firstheader}
First line of text
\code{.cpp}
void MethodName( int arg1 /* = 0 */,
int arg2 /* = 0 */ )
{
DoNothing();
}
\endcode
# Next header {#testme_nextheader}
The header "Next header" will not appear.
*/
-----------------------------------------
Resulting doxygen page looks normal, EXCEPT: ALL headers after the \code block are \
missing from the page AND missing from the TOC. All other text, code, comments, etc, \
appears normally. The \code block starts and ends normally.
It seems to be tied to the C-style comments in the method signature, placed there to \
remind the developer that the declaration provides default values for those \
arguments. I've tried different combinations of those comments: each one \
individually, before/after the comma, before/after the closing parenthesis, etc. All \
fail.
Removing those C-style comments makes the "Next header" section header appear \
correctly.
Bug. C++ allows C-style comments.
Mike
This email was sent to you by Thomson Reuters, the global news and information \
company. Any views expressed in this message are those of the individual sender, \
except where the sender specifically states them to be the views of Thomson Reuters.
[Attachment #3 (text/html)]
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Generator" content="Microsoft Exchange Server">
<!-- converted from rtf -->
<style><!-- .EmailQuote { margin-left: 1pt; padding-left: 4pt; border-left: #800000 \
2px solid; } --></style> </head>
<body>
<font face="Courier New" size="2"><span style="font-size:10pt;">
<div>Hi!</div>
<div><font face="Calibri" size="2"><span \
style="font-size:11pt;"> </span></font></div> <div>Bug. \
Doxygen 1.8.1.2 on 64-bit WindowsServer2008 (server version of Vista).</div> \
<div><font face="Calibri" size="2"><span \
style="font-size:11pt;"> </span></font></div> <div>Sample page (in \
file testme.dox):</div> <div>-----------------------------------------</div>
<div>/*! \page testme TESTME</div>
<div> </div>
<div>[TOC]</div>
<div> </div>
<div># First header {#testme_firstheader}</div>
<div>First line of text</div>
<div><font face="Calibri" size="2"><span \
style="font-size:11pt;"> </span></font></div> <div>\code{.cpp}</div>
<div>void MethodName( int arg1 /* = 0 */,</div>
<div> \
int arg2 /* = 0 */ )</div> <div>{</div>
<div> DoNothing();</div>
<div>}</div>
<div>\endcode</div>
<div> </div>
<div># Next header {#testme_nextheader}</div>
<div>The header "Next header" will not appear.</div>
<div> </div>
<div>*/</div>
<div>-----------------------------------------</div>
<div><font face="Calibri" size="2"><span \
style="font-size:11pt;"> </span></font></div> <div><font face="Calibri" \
size="2"><span style="font-size:11pt;"> </span></font></div> <div>Resulting \
doxygen page looks normal, EXCEPT: ALL headers after the \code block are \
missing from the page AND missing from the TOC. All other text, code, comments, \
etc, appears normally. The \code block starts and ends normally.</div> \
<div><font face="Calibri" size="2"><span \
style="font-size:11pt;"> </span></font></div> <div>It seems to be tied to the \
C-style comments in the method signature, placed there to remind the developer that \
the declaration provides default values for those arguments. I've tried \
different combinations of those comments: each one individually, before/after the \
comma, before/after the closing parenthesis, etc. All fail.</div> <div><font \
face="Calibri" size="2"><span style="font-size:11pt;"> </span></font></div> \
<div>Removing those C-style comments makes the "Next header" section header \
appear correctly.</div> <div><font face="Calibri" size="2"><span \
style="font-size:11pt;"> </span></font></div> <div>Bug. C++ allows \
C-style comments.</div> <div><font face="Calibri" size="2"><span \
style="font-size:11pt;"> </span></font></div> <div><font face="Calibri" \
size="2"><span style="font-size:11pt;"> \
<font face="Courier New" size="2"><span \
style="font-size:10pt;">Mike</span></font></span></font></div> <div><font \
face="Calibri" size="2"><span style="font-size:11pt;"> </span></font></div> \
<div><font face="Calibri" size="2"><span \
style="font-size:11pt;"> </span></font></div> </span></font>
<br>
This email was sent to you by Thomson Reuters, the global news and information \
company. Any views expressed in this message are those of the individual sender, \
except where the sender specifically states them to be the views of Thomson \
Reuters.</body> </html>
[Attachment #4 (--===============1393291958586118691==)]
------------------------------------------------------------------------------
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and
threat landscape has changed and how IT managers can respond. Discussions
will include endpoint security, mobile security and the latest in malware
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
_______________________________________________
Doxygen-users mailing list
Doxygen-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic