On Nov 23, 2012, at 19:47 , ext-todd.thor...@nokia.com wrote:

> 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.

When doxygen is looking for a parameter list inside a @see section it appears 
that is does not expect to find a ^, 
so that's why only the non-overloaded version is linked. I'll correct this.

Regards,
  Dimitri 


------------------------------------------------------------------------------
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

Reply via email to