[C++] Creating a link to a function inside namespace
Posted: Wed Sep 02 2020 7:08 pm
Hi,
I can't get links to functions inside namespaces to work. Other symbols (classes inside namespaces, global functions) cause no problems. I've read the docs about links (https://www.copperspice.com/docs/doxypress/topic-autolink.html), however I couldn't find there specific examples about namespaces.
I'm using doxypress 1.3.8 and default html output.
Also, with clang parsing enabled no link actually works, but when I disable it, all links work except for the links to functions inside namespaces. This is actually another problem - when clang is enabled the comments are interpreted slightly differently and the html output is a bit different (I can make screenshots if needed).
I've created an example header file to show the problem. There are links inside @file section and inside class section (they are exactly the same). I tried many different forms of links as you can see in the example below.
So to sum it up there are 2 problems:
1. Links to functions inside namespace doesn't seem to work or I missing something.
2. When clang is enabled the comments are interpreted a bit differently and the html output is slightly different.
Thanks
I can't get links to functions inside namespaces to work. Other symbols (classes inside namespaces, global functions) cause no problems. I've read the docs about links (https://www.copperspice.com/docs/doxypress/topic-autolink.html), however I couldn't find there specific examples about namespaces.
I'm using doxypress 1.3.8 and default html output.
Also, with clang parsing enabled no link actually works, but when I disable it, all links work except for the links to functions inside namespaces. This is actually another problem - when clang is enabled the comments are interpreted slightly differently and the html output is a bit different (I can make screenshots if needed).
I've created an example header file to show the problem. There are links inside @file section and inside class section (they are exactly the same). I tried many different forms of links as you can see in the example below.
Code: Select all
#pragma once
/** @file
* Links to member functions:
Project::Module1::Item::method
Project::Module1::Item::method()
::Project::Module1::Item::method
::Project::Module1::Item::method()
Project#Module1#Item#method
Project#Module1#Item#method()
#Project#Module1#Item#method
#Project#Module1#Item#method()
* Links to namespace functions:
nameSpaceFunction
nameSpaceFunction()
::nameSpaceFunction
::nameSpaceFunction()
#nameSpaceFunction
#nameSpaceFunction()
Project::Module1::nameSpaceFunction
Project::Module1::nameSpaceFunction()
::Project::Module1::nameSpaceFunction
::Project::Module1::nameSpaceFunction()
Project#Module1#nameSpaceFunction
Project#Module1#nameSpaceFunction()
#Project#Module1#nameSpaceFunction
#Project#Module1#nameSpaceFunction()
* Links to free functions:
freeFunction
freeFunction()
::freeFunction
::freeFunction()
*/
namespace Project::Module1 {
/** @brief Description
* Links to member functions:
Project::Module1::Item::method
Project::Module1::Item::method()
::Project::Module1::Item::method
::Project::Module1::Item::method()
Project#Module1#Item#method
Project#Module1#Item#method()
#Project#Module1#Item#method
#Project#Module1#Item#method()
* Links to namespace functions:
nameSpaceFunction
nameSpaceFunction()
::nameSpaceFunction
::nameSpaceFunction()
#nameSpaceFunction
#nameSpaceFunction()
Project::Module1::nameSpaceFunction
Project::Module1::nameSpaceFunction()
::Project::Module1::nameSpaceFunction
::Project::Module1::nameSpaceFunction()
Project#Module1#nameSpaceFunction
Project#Module1#nameSpaceFunction()
#Project#Module1#nameSpaceFunction
#Project#Module1#nameSpaceFunction()
* Links to free functions:
freeFunction
freeFunction()
::freeFunction
::freeFunction()
*/
struct Item {
/// @brief Description
Item() {}
/// @brief Description
~Item() {}
/// @brief Description
void method() {}
};
/// @brief Description
void nameSpaceFunction() {}
}
/// @brief Description
void freeFunction() {}
1. Links to functions inside namespace doesn't seem to work or I missing something.
2. When clang is enabled the comments are interpreted a bit differently and the html output is slightly different.
Thanks