summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAdam Spiers <stow@adamspiers.org>2011-12-01 17:25:24 +0000
committerAdam Spiers <stow@adamspiers.org>2011-12-03 01:36:22 +0000
commite1e8175ea57dea4ff243a38efb02340e9f375870 (patch)
tree00911033388de9bafd2f7378dccbe40af657d663
parent4d6c23600b2f92f2d4bb1eba8b952e511670be52 (diff)
downloadstow-e1e8175ea57dea4ff243a38efb02340e9f375870.tar.gz
Switch to renaming to manual via install hook as suggested by Stefano Lattarini
http://article.gmane.org/gmane.comp.sysutils.automake.general/13191
-rw-r--r--MANIFEST2
-rw-r--r--MANIFEST.SKIP2
-rw-r--r--Makefile.am31
3 files changed, 19 insertions, 16 deletions
diff --git a/MANIFEST b/MANIFEST
index 161ff24..a9623e7 100644
--- a/MANIFEST
+++ b/MANIFEST
@@ -14,7 +14,7 @@ configure.ac
COPYING
default-ignore-list
doc/ChangeLog.OLD
-doc/manual.html
+doc/stow.html
doc/stow.8
doc/stow.info
doc/stow.pdf
diff --git a/MANIFEST.SKIP b/MANIFEST.SKIP
index 0d4129d..1caa51c 100644
--- a/MANIFEST.SKIP
+++ b/MANIFEST.SKIP
@@ -78,7 +78,7 @@
^doc/manual.texi$
^doc/manual.pdf$
^doc/HOWTO-RELEASE$
-^doc/stow\.html/.+\.html$
+^doc/manual\.html\b
# Avoid test files
^tmp-testing-trees
diff --git a/Makefile.am b/Makefile.am
index e69e659..484414b 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -5,14 +5,13 @@ info_TEXINFOS = doc/stow.texi
dist_man_MANS = doc/stow.8
dist_doc_DATA = \
README \
- doc/manual.html \
+ doc/stow.html doc/stow.pdf \
ChangeLog doc/ChangeLog.OLD
-doc_DATA = doc/manual.pdf
# Would be nice to include the split page HTML version of the manual
# in the distribution, but automake doesn't support wildcards and I'm
# loathe to explicitly list every single page here :-(
-#nobase_dist_doc_DATA = doc/stow.html/*.html
+#nobase_dist_doc_DATA = doc/manual-split/*.html
pmdir = $(libdir)/perl5
dist_pm_DATA = lib/Stow.pm
@@ -89,7 +88,7 @@ CLEANFILES = $(bin_SCRIPTS) $(dist_pm_DATA)
clean-local:
-rm -rf $(TESTS_OUT) \
bin/stow bin/chkstow doc/stow.8 ChangeLog \
- doc/manual.html doc/manual.pdf
+ doc/stow.html doc/stow.pdf
# this is more explicit and reliable than the config file trick
edit = sed -e 's|[@]PERL[@]|$(PERL)|g' \
@@ -110,19 +109,11 @@ lib/Stow.pm: lib/Stow.pm.in Makefile $(DEFAULT_IGNORE_LIST)
( $(edit) < $<; cat $(DEFAULT_IGNORE_LIST) ) > $@
##############################################################################
-# The below rules are only used by the developer.
+# The below rules should only be needed by developers.
##############################################################################
-# It's conventional to generate $project.info, but it's also nicer to
-# generate manual.html and manual.pdf (which ultimately go somewhere
-# like /usr/share/doc/stow/) rather than stow.html and stow.pdf, to
-# make it obvious that these files contain the manual. So we have to
-# jump through a few extra hoops.
-doc/manual.pdf: doc/stow.pdf
+doc/stow.html: doc/stow.texi
[ -d doc ] || mkdir doc # required in vpath mode
- cp $< $@
-
-doc/manual.html: doc/stow.texi
-rm -f $@
texi2html --P=$(srcdir) --output=$@ -expandinfo -menu -monolithic -verbose $<
@@ -130,6 +121,18 @@ doc/stow.8: bin/stow Makefile
[ -d doc ] || mkdir doc # required in vpath mode
pod2man $< > $@
+# It's conventional to generate $project.info, but it's also nicer to
+# generate manual.html and manual.pdf (which ultimately go somewhere
+# like /usr/share/doc/stow/) rather than stow.html and stow.pdf, to
+# make it obvious that these files contain the manual. So we have to
+# jump through a few extra hoops.
+install-data-hook:
+ cd $(DESTDIR)$(docdir) && \
+ mv -f stow.html manual.html && \
+ mv -f stow.pdf manual.pdf
+
+uninstall-hook:
+ rm -f $(DESTDIR)$(docdir)/manual.{html,pdf}
ChangeLog: doc/ChangeLog.OLD Makefile
@if [ -d .git ]; then \