[pacman-dev] [PATCH 2/2] contrib: Add documentation Makefile

Florian Pritz bluewind at xinu.at
Mon Jul 18 14:28:01 UTC 2016


Makefile.am is mostly copied from ./doc/Makefile.am

Signed-off-by: Florian Pritz <bluewind at xinu.at>
---
 configure.ac              |  1 +
 contrib/Makefile.am       |  6 +++++
 contrib/doc/.gitignore    |  1 +
 contrib/doc/Makefile.am   | 57 +++++++++++++++++++++++++++++++++++++++++++++++
 contrib/doc/asciidoc.conf |  1 +
 contrib/doc/footer.txt    |  1 +
 6 files changed, 67 insertions(+)
 create mode 100644 contrib/doc/.gitignore
 create mode 100644 contrib/doc/Makefile.am
 create mode 120000 contrib/doc/asciidoc.conf
 create mode 120000 contrib/doc/footer.txt

diff --git a/configure.ac b/configure.ac
index dd4ac04..c20d9ba 100644
--- a/configure.ac
+++ b/configure.ac
@@ -520,6 +520,7 @@ test/pacman/tests/Makefile
 test/scripts/Makefile
 test/util/Makefile
 contrib/Makefile
+contrib/doc/Makefile
 Makefile
 ])
 AC_OUTPUT
diff --git a/contrib/Makefile.am b/contrib/Makefile.am
index e34b43e..897cd85 100644
--- a/contrib/Makefile.am
+++ b/contrib/Makefile.am
@@ -1,5 +1,11 @@
 # enforce that all scripts have a --help and --version option
 AUTOMAKE_OPTIONS = std-options
+SUBDIRS=
+if WANT_DOC
+SUBDIRS += doc
+endif
+
+DIST_SUBDIRS = $(SUBDIRS)
 
 bin_SCRIPTS = \
   $(OURSCRIPTS)
diff --git a/contrib/doc/.gitignore b/contrib/doc/.gitignore
new file mode 100644
index 0000000..c5612bc
--- /dev/null
+++ b/contrib/doc/.gitignore
@@ -0,0 +1 @@
+verify-pacman-repo-db.1
diff --git a/contrib/doc/Makefile.am b/contrib/doc/Makefile.am
new file mode 100644
index 0000000..df132d8
--- /dev/null
+++ b/contrib/doc/Makefile.am
@@ -0,0 +1,57 @@
+# We have to do some funny stuff here with the manpages. In order to ensure
+# a dist tarball doesn't get put out there without manpages, we keep those
+# files listed in EXTRA_DIST no matter what. However, we only add them to
+# man_MANS if --enable-asciidoc and/or --enable-doxygen are used.
+
+ASCIIDOC_MANS = \
+	verify-pacman-repo-db.1
+
+EXTRA_DIST = \
+	asciidoc.conf \
+	footer.txt \
+	verify-pacman-repo-db.1.txt \
+	$(ASCIIDOC_MANS)
+
+# Files that should be removed, but which Automake does not know.
+MOSTLYCLEANFILES = $(ASCIIDOC_MANS)
+
+# Ensure manpages are fresh when building a dist tarball
+dist-hook:
+	$(MAKE) $(AM_MAKEFLAGS) clean
+	$(MAKE) $(AM_MAKEFLAGS) all
+
+if USE_GIT_VERSION
+GIT_VERSION := $(shell sh -c 'git describe --abbrev=4 --dirty | sed s/^v//')
+REAL_PACKAGE_VERSION = $(GIT_VERSION)
+else
+REAL_PACKAGE_VERSION = $(PACKAGE_VERSION)
+endif
+
+man_MANS =
+dist_man_MANS = $(ASCIIDOC_MANS)
+
+pkgdatadir = ${datadir}/${PACKAGE}
+
+ASCIIDOC_OPTS = \
+	-f $(srcdir)/asciidoc.conf \
+	-a pacman_version="$(REAL_PACKAGE_VERSION)" \
+	-a pacman_date="`date +%Y-%m-%d`" \
+	-a pkgdatadir=$(pkgdatadir) \
+	-a localstatedir=$(localstatedir) \
+	-a sysconfdir=$(sysconfdir) \
+	-a datarootdir=$(datarootdir)
+
+A2X_OPTS = \
+	--no-xmllint \
+	-d manpage \
+	-f manpage \
+	--xsltproc-opts='-param man.endnotes.list.enabled 0 -param man.endnotes.are.numbered 0'
+
+# These rules are due to the includes and files of the asciidoc text
+$(ASCIIDOC_MANS): asciidoc.conf footer.txt Makefile.am
+	$(AM_V_GEN)a2x $(A2X_OPTS) --asciidoc-opts="$(ASCIIDOC_OPTS) --out-file=./$@" $(srcdir)/$@.txt
+
+# Dependency rules
+verify-pacman-repo-db.1: verify-pacman-repo-db.1.txt
+
+# vim:set noet:
diff --git a/contrib/doc/asciidoc.conf b/contrib/doc/asciidoc.conf
new file mode 120000
index 0000000..ff9653d
--- /dev/null
+++ b/contrib/doc/asciidoc.conf
@@ -0,0 +1 @@
+../../doc/asciidoc.conf
\ No newline at end of file
diff --git a/contrib/doc/footer.txt b/contrib/doc/footer.txt
new file mode 120000
index 0000000..9dd4bae
--- /dev/null
+++ b/contrib/doc/footer.txt
@@ -0,0 +1 @@
+../../doc/footer.txt
\ No newline at end of file
-- 
2.9.0


More information about the pacman-dev mailing list