GCC documentation: porting to Sphinx

[Martin Liška]

On 5/31/21 5:49 PM, Michael Matz wrote:
> Hello Martin,
> 
> On Mon, 31 May 2021, Martin Liška wrote:
> 
>> I've made quite some progress with the porting of the documentation and
>> I would like to present it to the community now:
>> https://splichal.eu/scripts/sphinx/
>>   
>> Note the documentation is automatically ([1]) generated from texinfo with a
>> GitHub workflow ([2]).
> 
> One other thing I was recently thinking about, in the Spinx vs. texinfo
> discussion: locally available documentation browsable/searchable in
> terminal with info(1) (or equivalents).

Yes, that's handy.

> I think the above (i.e.
> generating .rst from the texinfo file) would immediately nullify all my
> worries.  So, just to be extra sure: your proposal now is to generate the
> .rst files, and that .texinfo remains the maintained sources, right?

No, .texinfo files will be gone. However, Sphinx can output to info format:
https://www.sphinx-doc.org/en/master/man/sphinx-build.html#cmdoption-sphinx-build-M

And I've just added the generated Info pages here:
https://splichal.eu/scripts/sphinx/

Hope it helps?
Martin

> 
> 
> Ciao,
> Michael.
>