Re: [PATCH v2 1/2] doc: add texinfodocs and infodocs targets

[Maxim Cournoyer <maxim.cournoyer@gmail.com>]

Hi Jonathan,

Jonathan Corbet <corbet@lwn.net> writes:

> Maxim Cournoyer <maxim.cournoyer@gmail.com> writes:
>
>> Sphinx supports generating Texinfo sources and Info documentation,
>> which can be navigated easily and is convenient to search (via the
>> indexed nodes or anchors, for example).
>>
>> Signed-off-by: Maxim Cournoyer <maxim.cournoyer@gmail.com>
>> ---
>>  Documentation/Makefile                     | 11 +++++++++++
>>  Documentation/userspace-api/media/Makefile |  3 ++-
>>  Makefile                                   |  2 +-
>>  3 files changed, 14 insertions(+), 2 deletions(-)
>
> Wow, I thought that HTML output from Sphinx was slow, but texinfo is
> another thing altogether...

Are their timing really that much different?  Since the .doctrees is
reused, I'd expect the first target to take the most time, the second
one somewhat less.  In my case, I build HTML first and info after, and I
*think* info takes less time, although still takes too long to my taste.
Sadly, setting SPHINXOPTS=jN to attempt some parallelization doesn't
help any.

> Oh well, I guess for some folks it's worth waiting for, so I've applied
> this patch, thanks.n

Thank you!

-- 
Maxim