Announcement: Porting the Docs to Sphinx - 9. November 2022

[Xi Ruoyao]

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.

Could generated man and info pages be provided as a tarball on
gcc.gnu.org or ftp.gnu.org?