Hi,
I was able to encircle the problem. If you run doxygen 1.8.6 on this:
-----------------------------------------------------------------------
/*!
* \mainpage
*
* \section About Welcome
*
* \li \ref Util_BuildSystemTools
*/
/*!
* \page Util Applications + libraries
*
* \li \subpage Util_BuildSystemTools
*/
/*!
* \page Util_BuildSystemTools Build System Tools + CMake
*
* \li \subpage Util_BuildSystemTools_CheatSheet
*
*/
/*!
* \page Util_BuildSystemTools_CheatSheet CMake Cheat sheet
*
* <table>
*
* <tr>
* <th colspan="2">Defining targets</th>
* </tr>
* <tr>
* <td>building libraries</td>
* <td><tt>file(GLOB SRC_FILES src/*.c src/*.cpp)<br/>
* bst_build_libraries("${SRC_FILES}" "${PROJECT_NAME}"
* "${BST_LIBRARIES_SHARED}")</tt></td>
* </tr>
* </table>
*/
-----------------------------------------------------------------------
this error occurs:
example.h:20: warning: unable to resolve reference to
`Util_BuildSystemTools_CheatSheet' for \ref command
The problem seems to be related to the "src/*.c" in the table.
Maybe doxygen gets confused by the /* which looks like a comment start?
However, the same "/*" in a simpler case (without all the \page stuff)
works.
Regards,
Marcus
P.S. And thanks a lot, a lot, and a lot for the great tool :-)
On 01/07/2014 02:30 PM, Dimitri van Heesch wrote:
> Hi Marcus,
>
> The 2 comment blocks with the \page are not marked as special comments so
> doxygen will ignore them. Here is the corrected example:
>
> /*!
> * \mainpage
> *
> * \ref A
> * \ref B
> *
> */
>
> /*!
> * \page A
> * Hello, World!
> *
> */
>
> /*!
> * \page B
> * doxygen rulez!
> *
> */
>
>
> Regards,
> Dimiri
>
> On 07 Jan 2014, at 11:11 , Marcus Stein <marcus.st...@honda-ri.de> wrote:
>
>> Hi @all,
>>
>> the doxygen manual says:
>>
>> "\ref <name> ["(text)"]
>> Creates a reference to a named section, subsection, page or anchor. [...]"
>>
>> This worked fine for me up to 1.8.5 but in 1.8.6 not anymore. Or is there
>> sth. wrong with the following construct?
>>
>>
>> /*!
>> * \mainpage
>> *
>> * \ref A
>> * \ref B
>> *
>> */
>>
>> /*
>> * \page A
>> * Hello, World!
>> *
>> */
>>
>> /*
>> * \page B
>> * doxygen rulez!
>> *
>> */
>>
>>> From 1.8.6 on these errors occur:
>>
>> example.h:4: warning: unable to resolve reference to `A' for \ref command
>> example.h:5: warning: unable to resolve reference to `B' for \ref command
>> example.h:4: warning: unable to resolve reference to `A' for \ref command
>> example.h:5: warning: unable to resolve reference to `B' for \ref command
>>
>>
>> Is this a bug or am I using it wrongly?
>>
>>
>> Thanks in advance,
>> Marcus
>>
>> --
>> Marcus Stein
>>
>> Honda Research Institute Europe GmbH
>> Carl-Legien-Str. 30
>> 63073 Offenbach/Main
>> Germany
>>
>> Phone: +49 (0)69 / 89011-762
>> E-Mail: marcus.st...@honda-ri.de
>>
>> ------------------------------------------------------------------------------
>> Rapidly troubleshoot problems before they affect your business. Most IT
>> organizations don't have a clear picture of how application performance
>> affects their revenue. With AppDynamics, you get 100% visibility into your
>> Java,.NET, & PHP application. Start your 15-day FREE TRIAL of AppDynamics
>> Pro!
>> http://pubads.g.doubleclick.net/gampad/clk?id=84349831&iu=/4140/ostg.clktrk
>> _______________________________________________
>> Doxygen-users mailing list
>> Doxygen-users@lists.sourceforge.net
>> https://lists.sourceforge.net/lists/listinfo/doxygen-users
>
--
Marcus Stein
Honda Research Institute Europe GmbH
Carl-Legien-Str. 30
63073 Offenbach/Main
Germany
Phone: +49 (0)69 / 89011-762
E-Mail: marcus.st...@honda-ri.de
------------------------------------------------------------------------------
Rapidly troubleshoot problems before they affect your business. Most IT
organizations don't have a clear picture of how application performance
affects their revenue. With AppDynamics, you get 100% visibility into your
Java,.NET, & PHP application. Start your 15-day FREE TRIAL of AppDynamics Pro!
http://pubads.g.doubleclick.net/gampad/clk?id=84349831&iu=/4140/ostg.clktrk
_______________________________________________
Doxygen-users mailing list
Doxygen-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users
