build-sys: add txt documentation rules

Build plain text documentation, and install it.

Signed-off-by: Marc-André Lureau <marcandre.lureau@redhat.com>
Reviewed-by: Markus Armbruster <armbru@redhat.com>
Message-Id: <20170113144135.5150-21-marcandre.lureau@redhat.com>
Signed-off-by: Markus Armbruster <armbru@redhat.com>
This commit is contained in:
Marc-André Lureau 2017-01-13 15:41:34 +01:00 committed by Markus Armbruster
parent 76480423a8
commit f8bab10b4c
2 changed files with 10 additions and 3 deletions

1
.gitignore vendored
View File

@ -40,6 +40,7 @@
/qmp-marshal.c /qmp-marshal.c
/qemu-doc.html /qemu-doc.html
/qemu-doc.info /qemu-doc.info
/qemu-doc.txt
/qemu-img /qemu-img
/qemu-nbd /qemu-nbd
/qemu-options.def /qemu-options.def

View File

@ -81,7 +81,7 @@ Makefile: ;
configure: ; configure: ;
.PHONY: all clean cscope distclean html info install install-doc \ .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)) $(call set-vpath, $(SRC_PATH))
@ -90,7 +90,7 @@ LIBS+=-lz $(LIBS_TOOLS)
HELPERS-$(CONFIG_LINUX) = qemu-bridge-helper$(EXESUF) HELPERS-$(CONFIG_LINUX) = qemu-bridge-helper$(EXESUF)
ifdef BUILD_DOCS 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 ifdef CONFIG_VIRTFS
DOCS+=fsdev/virtfs-proxy-helper.1 DOCS+=fsdev/virtfs-proxy-helper.1
endif endif
@ -429,6 +429,7 @@ endif
install-doc: $(DOCS) install-doc: $(DOCS)
$(INSTALL_DIR) "$(DESTDIR)$(qemu_docdir)" $(INSTALL_DIR) "$(DESTDIR)$(qemu_docdir)"
$(INSTALL_DATA) qemu-doc.html "$(DESTDIR)$(qemu_docdir)" $(INSTALL_DATA) qemu-doc.html "$(DESTDIR)$(qemu_docdir)"
$(INSTALL_DATA) qemu-doc.txt "$(DESTDIR)$(qemu_docdir)"
ifdef CONFIG_POSIX ifdef CONFIG_POSIX
$(INSTALL_DIR) "$(DESTDIR)$(mandir)/man1" $(INSTALL_DIR) "$(DESTDIR)$(mandir)/man1"
$(INSTALL_DATA) qemu.1 "$(DESTDIR)$(mandir)/man1" $(INSTALL_DATA) qemu.1 "$(DESTDIR)$(mandir)/man1"
@ -536,6 +537,10 @@ TEXIFLAG=$(if $(V),,--quiet)
%.info: %.texi %.info: %.texi
$(call quiet-command,$(MAKEINFO) $(MAKEINFOFLAGS) $< -o $@,"GEN","$@") $(call quiet-command,$(MAKEINFO) $(MAKEINFOFLAGS) $< -o $@,"GEN","$@")
%.txt: %.texi
$(call quiet-command,LC_ALL=C $(MAKEINFO) $(MAKEINFOFLAGS) --no-headers \
--plaintext $< -o $@,"GEN","$@")
%.pdf: %.texi %.pdf: %.texi
$(call quiet-command,texi2pdf $(TEXIFLAG) -I . $<,"GEN","$@") $(call quiet-command,texi2pdf $(TEXIFLAG) -I . $<,"GEN","$@")
@ -561,6 +566,7 @@ qemu-ga.8: qemu-ga.texi
html: qemu-doc.html html: qemu-doc.html
info: qemu-doc.info info: qemu-doc.info
pdf: qemu-doc.pdf pdf: qemu-doc.pdf
txt: qemu-doc.txt
qemu-doc.html qemu-doc.info qemu-doc.pdf: \ qemu-doc.html qemu-doc.info qemu-doc.pdf: \
qemu-img.texi qemu-nbd.texi qemu-options.texi qemu-option-trace.texi \ qemu-img.texi qemu-nbd.texi qemu-options.texi qemu-option-trace.texi \
@ -659,7 +665,7 @@ help:
@echo ' docker - Help about targets running tests inside Docker containers' @echo ' docker - Help about targets running tests inside Docker containers'
@echo '' @echo ''
@echo 'Documentation targets:' @echo 'Documentation targets:'
@echo ' html info pdf' @echo ' html info pdf txt'
@echo ' - Build documentation in specified format' @echo ' - Build documentation in specified format'
@echo '' @echo ''
ifdef CONFIG_WIN32 ifdef CONFIG_WIN32