IGNORE_PREFIX works also on names of functions/methods (Origin: bugzilla #568820)

[doxygen]

status NEW severity normal in component build for ---
Reported in version 1.5.8 on platform Other
Assigned to: Dimitri van Heesch

Original attachment names and IDs:

• DemoSource.cpp (ID 127076)
• Doxyfile (ID 127077)

On 2009-01-23 09:28:43 +0000, Carl R. Werth wrote:

Please describe the problem:
IGNORE_PREFIX is intended to work on class names, so that "CArchive",
"CBlock", "CClock", "CDump", ... will not be put under the same header in
the alphabetical index.
By setting IGNORE_PREFIX to 'C' not only the class names will be stripped
off the leading 'C', but also

Steps to reproduce:
1. Create C++ file with enough functions or enough class member, so that
different sections will be generated in the alphabetical index.
2. All names of the functions/methods must start with the same letter 'C'.
3. Set IGNORE_PREFIX to 'C' and start generation of the HTML documentation.


Actual results:
All the functions/methods in the alphabetical index will be sorted by their
second letter.

Expected results:
Only the classes in the alphabetical index should be sorted be their second
letter. Functions and methods should be sorted by their first letter.

Does this happen every time?
Yes.

Other information:

On 2009-01-23 09:34:07 +0000, Carl R. Werth wrote:

"Please describe the problem" was broken:
IGNORE_PREFIX is intended to work on class names, so that "CArchive",
"CBlock",
"CClock", "CDump", ... will not be put under the same header in the
alphabetical index.
By setting IGNORE_PREFIX to 'C' not only the class names will be stripped
off
the leading 'C', but also the names of functions/methods.
IGNORE_PREFIX should not work on names of functions/methods.

On 2009-01-23 09:47:24 +0000, Carl R. Werth wrote:

Created attachment 127076
C++ file to produce the bug

The C++ file has about 40 function and 5 classes with about 40 methods.
This is enough to generate an alphabetical index which has several sections,
spilt by the leading character of the names of the functions/methods.

On 2009-01-23 09:51:39 +0000, Carl R. Werth wrote:

Created attachment 127077
Configuration file

Doxygen configuration file with IGNORE_PREFIX set to 'C'.
Will work together with the file "DemoSource.cpp", but the "INPUT" has to be
adjusted for meet your particular environment.

[albert-github]

When running the example with doxygen 1.9.5 we see in globals.html:

so under al also an and as are are listed.
We also see:

and here the al, an and as refer all to globals_func.html#index_a.

It looks like that not on all places just the first character is taken (from e.g. al, an and as) or should the second (and with longer strings a longer name!) be taken?

Regarding the original problem probably we need to extend the documentation so it not only mentions classes but also functions, variables, ...
(It has to be investigated whether e.g. namespaces also obey to the IGNORE_PREFIX).

@doxygen what do you think?

[albert-github]

Regarding the al, an, as problem, I've just pushed a proposed patch, pull request #9688

[albert-github]

In the release notes of doxygen version 1.5.2 it is explicitly mentioned as new feature:

IGNORE_PREFIX now also works for function/members names when shown in the various indices.

I've just pushed a proposed patch, pull request #9689

[albert-github]

Code has been integrated in master on GitHub (please don't close the issue as this will be done at the moment of an official release).

[doxygen]

This issue was previously marked 'fixed but not released',
which means it should be fixed in doxygen version 1.9.6.
Please verify if this is indeed the case. Reopen the
issue if you think it is not fixed and please include any additional information
that you think can be relevant (preferably in the form of a self-contained example).