[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Qemu-devel] [PATCH v8 20/21] build-sys: add txt documentation rules
From: |
Marc-André Lureau |
Subject: |
[Qemu-devel] [PATCH v8 20/21] build-sys: add txt documentation rules |
Date: |
Fri, 13 Jan 2017 15:41:34 +0100 |
Build plain text documentation, and install it.
Signed-off-by: Marc-André Lureau <address@hidden>
Reviewed-by: Markus Armbruster <address@hidden>
---
.gitignore | 1 +
Makefile | 12 +++++++++---
2 files changed, 10 insertions(+), 3 deletions(-)
diff --git a/.gitignore b/.gitignore
index 3338bdc876..568c4bf9d3 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 4a4a34ed8b..3280da201b 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
@@ -429,6 +429,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"
@@ -536,6 +537,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","$@")
+
%.pdf: %.texi
$(call quiet-command,texi2pdf $(TEXIFLAG) -I . $<,"GEN","$@")
@@ -561,6 +566,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 \
@@ -659,7 +665,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
--
2.11.0
- [Qemu-devel] [PATCH v8 12/21] qapi.py: fix line break before binary operator pep8, (continued)
- [Qemu-devel] [PATCH v8 11/21] qapi: rework qapi Exception, Marc-André Lureau, 2017/01/13
- [Qemu-devel] [PATCH v8 13/21] texi2pod: learn quotation, deftp and deftypefn, Marc-André Lureau, 2017/01/13
- [Qemu-devel] [PATCH v8 17/21] build-sys: use --no-split for info, Marc-André Lureau, 2017/01/13
- [Qemu-devel] [PATCH v8 16/21] docs: add qemu logo to pdf, Marc-André Lureau, 2017/01/13
- [Qemu-devel] [PATCH v8 18/21] build-sys: remove dvi doc generation, Marc-André Lureau, 2017/01/13
- [Qemu-devel] [PATCH v8 19/21] build-sys: use a generic TEXI2MAN rule, Marc-André Lureau, 2017/01/13
- [Qemu-devel] [PATCH v8 20/21] build-sys: add txt documentation rules,
Marc-André Lureau <=
- [Qemu-devel] [PATCH v8 21/21] build-sys: add qapi doc generation targets, Marc-André Lureau, 2017/01/13
- [Qemu-devel] [PATCH v8 15/21] qapi: add qapi2texi script, Marc-André Lureau, 2017/01/13
- [Qemu-devel] [PATCH v8 14/21] (SQUASHED) move doc to schema, Marc-André Lureau, 2017/01/13