doxygen-users

[Doxygen-users] Regression in 1.9.5? Or my mistake?

[flap <fb...@oh...>]

Hi all,

ups, second try with a correct email address and new findings...

recently I switched from doxygen-1.8.17 to doxygen-1.9.5. Since I have no clue 
how to search for it in the github bug database I ask first here: Since my 
doxygen update a simple documentation block gets parsed in a strange manner. 
The block is:

/**
 <some text>

 @attention Do not add any path to the *Driver Feature Configuration INI file*
            name. It is always expected in the @ref driver_config_path.
*/

In doxygen-1.8.17 it works and the reference to "driver_config_path" is linked 
correctly in the HTML result. With doxygen-1.9.5 it stops working: instead of 
a link the full filename of the source .dox file is listed in the HTML output.

If I add at least one trailing word, it works again:

/**
 <some text>

 @attention Do not add any path to the *Driver Feature Configuration INI file*
            name. It is always expected in the @ref driver_config_path <word>.
*/

Or:

/**
 <some text>

 @attention Do not add any path to the *Driver Feature Configuration INI file*
            name. It is always expected in the @ref driver_config_path.

 <word>
*/

Is it a known bug?

Cheers
Jürgen

Re: [Doxygen-users] Regression in 1.9.5? Or my mistake?

[flap <fb...@oh...>]

Am Sonntag, 18. September 2022, 15:48:57 CEST I wrote:
> […]
> recently I switched from doxygen-1.8.17 to doxygen-1.9.5. Since I have no
> clue how to search for it in the github bug database I ask first here:
> Since my doxygen update a simple documentation block gets parsed in a
> strange manner. The block is:
> 
> /**
>  <some text>
> 
>  @attention Do not add any path to the *Driver Feature Configuration INI file*
>             name. It is always expected in the @ref driver_config_path.
> */

The corresponding warning message is:

  warning: unable to resolve reference to 'driver_config_path.\ifile' for \ref command

Cheers
Jürgen

Re: [Doxygen-users] Regression in 1.9.5? Or my mistake?

[Andreas T. <an...@st...>]

Am 18.09.2022 um 17:59 schrieb flap:
> Am Sonntag, 18. September 2022, 15:48:57 CEST I wrote:
>> […]
>> recently I switched from doxygen-1.8.17 to doxygen-1.9.5. Since I have no
>> clue how to search for it in the github bug database I ask first here:
>> Since my doxygen update a simple documentation block gets parsed in a
>> strange manner. The block is:
>>
>> /**
>>   <some text>
>>
>>   @attention Do not add any path to the *Driver Feature Configuration INI file*
>>              name. It is always expected in the @ref driver_config_path.
>> */
> 
> The corresponding warning message is:
> 
>    warning: unable to resolve reference to 'driver_config_path.\ifile' for \ref command
> 

I've had a similar problem and it has already been fixed (for next 
version): https://github.com/doxygen/doxygen/issues/9584

Maybe the fix works for your problem too?

But to answer your question: It is not your fault.

Best regards
	Andreas
-- 
       ("`-''-/").___..--''"`-._
        `o_ o  )   `-.  (     ).`-.__.`)
        (_Y_.)'  ._   )  `._ `. ``-..-'
      _..`--'_..-_/  /--'_.' .'
     (il).-''  (li).'  ((!.-'

Andreas Tscharner   an...@st...   ICQ-No. 14356454

Re: [Doxygen-users] Regression in 1.9.5? Or my mistake?

[flap <fb...@oh...>]

Hi Andreas,

Am Montag, 19. September 2022, 13:23:59 CEST schrieb Andreas Tscharner:
> Am 18.09.2022 um 17:59 schrieb flap:
> > Am Sonntag, 18. September 2022, 15:48:57 CEST I wrote:
> >> […]
> >> recently I switched from doxygen-1.8.17 to doxygen-1.9.5. Since I have no
> >> clue how to search for it in the github bug database I ask first here:
> >> Since my doxygen update a simple documentation block gets parsed in a
> >> strange manner. The block is:
> >> 
> >> /**
> >> 
> >>   <some text>
> >>   
> >>   @attention Do not add any path to the *Driver Feature Configuration INI
> >>   file* name. It is always expected in the @ref driver_config_path.
> >> 
> >> */
> > 
> > The corresponding warning message is:
> >    warning: unable to resolve reference to 'driver_config_path.\ifile' for
> >    \ref command
> I've had a similar problem and it has already been fixed (for next
> version): https://github.com/doxygen/doxygen/issues/9584
> 
> Maybe the fix works for your problem too?
> 
> But to answer your question: It is not your fault.

Thanks for clarification. I don't want to build doxygen from source. I will 
wait for the next release and try again.

Cheers,
Jürgen