> 1) I have markup inside a class constructor like this:
>
> //! @page Com Windows COM
> //! @section ComRegistry Registry Example
> //!
> //! @verbatim
> //! __uuidof(NetFwMgr) == {304CE942-6E39-40D8-943A-B913C40C9CD4}
> //!
> //!
> [HKEY_CLASSES_ROOT\CLSID\{304CE942-6E39-40D8-943A-B913C40C9CD4}]
> //! @="HNetCfg.FwMgr"
> //!
> //! ...
> //!
> #ifdef DEBUG
> StringFromCLSID(__uuidof(INetFwMgr), &uuid_string);
> _RPTW1(_CRT_WARN, L"INetFwMgr %s\n", uuid_string);
> #endif
> //! __uuidof(INetFwMgr) == {F7898AF5-CAC4-4632-A2EC-DA06E5111AF2}
> //!
> //!
> [HKEY_CLASSES_ROOT\Interface\{F7898AF5-CAC4-4632-A2EC-DA06E511
1AF2}] \n
> //! @="INetFwMgr"
> //!
> //! @endverbatim
Apparently, placing \page and friends in a function body is a big no-no.
I just realized doing that effectively breaks the documentation for the
function. That's too bad. Moving that documentation outside of the
function body compromises its value when reading the source file
directly.
I can force the function documentation to occur with \fn, but then it
does not contain cross-reference information like "Definition at line
x of File y", References links, and call Graph (as though it was not
found - even though no warnings are given to that effect).
---
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
