3.1.9: build fails

[kloczek]

I'm using doxygen 1.9.7.

cd /home/tkloczko/rpmbuild/BUILD/Imath-3.1.9/x86_64-redhat-linux-gnu/docs/doxygen/man/man3
/bin/mv Imath_Box.3 Imath::Box.3
/bin/mv Imath_Box_ Vec2_ T _ _.3 Imath::Box2.3
/bin/mv Imath_Box_ Vec3_ T _ _.3 Imath::Box3.3
/bin/mv Imath_Color3.3 Imath::Color3.3
/bin/mv Imath_Color4.3 Imath::Color4.3
/bin/mv Imath_Euler.3 Imath::Euler.3
/bin/mv Imath_Frustum.3 Imath::Frustum.3
/bin/mv Imath_FrustumTest.3 Imath::FrustumTest.3
/bin/mv Imath_GLBegin.3 Imath::GLBegin.3
/bin/mv Imath_GLPushAttrib.3 Imath::GLPushAttrib.3
/bin/mv Imath_GLPushMatrix.3 Imath::GLPushMatrix.3
/bin/mv Imath_Interval.3 Imath::Interval.3
/bin/mv Imath_Line3.3 Imath::Line3.3
/bin/mv Imath_Matrix22.3 Imath::Matrix22.3
/bin/mv Imath_Matrix33.3 Imath::Matrix33.3
/bin/mv Imath_Matrix44.3 Imath::Matrix44.3
/bin/mv Imath_Plane3.3 Imath::Plane3.3
/bin/mv Imath_Quat.3 Imath::Quat.3
/bin/mv Imath_Rand32.3 Imath::Rand32.3
/bin/mv Imath_Rand48.3 Imath::Rand48.3
/bin/mv Imath_Shear6.3 Imath::Shear6.3
/bin/mv Imath_Sphere3.3 Imath::Sphere3.3
/bin/mv Imath_Vec2.3 Imath::Vec2.3
/bin/mv Imath_Vec3.3 Imath::Vec3.3
/bin/mv Imath_Vec4.3 Imath::Vec4.3
/bin/mv Imath_half.3 Imath::half.3
[ 56%] Generating documentation with Sphinx
cd /home/tkloczko/rpmbuild/BUILD/Imath-3.1.9/x86_64-redhat-linux-gnu/docs && /usr/bin/sphinx-build -b html -Dbreathe_projects.Imath=/home/tkloczko/rpmbuild/BUILD/Imath-3.1.9/x86_64-redhat-linux-gnu/docs/doxygen/xml /home/tkloczko/rpmbuild/BUILD/Imath-3.1.9/docs /home/tkloczko/rpmbuild/BUILD/Imath-3.1.9/x86_64-redhat-linux-gnu/docs/sphinx
Running Sphinx v6.2.1
making output directory... done

Theme error:
no theme named 'press' found (missing theme.conf?)
gmake[2]: *** [docs/CMakeFiles/docs.dir/build.make:83: docs/sphinx/index.html] Error 2
gmake[2]: Leaving directory '/home/tkloczko/rpmbuild/BUILD/Imath-3.1.9/x86_64-redhat-linux-gnu'
gmake[1]: *** [CMakeFiles/Makefile2:1200: docs/CMakeFiles/docs.dir/all] Error 2
gmake[1]: Leaving directory '/home/tkloczko/rpmbuild/BUILD/Imath-3.1.9/x86_64-redhat-linux-gnu'
gmake: *** [Makefile:149: all] Error 2

[cary-ilm]

You need to install the sphinx press theme: https://pypi.org/project/sphinx-press-theme/

However, the "docs" target builds the website, so unless you are specifically doing something with the website, I'd recommend just disabling the docs.

[kloczek]

To be honest I'm not interested html documentation but man pages (because it is basic any unix documentation format).

Looks like conf.py has no at all extensions = [] entry where this ext should be listed.

[cary-ilm]

There are no man pages for Imath, although that's on the list of things to do.

sphinx-press-theme is listed in docs/requirements.txt, and in the "html_theme" setting in conf.py, but as I understand it, it's a "theme" not an "extension", so I don't think it belongs in the extensions list, but correct me if I'm wrong.

[kloczek]

There are no man pages for Imath, although that's on the list of things to do.

Sphinx allows generate documentation in +10 possible formats.
One of those formats is roff output AKA man page.