qemu-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [PATCH] build: Re-introduce an 'info' target to build a Texinfo manu


From: Peter Maydell
Subject: Re: [PATCH] build: Re-introduce an 'info' target to build a Texinfo manual.
Date: Tue, 19 Mar 2024 11:47:59 +0000

On Mon, 18 Mar 2024 at 03:05, Maxim Cournoyer <maxim.cournoyer@gmail.com> wrote:
>
> This reinstates
> <https://lists.gnu.org/archive/html/qemu-devel/2020-09/msg09228.html>,
> which was committed at some point but reverted many years later in
> cleanups that followed the migration from Texinfo sources to the
> ReStructuredText (RST) format.  It's still nice to leave the option for
> users to easily generate a QEMU manual in the Texinfo format, taking
> advantage of the Sphinx texinfo backend.

As far as I can tell, we never committed that patch, because
(as noted in the discussion there) we don't particularly want
to generate texinfo output (and also because it was missing a
signed-off-by line). So this isn't a regression: we've never
generated info docs since we switched away from texinfo to
rst as our source format.

I don't think my position personally has changed on this one
since your previous patch submission. Other QEMU developers
are welcome to weigh in and disagree with me.

(If we do enable this we might want to see whether we need to
set texinfo_documents in conf.py or if the defaults are OK.)

thanks
-- PMM



reply via email to

[Prev in Thread] Current Thread [Next in Thread]