Hi,
I'm documenting header files, some of which define overloaded methods similar
to below:
void doFoo();
void doFoo(String^ someWord , int someNumber);
void doFoo(String^ someWord, String someOtherWord, int someNumber);
void doFoo(String^ someWord, String someOtherWord,
Windows::Foundation::Collections::IVector<String>^ someCollectionOfWords, int
someNumber);
When I try to cross-reference such related methods in the documentation, I use
tag syntax in the header comments similar to the following:
@see doFoo(String^,int)
@see doFoo(String^, String, int)
@see doFoo(String^, String, Windows::Foundation::Collections::IVector<String>^,
int)
The closest I can get to the expected html output after running through doxygen
is to have each "See also:" linking to the description for the default doFoo()
method. In the output only the "doFoo" part ever appears as hypertext, with
parameters always displayed as plain text, as illustrated below:
void doFoo()
Does some serious foo without needing any parameters.
See also:
doFoo(String^,int) <-- links back to this very same description
doFoo(String^, String, int) <-- links back to this very same description
doFoo(String^, String, Windows::Foundation::Collections::IVector<String>^, int)
<-- links back to this very same description
It is apparent that I am making a mistake with the @see tags, but when I try to
finagle their syntax I end up getting no hyperlinks at all (just plain text
under each "See also:" entry). I'm close to understanding what's needed, but
can't quite get there.
Thanks for any insight,
Todd Thorner
------------------------------------------------------------------------------
Monitor your physical, virtual and cloud infrastructure from a single
web console. Get in-depth insight into apps, servers, databases, vmware,
SAP, cloud infrastructure, etc. Download 30-day Free Trial.
Pricing starts from $795 for 25 servers or applications!
http://p.sf.net/sfu/zoho_dev2dev_nov
_______________________________________________
Doxygen-users mailing list
Doxygen-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users
