From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1NbxlI-0003wO-Ge for qemu-devel@nongnu.org; Mon, 01 Feb 2010 10:00:24 -0500 Received: from [199.232.76.173] (port=48946 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1NbxlI-0003wA-40 for qemu-devel@nongnu.org; Mon, 01 Feb 2010 10:00:24 -0500 Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1Nbxky-0006lV-Tq for qemu-devel@nongnu.org; Mon, 01 Feb 2010 10:00:23 -0500 Received: from mail-fx0-f222.google.com ([209.85.220.222]:36016) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1Nbxky-0006ks-Il for qemu-devel@nongnu.org; Mon, 01 Feb 2010 10:00:04 -0500 Received: by fxm22 with SMTP id 22so1304714fxm.2 for ; Mon, 01 Feb 2010 06:59:58 -0800 (PST) MIME-Version: 1.0 In-Reply-To: <4B66AB52.3090200@mail.berlios.de> References: <4B66AB52.3090200@mail.berlios.de> Date: Mon, 1 Feb 2010 15:59:58 +0100 Message-ID: Subject: Re: [Qemu-devel] [PATCH] Build and install more documentation formats From: Dirk Ullrich Content-Type: text/plain; charset=ISO-8859-1 List-Id: qemu-devel.nongnu.org List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Stefan Weil Cc: qemu-devel@nongnu.org Hi Stefan, 2010/2/1 Stefan Weil : > Dirk Ullrich schrieb: >> Hi, >> >> I have patched QEMU's "configure" script and its main makefile: Now >> QEMU's documentation is also created in PDF format (using "texi2pdf"), >> and the targets "install-all-doc" / "install-all" install >> documentation in INFO and PDF format, too. May be others find this >> feature useful. >> >> Dirk >> >> For response please CC me since I am no "qemu-devel" subscriber (yet). [...] > Hi Dirk, > > there is already a patch which adds pdf support: > http://lists.gnu.org/archive/html/qemu-devel/2010-01/msg02076.html > is waiting for a commit. This former patch is less noisy > by default when pdf (or dvi) files are build. Sorry, I did not note that. Comparing with your patch the part of mine that generates the PDF is more like a quick hack. > The @direntry part of your patch for qemu-*.texi is new. > If you want to get it included in the official qemu, > you should send it as a signed git patch (works best > with git send-email). Yes, I will do this (at least). > > I don't know whether extended install targets are needed. > Personally, I did not miss them because I never use any > of the existing install targets. But I missed them a lot, since I like INFO format (very convenient from within Emacs) and (hyperlinked) PDF format (often nicer to read than HTML - especially when creted by TeX) for documentation a lot. So I want those formats automatically installed if available, and do not like to copy those files by hand. But since there may be reasons not to automatically install INFO or PDF (not to use INFO files, no TeX installed to create the PDF, ...) documentation I've created the additional install targets for make. > > Regards, > Stefan > Dirk