Man pages for automake and aclocal.

[Ralf Wildenhues]

While adding man pages to Libtool, let's do it for Automake, too.
I hope letting the unversioned man pages be .so links helps distributors
sort out versioning issues.

Cheers,
Ralf

    Man pages for automake and aclocal.
    
    * configure.ac (HELP2MAN): New substitution.
    * doc/Makefile.am (dist_man1_MANS, MAINTAINERCLEANFILES)
    (update_mans): New macros.
    ($(srcdir)/aclocal-$(APIVERSION).1)
    ($(srcdir)/automake-$(APIVERSION).1): New rules, generate
    man pages from the command line help with help2man.
    ($(srcdir)/aclocal.1, $(srcdir)/automake.1): New rules, for
    `.so' man page links to the versioned pages.
    * NEWS: Update.
    
    Signed-off-by: Ralf Wildenhues <address@hidden>

diff --git a/NEWS b/NEWS
index a2b336e..dac6a9e 100644
--- a/NEWS
+++ b/NEWS
@@ -43,6 +43,8 @@ New in 1.10a:
     Note that Automake will never overwrite an existing COPYING file,
     even when the `--force-missing' option is used.
 
+  - Automake ships and install man pages for automake and aclocal now.
+
   - New shorthand `$(pkglibexecdir)' for `$(libexecdir)/@PACKAGE@'.
 
   - install-sh supports -C, which does not update the installed file
diff --git a/configure.ac b/configure.ac
index 08e9f41..a21bfb2 100644
--- a/configure.ac
+++ b/configure.ac
@@ -63,6 +63,9 @@ installed, select the one Automake should use using
 # The test suite will skip some tests if tex is absent.
 AC_CHECK_PROG([TEX], [tex], [tex])
 
+# Generate man pages.
+AM_MISSING_PROG([HELP2MAN], [help2man])
+
 # Test for Autoconf.  We run Autoconf in a subdirectory to ease
 # deletion of any files created (such as those added to
 # autom4te.cache).  We used to perform only the last of the three
diff --git a/doc/Makefile.am b/doc/Makefile.am
index 11e86e7..c6d200f 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -2,7 +2,7 @@
 
 ## Makefile for Automake.
 
-## Copyright (C) 2003, 2006  Free Software Foundation, Inc.
+## Copyright (C) 2003, 2006, 2008  Free Software Foundation, Inc.
 
 ## This program is free software; you can redistribute it and/or modify
 ## it under the terms of the GNU General Public License as published by
@@ -20,6 +20,24 @@
 info_TEXINFOS = automake.texi
 automake_TEXINFOS = fdl.texi
 
+dist_man1_MANS = \
+  $(srcdir)/aclocal.1 \
+  $(srcdir)/automake.1 \
+  $(srcdir)/aclocal-$(APIVERSION).1 \
+  $(srcdir)/automake-$(APIVERSION).1
+MAINTAINERCLEANFILES = $(dist_man1_MANS)
+update_mans = \
+  PATH=..$(PATH_SEPARATOR)$$PATH; export PATH; \
+  $(HELP2MAN) --output=$@
+$(dist_man1_MANS): $(top_srcdir)/configure.ac
+$(srcdir)/aclocal.1 $(srcdir)/automake.1:
+       f=`echo $@ | sed 's|.*/||; s|\.1$$||; $(transform)'`; \
+       echo ".so man1/$$f-$(APIVERSION).1" > $@
+$(srcdir)/aclocal-$(APIVERSION).1: $(srcdir)/../aclocal.in
+       $(update_mans) aclocal
+$(srcdir)/automake-$(APIVERSION).1: $(srcdir)/../automake.in
+       $(update_mans) automake
+
 # The following requires a fixed version of the Emacs 19.30 etags.
 ETAGS_ARGS = --lang=none \
  --regex='/address@hidden \t]+\([^,]+\)/\1/' $(srcdir)/automake.texi