Skip to content

man: Upgrade Doxyfile config files with doxygen 1.9.1 #6093

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Jul 21, 2025

Conversation

echoix
Copy link
Member

@echoix echoix commented Jul 20, 2025

Upgrades the doxygen configuration files to doxygen 1.9.1, the version currently used in the server that publishes the programming8 manual.

From https://www.doxygen.nl/manual/doxygen_usage.html:

If you have a configuration file generated with an older version of Doxygen, you can upgrade it to the current version by running Doxygen with the -u option.

doxygen -u <config_file>

All configuration settings in the original configuration file will be copied to the new configuration file. Any new options will have their default value. Note that comments that you may have added in the original configuration file will be lost.

Here are the messages logged in the console during the conversion:

$ doxygen -u include/Make/Doxyfile_arch_html.in
warning: Tag 'TCL_SUBST' at line 203 of file 'include/Make/Doxyfile_arch_html.in' has become obsolete.
         This tag has been removed.
warning: Tag 'COLS_IN_ALPHA_INDEX' at line 879 of file 'include/Make/Doxyfile_arch_html.in' has become obsolete.
         This tag has been removed.
warning: Tag 'PERL_PATH' at line 1593 of file 'include/Make/Doxyfile_arch_html.in' has become obsolete.
         This tag has been removed.
warning: Tag 'MSCGEN_PATH' at line 1614 of file 'include/Make/Doxyfile_arch_html.in' has become obsolete.
         This tag has been removed.


Configuration file 'include/Make/Doxyfile_arch_html.in' updated.

$ doxygen -u include/Make/Doxyfile_arch_latex.in
warning: Tag 'TCL_SUBST' at line 203 of file 'include/Make/Doxyfile_arch_latex.in' has become obsolete.
         This tag has been removed.
warning: Tag 'COLS_IN_ALPHA_INDEX' at line 879 of file 'include/Make/Doxyfile_arch_latex.in' has become obsolete.
         This tag has been removed.
warning: Tag 'PERL_PATH' at line 1593 of file 'include/Make/Doxyfile_arch_latex.in' has become obsolete.
         This tag has been removed.
warning: Tag 'MSCGEN_PATH' at line 1614 of file 'include/Make/Doxyfile_arch_latex.in' has become obsolete.
         This tag has been removed.


Configuration file 'include/Make/Doxyfile_arch_latex.in' updated.

This is independent of #6092, but has been compared with the output of #6092 and an un-filed PR dependant of #6092 that enables the disabled features. Only the version_8h.html and version_8h_source.html where GRASS_HEADERS_VERSION and GRASS_HEADERS_DATE are defined changed.
No other config values were changed here, so further PRs will be very clear and isolated which config changes are made

echoix added 2 commits July 20, 2025 20:39
Using `doxygen -u include/Make/Doxyfile_arch_html.in`

```
warning: Tag 'TCL_SUBST' at line 203 of file 'include/Make/Doxyfile_arch_html.in' has become obsolete.
         This tag has been removed.
warning: Tag 'COLS_IN_ALPHA_INDEX' at line 879 of file 'include/Make/Doxyfile_arch_html.in' has become obsolete.
         This tag has been removed.
warning: Tag 'PERL_PATH' at line 1593 of file 'include/Make/Doxyfile_arch_html.in' has become obsolete.
         This tag has been removed.
warning: Tag 'MSCGEN_PATH' at line 1614 of file 'include/Make/Doxyfile_arch_html.in' has become obsolete.
         This tag has been removed.

Configuration file 'include/Make/Doxyfile_arch_html.in' updated.
```
Using `doxygen -u include/Make/Doxyfile_arch_latex.in`

```
warning: Tag 'TCL_SUBST' at line 203 of file 'include/Make/Doxyfile_arch_latex.in' has become obsolete.
         This tag has been removed.
warning: Tag 'COLS_IN_ALPHA_INDEX' at line 879 of file 'include/Make/Doxyfile_arch_latex.in' has become obsolete.
         This tag has been removed.
warning: Tag 'PERL_PATH' at line 1593 of file 'include/Make/Doxyfile_arch_latex.in' has become obsolete.
         This tag has been removed.
warning: Tag 'MSCGEN_PATH' at line 1614 of file 'include/Make/Doxyfile_arch_latex.in' has become obsolete.
         This tag has been removed.

Configuration file 'include/Make/Doxyfile_arch_latex.in' updated.
```
Copy link
Contributor

@nilason nilason left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Version 1.9.1 was released in 2021 and is supported by most important platforms. This looks good to me.

@echoix echoix merged commit d97d6b7 into OSGeo:main Jul 21, 2025
27 of 28 checks passed
@echoix echoix deleted the doxygen-auto-upgrade-config-file-1.9.1-only branch July 21, 2025 09:06
@github-actions github-actions bot added this to the 8.5.0 milestone Jul 21, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants