aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2015-06-01 22:37:54 +0200
committerLudovic Courtès <ludo@gnu.org>2015-06-01 22:37:54 +0200
commit52eca736f6b8fedb7d0cc4dd281059f672d88734 (patch)
tree7b36ffbe55bdc6f69ed9bb2282b26819ab834f3b
parent93e7199b3551729e892255190fdd290ba9feccca (diff)
downloadguix-52eca736f6b8fedb7d0cc4dd281059f672d88734.tar.gz
guix-52eca736f6b8fedb7d0cc4dd281059f672d88734.zip
build: Build and install manual pages.
* configure.ac: Use 'AM_MISSING_PROG' for 'help2man'. * doc.am (subcommand-manual-target, SUBCOMMANDS, dist_man1_MANS): New variables. (doc/guix-$(1).1, doc/guix.1): New targets.
-rw-r--r--configure.ac3
-rw-r--r--doc.am37
2 files changed, 40 insertions, 0 deletions
diff --git a/configure.ac b/configure.ac
index 6979752d16..aea14014f5 100644
--- a/configure.ac
+++ b/configure.ac
@@ -182,6 +182,9 @@ dnl `dot' (from the Graphviz package) is only needed for maintainers.
dnl See `HACKING' for more info.
AM_MISSING_PROG([DOT], [dot])
+dnl Manual pages.
+AM_MISSING_PROG([HELP2MAN], [help2man])
+
AC_CONFIG_FILES([Makefile
po/guix/Makefile.in
po/packages/Makefile.in
diff --git a/doc.am b/doc.am
index df85cfe2b0..f7f4841946 100644
--- a/doc.am
+++ b/doc.am
@@ -65,3 +65,40 @@ DOT_OPTIONS = \
pdf-local: $(top_srcdir)/doc/images/bootstrap-graph.pdf
info-local: $(top_srcdir)/doc/images/bootstrap-graph.png
ps-local: $(top_srcdir)/doc/images/bootstrap-graph.eps
+
+
+# Manual pages.
+
+doc/guix.1: $(top_builddir)/scripts/guix
+ -LANGUAGE= $(top_builddir)/pre-inst-env \
+ $(HELP2MAN) --output="$@" guix
+
+define subcommand-manual-target
+
+doc/guix-$(1).1: $(top_srcdir)/guix/scripts/$(1).scm
+ -LANGUAGE= $(top_builddir)/pre-inst-env \
+ $(HELP2MAN) --output="$$@" "guix $(1)"
+
+endef
+
+SUBCOMMANDS := \
+ archive \
+ build \
+ download \
+ environment \
+ gc \
+ hash \
+ import \
+ lint \
+ package \
+ publish \
+ pull \
+ refresh \
+ system
+
+$(eval $(foreach subcommand,$(SUBCOMMANDS), \
+ $(call subcommand-manual-target,$(subcommand))))
+
+dist_man1_MANS = \
+ doc/guix.1 \
+ $(SUBCOMMANDS:%=doc/guix-%.1)