Skip to content

Doxygen 1.8.13 [Linux ARM64] producing poor output #9427

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

Closed
mnguyenpdftron opened this issue Jun 27, 2022 · 6 comments
Closed

Doxygen 1.8.13 [Linux ARM64] producing poor output #9427

mnguyenpdftron opened this issue Jun 27, 2022 · 6 comments
Labels
HTML HTML / XHTML output Usage The mentioned problem is not a doxygen problem but due to usage of a feature.

Comments

@mnguyenpdftron
Copy link

Doxygen 1.8.13 produces poor output compared to Doxygen 1.8.5.
I attached the two outputs for comparison. I used "GENERATE_HTMLHELP=NO" in both cases. The reason I used Doxygen 1.8.13 because it's for Linux arm64 openjdk:8-jdk-slim-buster.
Any recommendation on how to fix it?
Thanks
Linux_ARM64_Doxygen1.8.13.zip
Linux_x86_64_Doxygen1.8.5.zip

@doxygen
Copy link
Owner

doxygen commented Jun 27, 2022

@mnguyenpdftron without being able to reproduce the problem (since you only provided output and not a way to generated said output), it looks like your project uses a custom HTML header and/or footer which is tailored for 1.8.5, but is no longer compatible with 1.8.13.

Please check your Doxyfile and clear the HTML_HEADER, HTML_FOOTER, and HTML_STYLESHEET options and then try again. If the output works ok, you can try to upgrade the customization.
You can use doxygen -w html header.html footer.html doxygen.sty to generate the defaults file that match your doxygen version and then customize them to match the desired style.

@doxygen doxygen added the Usage The mentioned problem is not a doxygen problem but due to usage of a feature. label Jun 27, 2022
@mnguyenpdftron
Copy link
Author

Thank you very much for your prompt reply. It looks like this is the information that I'm looking for.

@mnguyenpdftron
Copy link
Author

If we'd like to build doxygen 1.8.5 in the arm64 docker (to keep using our current custom header and foot and css), do you think it's feasible?

@albert-github
Copy link
Collaborator

It might be feasible, but the 1.8.5 is build with the qmake tool and not with cmake furthermore it is very old (August 23, 2013). The 1.8.13 is also very old (December 29, 2016) but build with cmake.
The current doxygen version is 1.9.4, so my advise would be invest a little bit of time in updating the header and footer files to the current version (probably best start from scratch with these 2 files and see what you want to change / add).

@mnguyenpdftron
Copy link
Author

Thank you for the feedback!

@albert-github albert-github added the HTML HTML / XHTML output label Jun 30, 2022
@mnguyenpdftron
Copy link
Author

mnguyenpdftron commented Jul 4, 2022

FYI, I was able to build Linux ARM64 executable for 1.8.5.

albert-github added a commit to albert-github/doxygen that referenced this issue Aug 22, 2022
Enhance documentation for filter commands
@doxygen doxygen closed this as completed Aug 26, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
HTML HTML / XHTML output Usage The mentioned problem is not a doxygen problem but due to usage of a feature.
Projects
None yet
Development

No branches or pull requests

3 participants