Skip to content

Conversation

@atmyers
Copy link
Member

@atmyers atmyers commented Nov 3, 2025

Summary

Additional background

Checklist

The proposed changes:

  • fix a bug or incorrect behavior in AMReX
  • add new capabilities to AMReX
  • changes answers in the test suite to more than roundoff level
  • are likely to significantly affect the results of downstream AMReX users
  • include documentation in the code and/or rst files, if appropriate

@atmyers atmyers changed the title Catch Sphinx build errors in CI [WIP] Catch Sphinx build errors in CI Nov 3, 2025
@atmyers atmyers changed the title [WIP] Catch Sphinx build errors in CI Catch Sphinx build errors in CI Nov 3, 2025
build_docs.sh Outdated
make SPHINXOPTS='-v -W --keep-going' PYTHON="python3" latexpdf
mv build/latex/amrex.pdf source/
make PYTHON="python3" html &> make_source_html.out
make SPHINXOPTS='-v -W --keep-going' PYTHON="python3" html &> make_source_html.out
Copy link
Member

@WeiqunZhang WeiqunZhang Nov 3, 2025

Choose a reason for hiding this comment

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

I think we should remove &> make_source_html.out so that we can actually see the output and error.

Copy link
Member

Choose a reason for hiding this comment

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

We also need to build html first to treat warnings as errors, if we ignore the warnings from latexpdf. Or we do make clean before make html.

Copy link
Member

Choose a reason for hiding this comment

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

make html was reusing the results of make latexpdf. That was why it did not break.

Copy link
Member Author

Choose a reason for hiding this comment

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

The current code breaks. Now let me fix the table again.

@WeiqunZhang
Copy link
Member

There is rm -rf ../Doxygen/xml in make clean.

@WeiqunZhang WeiqunZhang merged commit 5686ee3 into AMReX-Codes:development Nov 4, 2025
73 checks passed
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