On 10/20/22 04:26, Xi Ruoyao wrote: > On Mon, 2022-10-17 at 15:28 +0200, Martin Liška wrote: >> Hello. >> >> Based on the very positive feedback I was given at the Cauldron Sphinx >> Documentation BoF, >> I'm planning migrating the documentation on 9th November. There are still >> some minor comments >> from Sandra when it comes to the PDF output, but we can address that once >> the conversion is done. >> >> The reason I'm sending the email now is that I was waiting for latest Sphinx >> release (5.3.0) that >> simplifies reference format for options and results in much simpler Option >> summary section ([1]) >> >> The current GCC master (using Sphinx 5.3.0) converted docs can be seen here: >> https://splichal.eu/scripts/sphinx/ >> >> If you see any issues with the converted documentation, or have a feedback >> about it, >> please reply to this email. > > Ouch. This will be very painful for Linux From Scratch. We'll need to > add 23 Python modules to build the documentation, while we only have 88 > packages in total currently... And we don't want to omit GCC > documentation in our system.
Various other distros will have to face it too. The proper solution is a multi-build package (gcc:doc) which can be built later in the dependency chain. Btw. do you also provide PDF documentation in your system? > > Could generated man and info pages be provided as a tarball on > gcc.gnu.org or ftp.gnu.org? Not planning doing that. Cheers, Martin