From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1NfHM9-0005MD-Pv for qemu-devel@nongnu.org; Wed, 10 Feb 2010 13:32:09 -0500 Received: from [199.232.76.173] (port=49504 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1NfHM9-0005Lx-Bv for qemu-devel@nongnu.org; Wed, 10 Feb 2010 13:32:09 -0500 Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1NfHM8-00019A-Ds for qemu-devel@nongnu.org; Wed, 10 Feb 2010 13:32:09 -0500 Received: from mail-iw0-f194.google.com ([209.85.223.194]:46951) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1NfHM8-000178-3X for qemu-devel@nongnu.org; Wed, 10 Feb 2010 13:32:08 -0500 Received: by mail-iw0-f194.google.com with SMTP id 32so527339iwn.14 for ; Wed, 10 Feb 2010 10:32:07 -0800 (PST) Message-ID: <4B72FBA5.7040306@codemonkey.ws> Date: Wed, 10 Feb 2010 12:32:05 -0600 From: Anthony Liguori MIME-Version: 1.0 Subject: Re: [Qemu-devel] [PATCH] Documentation: Add build support for documentation in pdf format References: <.> <1264803410-18672-1-git-send-email-weil@mail.berlios.de> In-Reply-To: <1264803410-18672-1-git-send-email-weil@mail.berlios.de> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit List-Id: qemu-devel.nongnu.org List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Stefan Weil Cc: QEMU Developers On 01/29/2010 04:16 PM, Stefan Weil wrote: > Makefile already supported dvi, html and info formats, > but pdf was missing. > > pdf is especially convenient for printing and for > documentation reviews. I hope it will help to > improve qemu's documentation. > > Make now supports the new target 'pdf' which will > create qemu-doc.pdf and qemu-tech.pdf. It is also > possible to build both files individually. > > texi2pdf and texi2dvi are rather noisy, so normally > some less important warnings are suppressed. > When make is called with V=1 (verbose mode), > warnings are not suppressed. > > The patch also sorts the documentation targets > alphabetically and wraps a line which was too long. > > Signed-off-by: Stefan Weil > Applied. Thanks. Regards, Anthony Liguori > --- > .gitignore | 1 + > Makefile | 21 +++++++++++++-------- > 2 files changed, 14 insertions(+), 8 deletions(-) > > diff --git a/.gitignore b/.gitignore > index d7d2146..dfc8e5b 100644 > --- a/.gitignore > +++ b/.gitignore > @@ -36,6 +36,7 @@ qemu-monitor.texi > *.fn > *.ky > *.log > +*.pdf > *.pg > *.toc > *.tp > diff --git a/Makefile b/Makefile > index 3848627..692bd75 100644 > --- a/Makefile > +++ b/Makefile > @@ -22,7 +22,7 @@ Makefile: ; > configure: ; > > .PHONY: all clean cscope distclean dvi html info install install-doc \ > - recurse-all speed tar tarbin test build-all > + pdf recurse-all speed tar tarbin test build-all > > $(call set-vpath, $(SRC_PATH):$(SRC_PATH)/hw) > > @@ -160,7 +160,7 @@ distclean: clean > rm -f config-host.mak config-host.h* config-host.ld $(DOCS) qemu-options.texi qemu-img-cmds.texi qemu-monitor.texi > rm -f config-all-devices.mak > rm -f roms/seabios/config.mak roms/vgabios/config.mak > - rm -f qemu-{doc,tech}.{info,aux,cp,dvi,fn,info,ky,log,pg,toc,tp,vr} > + rm -f qemu-{doc,tech}.{info,aux,cp,dvi,fn,info,ky,log,pdf,pg,toc,tp,vr} > for d in $(TARGET_DIRS) libhw32 libhw64 libuser; do \ > rm -rf $$d || exit 1 ; \ > done > @@ -224,14 +224,18 @@ cscope: > cscope -b > > # documentation > +TEXIFLAG=$(if $(V),,--quiet) > +%.dvi: %.texi > + $(call quiet-command,texi2dvi $(TEXIFLAG) -I . $<," GEN $@") > + > %.html: %.texi > $(call quiet-command,texi2html -I=. -monolithic -number $<," GEN $@") > > %.info: %.texi > $(call quiet-command,makeinfo -I . $< -o $@," GEN $@") > > -%.dvi: %.texi > - $(call quiet-command,texi2dvi -I . $<," GEN $@") > +%.pdf: %.texi > + $(call quiet-command,texi2pdf $(TEXIFLAG) -I . $<," GEN $@") > > qemu-options.texi: $(SRC_PATH)/qemu-options.hx > $(call quiet-command,sh $(SRC_PATH)/hxtool -t< $< > $@," GEN $@") > @@ -260,13 +264,14 @@ qemu-nbd.8: qemu-nbd.texi > pod2man --section=8 --center=" " --release=" " qemu-nbd.pod> $@, \ > " GEN $@") > > -info: qemu-doc.info qemu-tech.info > - > dvi: qemu-doc.dvi qemu-tech.dvi > - > html: qemu-doc.html qemu-tech.html > +info: qemu-doc.info qemu-tech.info > +pdf: qemu-doc.pdf qemu-tech.pdf > > -qemu-doc.dvi qemu-doc.html qemu-doc.info: qemu-img.texi qemu-nbd.texi qemu-options.texi qemu-monitor.texi qemu-img-cmds.texi > +qemu-doc.dvi qemu-doc.html qemu-doc.info qemu-doc.pdf: \ > + qemu-img.texi qemu-nbd.texi qemu-options.texi \ > + qemu-monitor.texi qemu-img-cmds.texi > > VERSION ?= $(shell cat VERSION) > FILE = qemu-$(VERSION) >