Re: RFC: Sphinx for GCC documentation

2021-06-10 Thread Martin Liška
On 6/7/21 4:19 PM, Tobias Burnus wrote: On 07.06.21 15:28, Martin Liška wrote: * I note that we write before the argument index, that those are without -/-- prefix    but that's not true. Something to fix after the conversation. Can you please show me a few examples of it? * https://splicha

Re: RFC: Sphinx for GCC documentation

2021-06-08 Thread Martin Liška
On 6/7/21 11:26 PM, Bernhard Reutner-Fischer wrote: On Mon, 7 Jun 2021 15:30:22 +0200 Martin Liška wrote: Anyway, this is resolved as I use more appropriate directive: https://splichal.eu/scripts/sphinx/gfortran/_build/html/intrinsic-procedures/access-checks-file-access-modes.html ISTM there

Re: RFC: Sphinx for GCC documentation

2021-06-07 Thread Bernhard Reutner-Fischer via Gcc-patches
On Mon, 7 Jun 2021 15:30:22 +0200 Martin Liška wrote: > Anyway, this is resolved as I use more appropriate directive: > https://splichal.eu/scripts/sphinx/gfortran/_build/html/intrinsic-procedures/access-checks-file-access-modes.html ISTM there's a typo s/Tailing/Trailing/ in gcc/fortran/intrins

Re: RFC: Sphinx for GCC documentation

2021-06-07 Thread Tobias Burnus
On 07.06.21 15:28, Martin Liška wrote: * I note that we write before the argument index, that those are without -/-- prefix but that's not true. Something to fix after the conversation. Can you please show me a few examples of it? * https://splichal.eu/scripts/sphinx/gfortran/_build/html

Re: RFC: Sphinx for GCC documentation

2021-06-07 Thread Martin Liška
On 6/4/21 4:24 PM, Koning, Paul wrote: On Jun 4, 2021, at 3:55 AM, Tobias Burnus wrote: Hello, On 13.05.21 13:45, Martin Liška wrote: On 4/1/21 3:30 PM, Martin Liška wrote: That said, I'm asking the GCC community for a green light before I invest more time on it? So far, I've received ju

Re: RFC: Sphinx for GCC documentation

2021-06-07 Thread Martin Liška
On 6/4/21 9:55 AM, Tobias Burnus wrote: Hello, On 13.05.21 13:45, Martin Liška wrote: On 4/1/21 3:30 PM, Martin Liška wrote: That said, I'm asking the GCC community for a green light before I invest more time on it? So far, I've received just a small feedback about the transition. In most cas

Re: RFC: Sphinx for GCC documentation

2021-06-04 Thread Koning, Paul via Gcc-patches
> On Jun 4, 2021, at 3:55 AM, Tobias Burnus wrote: > > Hello, > > On 13.05.21 13:45, Martin Liška wrote: >> On 4/1/21 3:30 PM, Martin Liška wrote: >>> That said, I'm asking the GCC community for a green light before I >>> invest >>> more time on it? >> So far, I've received just a small feedba

Re: RFC: Sphinx for GCC documentation

2021-06-04 Thread Tobias Burnus
Hello, On 13.05.21 13:45, Martin Liška wrote: On 4/1/21 3:30 PM, Martin Liška wrote: That said, I'm asking the GCC community for a green light before I invest more time on it? So far, I've received just a small feedback about the transition. In most cases positive. [1] https://splichal.eu/scr

Re: RFC: Sphinx for GCC documentation

2021-05-13 Thread Martin Liška
On 4/1/21 3:30 PM, Martin Liška wrote: That said, I'm asking the GCC community for a green light before I invest more time on it? Hello. So far, I've received just a small feedback about the transition. In most cases positive. May I understand it as green light for the transition? Thanks, M

Re: RFC: Sphinx for GCC documentation

2021-05-13 Thread Martin Liška
On 4/7/21 7:40 PM, Joseph Myers wrote: On Wed, 7 Apr 2021, Michael Matz wrote: Random snippet for what I mean: the .texi contains: "The @code{access} attribute specifies that a function to whose by-reference arguments the attribute applies accesses the referenced object according to @var{acces

Re: RFC: Sphinx for GCC documentation

2021-04-07 Thread Joseph Myers
On Wed, 7 Apr 2021, Michael Matz wrote: > Random snippet for what I mean: the .texi contains: > > "The @code{access} attribute specifies that a function to whose > by-reference arguments the attribute applies accesses the referenced > object according to @var{access-mode}. The @var{access-mode

Re: RFC: Sphinx for GCC documentation

2021-04-07 Thread Michael Matz
Hello, On Wed, 7 Apr 2021, Martin Liška wrote: > > I like the output quite a bit, especially that things like option > > references are automagically linked to their documentation.  I spent > > just a bit of time looking through the HTML and PDF above and found > > a few minor issues.  I suspect

Re: RFC: Sphinx for GCC documentation

2021-04-07 Thread Martin Liška
On 4/2/21 5:40 PM, Martin Sebor wrote: > On 4/1/21 7:30 AM, Martin Liška wrote: >> Hey. >> >> I've returned to the David's project and I'm willing to finish his >> transition effort. >> I believe using Sphinx documentation can rapidly improve readability, both >> HTML and PDF version, >> of vario

Re: RFC: Sphinx for GCC documentation

2021-04-07 Thread Martin Liška
On 4/1/21 4:31 PM, David Malcolm wrote: > I think some further tweaking of the conversion script is needed first; Sure, I've got a collection of patches and I'm planning to make pull requests. > I'd rather iron out the script rather than play whack-a-mole manually. > I enjoy proofreading conversi

Re: RFC: Sphinx for GCC documentation

2021-04-02 Thread Koning, Paul via Gcc-patches
> On Apr 2, 2021, at 11:40 AM, Martin Sebor via Gcc-patches > wrote: > > ... > I'm not excited about changing tools. I like that Texinfo is a GNU > project; AFACT, Sphinx is not. Why is that important? It's an open source tool, and if it better in interesting ways I don't see why its aff

Re: RFC: Sphinx for GCC documentation

2021-04-02 Thread Martin Sebor via Gcc-patches
On 4/1/21 7:30 AM, Martin Liška wrote: Hey. I've returned to the David's project and I'm willing to finish his transition effort. I believe using Sphinx documentation can rapidly improve readability, both HTML and PDF version, of various GCC manuals ([1]). I've spent some time working on the D

Re: RFC: Sphinx for GCC documentation

2021-04-01 Thread Koning, Paul via Gcc-patches
> On Apr 1, 2021, at 9:30 AM, Martin Liška wrote: > > Hey. > > I've returned to the David's project and I'm willing to finish his transition > effort. > I believe using Sphinx documentation can rapidly improve readability, both > HTML and PDF version, > of various GCC manuals ([1]). I've spe

Re: RFC: Sphinx for GCC documentation

2021-04-01 Thread David Malcolm via Gcc-patches
On Thu, 2021-04-01 at 15:30 +0200, Martin Liška wrote: > Hey. > > I've returned to the David's project and I'm willing to finish his > transition effort. For reference, the original thread about this is in the archives here: https://gcc.gnu.org/pipermail/gcc-patches/2015-November/434055.html >

Re: RFC: Sphinx for GCC documentation

2021-04-01 Thread Marek Polacek via Gcc-patches
On Thu, Apr 01, 2021 at 03:30:10PM +0200, Martin Liška wrote: > Hey. > > I've returned to the David's project and I'm willing to finish his transition > effort. > I believe using Sphinx documentation can rapidly improve readability, both > HTML and PDF version, > of various GCC manuals ([1]). I'

Re: RFC: Sphinx for GCC documentation

2021-04-01 Thread Koning, Paul via Gcc-patches
On Apr 1, 2021, at 9:51 AM, Martin Liška mailto:mli...@suse.cz>> wrote: [EXTERNAL EMAIL] On 4/1/21 3:42 PM, Koning, Paul wrote: Can it provide EPUB or MOBI output? Yes, [1] lists 'epub' as one of the possible "buildername" options. Btw. what Python project do you speak about? Cheers, Marti

Re: RFC: Sphinx for GCC documentation

2021-04-01 Thread Martin Liška
On 4/1/21 3:42 PM, Koning, Paul wrote: > Can it provide EPUB or MOBI output? Yes, [1] lists 'epub' as one of the possible "buildername" options. Btw. what Python project do you speak about? Cheers, Martin [1] https://www.sphinx-doc.org/en/master/man/sphinx-build.html#cmdoption-sphinx-build-b

Re: RFC: Sphinx for GCC documentation

2021-04-01 Thread Koning, Paul via Gcc-patches
Can it provide EPUB or MOBI output? Some of the documentation systems used in various open source products have that capability, and that is very nice to have. I have seen this from the one used by the Python project, for example. Converting other formats to EPUB sometimes works tolerably we