Skip to content
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

Non-existing tags and files reported by Doxygen build #3655

Open
jhlegarreta opened this issue Sep 25, 2022 · 0 comments
Open

Non-existing tags and files reported by Doxygen build #3655

jhlegarreta opened this issue Sep 25, 2022 · 0 comments
Labels
type:Documentation Documentation improvement or change

Comments

@jhlegarreta
Copy link
Member

Description

The ITKDoxygen build is reporting a few non-existing warnings about some tags and files, e.g. in
https://github.com/InsightSoftwareConsortium/ITKDoxygen/actions/runs/3120254526/jobs/5060690356#step:4:1160

warning: Invalid value for 'ALIASES' tag at line 31, file /work/ITK-bld/Utilities/Doxygen/Doxyfile.Documentation: Values in list '"starteraliasnotused=@par not used" "wiki=\par Wiki Examples:<br> ^^ \li <a href="https://www.itk.org/Wiki/ITK/Examples">All Media Wiki Examples</a> ^^" "wikiexample{2}= \li <a href="[https://www.itk.org/Wiki/ITK/Examples/\1](https://www.itk.org/Wiki/ITK/Examples//1)">\2</a> ^^" "endwiki=^^ ^^ ^^" "sphinx=\par ITK Sphinx Examples:<br> ^^ \li <a href="https://itk.org/ITKExamples">All ITK Sphinx Examples</a> ^^" "sphinxexample{2}=\li <a href="[https://itk.org/ITKExamples/src/\1/Documentation.html](https://itk.org/ITKExamples/src//1/Documentation.html)">\2</a> ^^" "endsphinx=^^ ^^ ^^"' are not properly space or comma separated
error: Illegal ALIASES format 'https://www.itk.org/Wiki/ITK/Examples>All Media Wiki Examples</a> ^^'. Use "name=value" or "name{n}=value", where n is the number of arguments
error: Illegal ALIASES format '[https://www.itk.org/Wiki/ITK/Examples/\1](https://www.itk.org/Wiki/ITK/Examples//1)>\2</a> ^^'. Use "name=value" or "name{n}=value", where n is the number of arguments
error: Illegal ALIASES format 'https://itk.org/ITKExamples>All ITK Sphinx Examples</a> ^^'. Use "name=value" or "name{n}=value", where n is the number of arguments
error: Illegal ALIASES format '[https://itk.org/ITKExamples/src/\1/Documentation.html](https://itk.org/ITKExamples/src//1/Documentation.html)>\2</a> ^^'. Use "name=value" or "name{n}=value", where n is the number of arguments

and

warning: tag INPUT: input source '/work/ITK-bld/Documentation/Doxygen' does not exist
warning: tag INPUT: input source '/work/ITK-bld/Documentation/Doxygen/Examples.dox' does not exist

and

Searching for files in directory /work/ITK/Moduleswarning: source '/work/ITK-bld/Documentation/Doxygen' is not a readable file or directory... skipping.
warning: source '/work/ITK-bld/Documentation/Doxygen/Examples.dox' is not a readable file or directory... skipping.

in https://github.com/InsightSoftwareConsortium/ITKDoxygen/actions/runs/3120254526/jobs/5060690356#step:4:2787

Expected information

The Doxygen build should be clean.

Actual information

The groups seem to be present and working as expected in the impacted classes' Doxygen pages, but fixing the warnings is necessary to keep the toolkit healthy and to avoid distractions.

Versions

master

Additional Information

None.

@jhlegarreta jhlegarreta added area:Documentation Issues affecting the Documentation module type:Documentation Documentation improvement or change and removed area:Documentation Issues affecting the Documentation module labels Sep 25, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
type:Documentation Documentation improvement or change
Projects
None yet
Development

No branches or pull requests

1 participant