Moving the \page, \section, and \verbatim outside the function body comes
close to doing what I want BUT any text between @section and @verbatim is
placed in its own "box" as though it was bounded by \verbatim and
\endverbatim.
//! @page Com Windows COM
//! @section ComRegistry Registry Example
//!
//! COM depends on registration of COM servers in the Windows Registry...
//!
//! @verbatim
//! __uuidof(NetFwMgr) == {304CE942-6E39-40D8-943A-B913C40C9CD4}...
//!
//! @endverbatim
To restate, on the Com page, the text beginning "COM depends" appears
inside a separate, but similar, box that \verbatim ... \endverbatim
text appears in. It looks as though styling is being applied to a
container rather than to a sub-container holding the verbatim text.
Actually, the generated HTML source says:
<h1><a class="anchor" id="ComRegistry"></a>
Registry Example</h1>
<pre class="fragment">COM depends...
</pre><pre class="fragment">//! __uuidof(NetFwMgr) ==
{304CE942-6E39-40D8-943A-B913C40C9CD4}...
</pre> </div></div><!-- contents -->
Based on the source HTML of other \page \section text, I would have
expected more along the lines of:
<h1><a class="anchor" id="ComRegistry"></a>
Registry Example</h1>
<p>COM depends...</p>
<pre class="fragment">//! __uuidof(NetFwMgr) ==
{304CE942-6E39-40D8-943A-B913C40C9CD4}...
</pre> </div></div><!-- contents -->
It has the appearance that I need to avoid use of \verbatim to avoid
repercussions in the generated documentation. There must be a fair
number of undocumented conditions when use of \verbatim is unwise.
---
Kevin R. Bulgrien
New Product Development Engineer
The author is not under control of what appears below this point...
This message and/or attachments may include information subject to GD Corporate
Policy 07-105 and is intended to be accessed only by authorized personnel of
General Dynamics and approved service providers. Use, storage and transmission
are governed by General Dynamics and its policies. Contractual restrictions
apply to third parties. Recipients should refer to the policies or contract to
determine proper handling. Unauthorized review, use, disclosure or
distribution is prohibited. If you are not an intended recipient, please
contact the sender and destroy all copies of the original message.
------------------------------------------------------------------------------
Learn the latest--Visual Studio 2012, SharePoint 2013, SQL 2012, more!
Discover the easy way to master current and previous Microsoft technologies
and advance your career. Get an incredible 1,500+ hours of step-by-step
tutorial videos with LearnDevNow. Subscribe today and save!
http://pubads.g.doubleclick.net/gampad/clk?id=58041391&iu=/4140/ostg.clktrk
_______________________________________________
Doxygen-users mailing list
Doxygen-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users
