Marc-André Lureau <marcandre.lur...@redhat.com> writes: > Build plain text documentation, and install it. > > Signed-off-by: Marc-André Lureau <marcandre.lur...@redhat.com> > Reviewed-by: Markus Armbruster <arm...@redhat.com> > --- > .gitignore | 1 + > Makefile | 12 +++++++++--- > 2 files changed, 10 insertions(+), 3 deletions(-) > > diff --git a/.gitignore b/.gitignore > index 6f175b391e..e16bddc070 100644 > --- a/.gitignore > +++ b/.gitignore > @@ -40,6 +40,7 @@ > /qmp-marshal.c > /qemu-doc.html > /qemu-doc.info > +/qemu-doc.txt > /qemu-img > /qemu-nbd > /qemu-options.def > diff --git a/Makefile b/Makefile > index d18bac1c31..37d45ee21b 100644 > --- a/Makefile > +++ b/Makefile > @@ -81,7 +81,7 @@ Makefile: ; > configure: ; > > .PHONY: all clean cscope distclean html info install install-doc \ > - pdf recurse-all speed test dist msi FORCE > + pdf txt recurse-all speed test dist msi FORCE > > $(call set-vpath, $(SRC_PATH)) > > @@ -90,7 +90,7 @@ LIBS+=-lz $(LIBS_TOOLS) > HELPERS-$(CONFIG_LINUX) = qemu-bridge-helper$(EXESUF) > > ifdef BUILD_DOCS > -DOCS=qemu-doc.html qemu.1 qemu-img.1 qemu-nbd.8 qemu-ga.8 > +DOCS=qemu-doc.html qemu-doc.txt qemu.1 qemu-img.1 qemu-nbd.8 qemu-ga.8 > ifdef CONFIG_VIRTFS > DOCS+=fsdev/virtfs-proxy-helper.1 > endif > @@ -431,6 +431,7 @@ endif > install-doc: $(DOCS) > $(INSTALL_DIR) "$(DESTDIR)$(qemu_docdir)" > $(INSTALL_DATA) qemu-doc.html "$(DESTDIR)$(qemu_docdir)" > + $(INSTALL_DATA) qemu-doc.txt "$(DESTDIR)$(qemu_docdir)" > ifdef CONFIG_POSIX > $(INSTALL_DIR) "$(DESTDIR)$(mandir)/man1" > $(INSTALL_DATA) qemu.1 "$(DESTDIR)$(mandir)/man1" > @@ -538,6 +539,10 @@ TEXIFLAG=$(if $(V),,--quiet) > %.info: %.texi > $(call quiet-command,$(MAKEINFO) $(MAKEINFOFLAGS) $< -o $@,"GEN","$@") > > +%.txt: %.texi > + $(call quiet-command,LC_ALL=C $(MAKEINFO) $(MAKEINFOFLAGS) --no-headers > \ > + --plaintext $< -o $@,"GEN $@")
I believe this needs to be "GEN", "$@" now. See commit 0bdb12c. > + > %.pdf: %.texi > $(call quiet-command,texi2pdf $(TEXIFLAG) -I . $<,"GEN","$@") > > @@ -563,6 +568,7 @@ qemu-ga.8: qemu-ga.texi > html: qemu-doc.html > info: qemu-doc.info > pdf: qemu-doc.pdf > +txt: qemu-doc.txt > > qemu-doc.html qemu-doc.info qemu-doc.pdf: \ > qemu-img.texi qemu-nbd.texi qemu-options.texi qemu-option-trace.texi \ > @@ -661,7 +667,7 @@ help: > @echo ' docker - Help about targets running tests inside > Docker containers' > @echo '' > @echo 'Documentation targets:' > - @echo ' html info pdf' > + @echo ' html info pdf txt' > @echo ' - Build documentation in specified format' > @echo '' > ifdef CONFIG_WIN32