* [Patch] docs: Honour --{en, dis}able-xend when building docs
@ 2013-12-23 18:47 Andrew Cooper
2014-01-06 15:04 ` Ian Campbell
0 siblings, 1 reply; 3+ messages in thread
From: Andrew Cooper @ 2013-12-23 18:47 UTC (permalink / raw)
To: Xen-devel; +Cc: George Dunlap, Andrew Cooper, Ian Jackson, Ian Campbell
If a user has specified --disable-xend, they wont want the manpages either.
Propagating this parameters requires reorganising the way in which the
makefile chooses which documents to build.
There is now a split of {MAN1,MAN5,MARKDOWN,TXT}SRC-y to select which
documentation to build, which is separate from the patsubst section which
generates appropriate paths to trigger the later rules.
The manpages are quite easy to split between xend, xl and xenstore, and have
been. Items from misc/ are much harder and been left.
Signed-off-by: Andrew Cooper <andrew.cooper3@citrix.com>
CC: Ian Campbell <Ian.Campbell@citrix.com>
CC: Ian Jackson <Ian.Jackson@eu.citrix.com>
CC: George Dunlap <george.dunlap@eu.citrix.com>
--
The configure scripts should be regenerated as part of applying this patch.
George:
I request this gets a release ack for 4.4. It could be argued as a bug in
the current implementation of --disable-xend, and the extent of potential
problems are that I have accidentally missed some of the manpages during
the reorg, but this can be easily confirmed by comparing the results of the
two builds (which I have done).
---
config/Docs.mk.in | 3 +++
docs/Makefile | 38 ++++++++++++++++++++++++--------------
docs/configure.ac | 4 ++++
3 files changed, 31 insertions(+), 14 deletions(-)
diff --git a/config/Docs.mk.in b/config/Docs.mk.in
index a2a72fd..03fac60 100644
--- a/config/Docs.mk.in
+++ b/config/Docs.mk.in
@@ -12,3 +12,6 @@ POD2HTML := @POD2HTML@
POD2TEXT := @POD2TEXT@
MARKDOWN := @MARKDOWN@
PERL := @PERL@
+
+# Subsets of documentation to build
+CONFIG_XEND := @xend@
diff --git a/docs/Makefile b/docs/Makefile
index 8d5d48e..828c059 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -6,20 +6,30 @@ VERSION := $(shell $(MAKE) -C $(XEN_ROOT)/xen --no-print-directory xenversion)
DOC_ARCHES := arm x86_32 x86_64
-DOC_MAN5SRC := $(wildcard man/*.pod.5)
-DOC_MAN1SRC := $(wildcard man/*.pod.1)
-DOC_MAN1 := $(patsubst man/%.pod.1,man1/%.1,$(DOC_MAN1SRC))
-DOC_MAN5 := $(patsubst man/%.pod.5,man5/%.5,$(DOC_MAN5SRC))
-DOC_MARKDOWN := $(wildcard misc/*.markdown)
-DOC_HTML := $(patsubst %.markdown,html/%.html,$(DOC_MARKDOWN)) \
- $(patsubst man/%.pod.1,html/man/%.1.html,$(DOC_MAN1SRC)) \
- $(patsubst man/%.pod.5,html/man/%.5.html,$(DOC_MAN5SRC)) \
- $(patsubst %.txt,html/%.txt,$(wildcard misc/*.txt)) \
- $(patsubst %,html/hypercall/%/index.html,$(DOC_ARCHES))
-DOC_TXT := $(patsubst %.txt,txt/%.txt,$(wildcard misc/*.txt)) \
- $(patsubst %.markdown,txt/%.txt,$(DOC_MARKDOWN)) \
- $(patsubst man/%.pod.1,txt/man/%.1.txt,$(DOC_MAN1SRC)) \
- $(patsubst man/%.pod.5,txt/man/%.5.txt,$(DOC_MAN5SRC))
+# Documentation sources to build
+MAN1SRC-y := $(wildcard man/xl*.pod.1)
+MAN1SRC-y += $(wildcard man/xenstore*.pod.1)
+MAN1SRC-$(CONFIG_XEND) += man/xm.pod.1
+
+MAN5SRC-y := $(wildcard man/xl*.pod.5)
+MAN5SRC-$(CONFIG_XEND) += man/xend-config.sxp.pod.5 man/xmdomain.cfg.pod.5
+
+MARKDOWNSRC-y := $(wildcard misc/*.markdown)
+
+TXTSRC-y := $(wildcard misc/*.txt)
+
+
+DOC_MAN1 := $(patsubst man/%.pod.1,man1/%.1,$(MAN1SRC-y))
+DOC_MAN5 := $(patsubst man/%.pod.5,man5/%.5,$(MAN5SRC-y))
+DOC_HTML := $(patsubst %.markdown,html/%.html,$(MARKDOWN-y)) \
+ $(patsubst man/%.pod.1,html/man/%.1.html,$(MAN1SRC-y)) \
+ $(patsubst man/%.pod.5,html/man/%.5.html,$(MAN5SRC-y)) \
+ $(patsubst %.txt,html/%.txt,$(TXTSRC-y)) \
+ $(patsubst %,html/hypercall/%/index.html,$(DOC_ARCHES))
+DOC_TXT := $(patsubst %.txt,txt/%.txt,$(TXTSRC-y)) \
+ $(patsubst %.markdown,txt/%.txt,$(MARKDOWN-y)) \
+ $(patsubst man/%.pod.1,txt/man/%.1.txt,$(MAN1SRC-y)) \
+ $(patsubst man/%.pod.5,txt/man/%.5.txt,$(MAN5SRC-y))
.PHONY: all
all: build
diff --git a/docs/configure.ac b/docs/configure.ac
index f0ebf00..7e6d1b1 100644
--- a/docs/configure.ac
+++ b/docs/configure.ac
@@ -11,6 +11,7 @@ AC_CONFIG_AUX_DIR([../])
# M4 Macro includes
m4_include([../m4/docs_tool.m4])
m4_include([../m4/path_or_fail.m4])
+m4_include([../m4/features.m4])
AX_DOCS_TOOL_PROG([FIG2DEV], [fig2dev])
AX_DOCS_TOOL_PROG([POD2MAN], [pod2man])
@@ -18,6 +19,9 @@ AX_DOCS_TOOL_PROG([POD2HTML], [pod2html])
AX_DOCS_TOOL_PROG([POD2TEXT], [pod2text])
AX_DOCS_TOOL_PROGS([MARKDOWN], [markdown], [markdown markdown_py])
+# Enable/disable options
+AX_ARG_DEFAULT_DISABLE([xend], [Enable xend toolstack documentation])
+
AC_ARG_VAR([PERL], [Path to Perl parser])
AX_PATH_PROG_OR_FAIL([PERL], [perl])
--
1.7.10.4
^ permalink raw reply related [flat|nested] 3+ messages in thread
* Re: [Patch] docs: Honour --{en, dis}able-xend when building docs
2013-12-23 18:47 [Patch] docs: Honour --{en, dis}able-xend when building docs Andrew Cooper
@ 2014-01-06 15:04 ` Ian Campbell
2014-01-07 13:52 ` Ian Campbell
0 siblings, 1 reply; 3+ messages in thread
From: Ian Campbell @ 2014-01-06 15:04 UTC (permalink / raw)
To: Andrew Cooper; +Cc: George Dunlap, Ian Jackson, Xen-devel
On Mon, 2013-12-23 at 18:47 +0000, Andrew Cooper wrote:
> If a user has specified --disable-xend, they wont want the manpages either.
>
> Propagating this parameters requires reorganising the way in which the
> makefile chooses which documents to build.
>
> There is now a split of {MAN1,MAN5,MARKDOWN,TXT}SRC-y to select which
> documentation to build, which is separate from the patsubst section which
> generates appropriate paths to trigger the later rules.
>
> The manpages are quite easy to split between xend, xl and xenstore, and have
> been. Items from misc/ are much harder and been left.
>
> Signed-off-by: Andrew Cooper <andrew.cooper3@citrix.com>
Acked-by: Ian Campbell <Ian.Campbell@citrix.com>
> CC: Ian Jackson <Ian.Jackson@eu.citrix.com>
> CC: George Dunlap <george.dunlap@eu.citrix.com>
>
> --
>
> The configure scripts should be regenerated as part of applying this patch.
>
> George:
> I request this gets a release ack for 4.4. It could be argued as a bug in
> the current implementation of --disable-xend, and the extent of potential
> problems are that I have accidentally missed some of the manpages during
> the reorg, but this can be easily confirmed by comparing the results of the
> two builds (which I have done).
(as acting RM In George's absence):
I suppose I agree:
Release-Acked-by: Ian Campbell <Ian.Campbell@citrix.com>
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: [Patch] docs: Honour --{en, dis}able-xend when building docs
2014-01-06 15:04 ` Ian Campbell
@ 2014-01-07 13:52 ` Ian Campbell
0 siblings, 0 replies; 3+ messages in thread
From: Ian Campbell @ 2014-01-07 13:52 UTC (permalink / raw)
To: Andrew Cooper; +Cc: George Dunlap, Ian Jackson, Xen-devel
On Mon, 2014-01-06 at 15:04 +0000, Ian Campbell wrote:
> On Mon, 2013-12-23 at 18:47 +0000, Andrew Cooper wrote:
> > If a user has specified --disable-xend, they wont want the manpages either.
> >
> > Propagating this parameters requires reorganising the way in which the
> > makefile chooses which documents to build.
> >
> > There is now a split of {MAN1,MAN5,MARKDOWN,TXT}SRC-y to select which
> > documentation to build, which is separate from the patsubst section which
> > generates appropriate paths to trigger the later rules.
> >
> > The manpages are quite easy to split between xend, xl and xenstore, and have
> > been. Items from misc/ are much harder and been left.
> >
> > Signed-off-by: Andrew Cooper <andrew.cooper3@citrix.com>
>
> Acked-by: Ian Campbell <Ian.Campbell@citrix.com>
>
> > CC: Ian Jackson <Ian.Jackson@eu.citrix.com>
> > CC: George Dunlap <george.dunlap@eu.citrix.com>
> >
> > --
NB only "---" (three dashes) has the affect you were intending here.
Possibly "-- " (two dashes and a space) does too but there was no space
in the above (and I don't know if that syntax works in the context of
git am...)
> > The configure scripts should be regenerated as part of applying this patch.
> >
> > George:
> > I request this gets a release ack for 4.4. It could be argued as a bug in
> > the current implementation of --disable-xend, and the extent of potential
> > problems are that I have accidentally missed some of the manpages during
> > the reorg, but this can be easily confirmed by comparing the results of the
> > two builds (which I have done).
>
> (as acting RM In George's absence):
>
> I suppose I agree:
> Release-Acked-by: Ian Campbell <Ian.Campbell@citrix.com>
With this applied I get the following difference to the set of installed
files. Given this and the fact that too many manpages being installed is
not the worst thing in the world I'm now inclined to say this should
wait for 4.5, since it's obviously not as trivial as it might seem.
--- ../FILE_LIST.BASE 2014-01-07 13:38:03.000000000 +0000
+++ ../FILE_LIST 2014-01-07 13:45:55.000000000 +0000
@@ -988,33 +988,25 @@
dist/install/usr/local/share/doc/xen/html/man/xmdomain.cfg.5.html
dist/install/usr/local/share/doc/xen/html/misc
dist/install/usr/local/share/doc/xen/html/misc/console.txt
-dist/install/usr/local/share/doc/xen/html/misc/coverage.html
dist/install/usr/local/share/doc/xen/html/misc/crashdb.txt
dist/install/usr/local/share/doc/xen/html/misc/distro_mapping.txt
dist/install/usr/local/share/doc/xen/html/misc/dump-core-format.txt
-dist/install/usr/local/share/doc/xen/html/misc/efi.html
dist/install/usr/local/share/doc/xen/html/misc/grant-tables.txt
-dist/install/usr/local/share/doc/xen/html/misc/hvm-emulated-unplug.html
dist/install/usr/local/share/doc/xen/html/misc/index.html
dist/install/usr/local/share/doc/xen/html/misc/kexec_and_kdump.txt
dist/install/usr/local/share/doc/xen/html/misc/libxl_memory.txt
dist/install/usr/local/share/doc/xen/html/misc/pci-device-reservations.txt
dist/install/usr/local/share/doc/xen/html/misc/printk-formats.txt
dist/install/usr/local/share/doc/xen/html/misc/pvh-readme.txt
-dist/install/usr/local/share/doc/xen/html/misc/qemu-upstream_howto_use_it.html
dist/install/usr/local/share/doc/xen/html/misc/sedf_scheduler_mini-HOWTO.txt
dist/install/usr/local/share/doc/xen/html/misc/tscmode.txt
dist/install/usr/local/share/doc/xen/html/misc/vbd-interface.txt
dist/install/usr/local/share/doc/xen/html/misc/vtd.txt
dist/install/usr/local/share/doc/xen/html/misc/vtpm.txt
-dist/install/usr/local/share/doc/xen/html/misc/xen-command-line.html
dist/install/usr/local/share/doc/xen/html/misc/xen-error-handling.txt
dist/install/usr/local/share/doc/xen/html/misc/xenpaging.txt
-dist/install/usr/local/share/doc/xen/html/misc/xenstore-paths.html
dist/install/usr/local/share/doc/xen/html/misc/xenstore.txt
dist/install/usr/local/share/doc/xen/html/misc/xl-disk-configuration.txt
-dist/install/usr/local/share/doc/xen/html/misc/xl-network-configuration.html
-dist/install/usr/local/share/doc/xen/html/misc/xl-numa-placement.html
dist/install/usr/local/share/doc/xen/html/misc/xsm-flask.txt
dist/install/usr/local/share/doc/xen/README.stubdom
dist/install/usr/local/share/doc/xen/README.xenmon
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2014-01-07 13:52 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2013-12-23 18:47 [Patch] docs: Honour --{en, dis}able-xend when building docs Andrew Cooper
2014-01-06 15:04 ` Ian Campbell
2014-01-07 13:52 ` Ian Campbell
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.