Re: [Doxygen-users] Doxygen confused between a member method and a local variable which have the same name

[Ron W <ron...@gm...>]

On Mon, Aug 29, 2022 at 7:04 AM <dox...@li...>
wrote:

> Date: Mon, 29 Aug 2022 10:45:22 +0000
> From: ericruan(???) <eri...@fu...>
> Subject: [Doxygen-users] Doxygen confused between a member method and
>         a local variable which have the same name
>
[...]

> The class graphs seems okay but there is a mistake in called by graph. In
> onStart method it has a reference to start which should be detected as a
> reference to the local variable start but doxygen detected it as a
> reference to a method named start which is a member method to it?s
> superclass. Is this a bug of doxygen or it?s some setting that can cause it?
>

It might be a design limitation of Doxygen. Even in languages that allow a
symbol with local scope to override a symbol in a surrounding scope, it is
not good practice to do so.

If you are documenting legacy code, is the onStart method only
referencing the local variable, or is it also referencing the super-class'
start method?

If only referencing the local variable, then a simple filter script could
add a prefix or suffix to the variable name.

If referencing both, a filter would need to discriminate between a variable
access and a method call. Presumably the compiler already does this.