From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from eggs.gnu.org ([2001:4830:134:3::10]:35734)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <peter.maydell@linaro.org>) id 1cTUJG-0001Ip-It
	for qemu-devel@nongnu.org; Tue, 17 Jan 2017 09:00:27 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <peter.maydell@linaro.org>) id 1cTUJB-0000e8-3o
	for qemu-devel@nongnu.org; Tue, 17 Jan 2017 09:00:26 -0500
Received: from mail-ua0-x22c.google.com ([2607:f8b0:400c:c08::22c]:35296)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <peter.maydell@linaro.org>)
	id 1cTUJA-0000du-Rw
	for qemu-devel@nongnu.org; Tue, 17 Jan 2017 09:00:21 -0500
Received: by mail-ua0-x22c.google.com with SMTP id y9so103567470uae.2
	for <qemu-devel@nongnu.org>; Tue, 17 Jan 2017 06:00:20 -0800 (PST)
MIME-Version: 1.0
In-Reply-To: <874m0x7ra2.fsf@dusky.pond.sub.org>
References: <1484559200-2301-1-git-send-email-armbru@redhat.com>
	<CAFEAcA_BBbHeQhWYf_qrL+TwxGT8w34SvUNG_gcNfpNnyaGCzg@mail.gmail.com>
	<87pojmjdep.fsf@dusky.pond.sub.org>
	<CAFEAcA9nhd6x+PT5bG0=YqvmUdxJVFPZ6ACiv-2OKrDFJhrqzg@mail.gmail.com>
	<87h94x99e4.fsf@dusky.pond.sub.org>
	<CAFEAcA8vRw=13Lj_98A+3NovSeTg6e0xBopdz9EcdEeUMjjZow@mail.gmail.com>
	<874m0x7ra2.fsf@dusky.pond.sub.org>
From: Peter Maydell <peter.maydell@linaro.org>
Date: Tue, 17 Jan 2017 13:59:59 +0000
Message-ID: <CAFEAcA_txNPj6JNDavmCREse98XTkQgiFAqx5Vf8KCCu9V-6mQ@mail.gmail.com>
Content-Type: text/plain; charset=UTF-8
Subject: Re: [Qemu-devel] [PULL v2 000/180] QAPI patches for 2017-01-16
List-Id: <qemu-devel.nongnu.org>
List-Unsubscribe: <https://lists.nongnu.org/mailman/options/qemu-devel>,
	<mailto:qemu-devel-request@nongnu.org?subject=unsubscribe>
List-Archive: <http://lists.nongnu.org/archive/html/qemu-devel/>
List-Post: <mailto:qemu-devel@nongnu.org>
List-Help: <mailto:qemu-devel-request@nongnu.org?subject=help>
List-Subscribe: <https://lists.nongnu.org/mailman/listinfo/qemu-devel>,
	<mailto:qemu-devel-request@nongnu.org?subject=subscribe>
To: Markus Armbruster <armbru@redhat.com>
Cc: =?UTF-8?B?TWFyYy1BbmRyw6kgTHVyZWF1?= <mlureau@redhat.com>, QEMU Developers <qemu-devel@nongnu.org>

On 17 January 2017 at 13:24, Markus Armbruster <armbru@redhat.com> wrote:
> Peter Maydell <peter.maydell@linaro.org> writes:
>> (1) if it doesn't actually cause a change in the output, we
>> should either just delete the use of VERSION entirely, or move
>> it to somewhere outside of @subtitle which does actually
>> appear somewhere. There's no point in putting in the version
>> info if it doesn't get into the final output, whether
>> it generates a warning or not.
>
> It does affect PDF output.  PDF is generated by texi2pdf, which uses
> different command line options, and setting VERSION works fine there.

Mmm, but if it's useful information we should be displaying
it in all our documentation formats, not just tucking it
away in something that only appears in the PDF.
Conversely, if we're happy for some of our document formats
not to contain it we could save ourselves the grief of
having to work around this bug by dropping the @subtitle entirely.

As an aside, how useful is the PDF output anyway? In 2017
there seems to me quite a good argument for just creating
HTML...

thanks
-- PMM