[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Qemu-devel] [PATCH v7 20/21] build-sys: add txt documentation rules
From: |
Markus Armbruster |
Subject: |
Re: [Qemu-devel] [PATCH v7 20/21] build-sys: add txt documentation rules |
Date: |
Thu, 12 Jan 2017 11:09:19 +0100 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/25.1 (gnu/linux) |
Marc-André Lureau <address@hidden> writes:
> 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 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
- [Qemu-devel] [PATCH v7 09/21] qapi: add some sections in docs, (continued)
[Qemu-devel] [PATCH v7 13/21] texi2pod: learn quotation, deftp and deftypefn, Marc-André Lureau, 2017/01/09
[Qemu-devel] [PATCH v7 10/21] docs: add master qapi texi files, Marc-André Lureau, 2017/01/09
[Qemu-devel] [PATCH v7 11/21] qapi: rework qapi Exception, Marc-André Lureau, 2017/01/09
[Qemu-devel] [PATCH v7 20/21] build-sys: add txt documentation rules, Marc-André Lureau, 2017/01/09
- Re: [Qemu-devel] [PATCH v7 20/21] build-sys: add txt documentation rules,
Markus Armbruster <=
[Qemu-devel] [PATCH v7 19/21] build-sys: use a generic TEXI2MAN rule, Marc-André Lureau, 2017/01/09
[Qemu-devel] [PATCH v7 17/21] build-sys: use --no-split for info, Marc-André Lureau, 2017/01/09
[Qemu-devel] [PATCH v7 16/21] docs: add qemu logo to pdf, Marc-André Lureau, 2017/01/09
[Qemu-devel] [PATCH v7 21/21] build-sys: add qapi doc generation targets, Marc-André Lureau, 2017/01/09
[Qemu-devel] [PATCH v7 18/21] build-sys: remove dvi doc generation, Marc-André Lureau, 2017/01/09
[Qemu-devel] [PATCH v7 15/21] qapi: add qapi2texi script, Marc-André Lureau, 2017/01/09