Skip to contentSkip to conversation

Makefile targets for new documentation formats

PATCH In review Stefan Weil 2 participants 2 messages May 14, 2006 Kbuild

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 Makefile targets for new documentation formats

The patch enhances the Makefile with new targets (and ignores these targets and intermediate files for CVS):

make info - create documentation in info format
make dvi - create documentation in dvi format

It also fixes some minor issues in Makefile:

* Missing config-host.mak still allows calling make, e.g. for make distclean.

* Added .PHONY for GNU make.

Regards
Stefan

.cvsignore 14 May 2006 10:42:47 -0000 renamed from .cvsignore 30 Apr 2006 21:33:34 -0000 1.13 +0 -0
diff -u -b -B -u -r1.13 .cvsignore
@@ -11,6 +11,8 @@

ppc-user
qemu-doc.html
qemu-tech.html
+qemu-doc.info
+qemu-tech.info
qemu.1
qemu.pod
qemu-img.1
@@ -25,5 +27,16 @@
mipsel-softmmu
mips-user
mipsel-user
+.gdbinit
sh4-user
sh4-softmmu
+*.aux
+*.cp
+*.dvi
+*.fn
+*.ky
+*.log
+*.pg
+*.toc
+*.tp
+*.vr
Index: Makefile
===================================================================
RCS file: /sources/qemu/qemu/Makefile,v
retrieving revision 1.101

Makefile 14 May 2006 10:42:47 -0000 renamed from Makefile 13 May 2006 16:54:03 -0000 1.101 +5 -1
diff -u -b -B -u -r1.101 Makefile
@@ -1,4 +1,8 @@
-include config-host.mak
+# Makefile for QEMU.
+
+-include config-host.mak
+
+.PHONY:    all clean distclean dvi info install install-doc tar tarbin speed test test2
 

CFLAGS=-Wall -O2 -g -fno-strict-aliasing -I.
ifdef CONFIG_DARWIN
@@ -41,6 +45,8 @@

distclean: clean
rm -f config-host.mak config-host.h $(DOCS)
+ rm -f qemu-doc.{aux,cp,dvi,fn,info,ky,log,pg,toc,tp,vr}
+ rm -f qemu-tech.{aux,cp,dvi,fn,info,ky,log,pg,toc,tp,vr}
for d in $(TARGET_DIRS); do \
rm -rf $$d || exit 1 ; \
done
@@ -97,6 +103,10 @@
%.dvi: %.texi
texi2dvi $<

+info: qemu-doc.info qemu-tech.info
+
+dvi: qemu-doc.dvi qemu-tech.dvi
+
qemu.1: qemu-doc.texi
$(SRC_PATH)/texi2pod.pl $< qemu.pod
pod2man --section=1 --center=" " --release=" " qemu.pod > $@

#1 lore raw
Quoted 10 lines · Stefan Weil

The patch enhances the Makefile with new targets (and ignores these targets and intermediate files for CVS):

make info - create documentation in info format
make dvi - create documentation in dvi format

It also fixes some minor issues in Makefile:

* Missing config-host.mak still allows calling make, e.g. for make distclean.

I consider this to be a feature. Most packages don't even generate a Makefile until after you've run configure.

I've applied the other bits, with the addition of a "html" target.

Paul