On 6/2/21 6:44 PM, Joseph Myers wrote:
On Wed, 2 Jun 2021, Joel Sherrill wrote:
For RTEMS, we switched from texinfo to Sphinx and the dependency
on Python3 for Sphinx has caused a bit of hassle. Is this going to be
an issue for GCC?
What Sphinx (and, thus, Python) versions does the GCC manual build work
with?
I've just tried version 1.7.6 which we use for libgccjit and it's fine:
https://gcc.gnu.org/onlinedocs/jit/
About Python version: I'm not planning supporting Python2, it's dead 10 years
already.
Can it work with e.g. any Sphinx versions from the past five years,
or are there newer Sphinx features that are critical for the GCC manuals?
The mentioned version is 3 years and I expect even older releases would work.
No, I don't rely on any new feature.
I would recommend testing the build. You can simply clone:
https://github.com/marxin/texi2rst-generated
and simply run 'make html' or 'make latexpdf'. Basic dependencies are mentioned
here:
https://github.com/marxin/texi2rst-generated#requirements
Martin
I've seen a need for frequent Sphinx updates being a pain when building
other software using Sphinx for its manual.
Also we rely on TexLive for PDF output and that's a bit of a pain to
install. Tex was incorrectly packaged on some RHEL/CentOS versions.
This is nothing new, since building PDF manuals from Texinfo sources also
needs TeX.
