Adjust --help and manpages to make it easier to find the Web manual.

Today it came to my attention that, if you don’t already know that all
the GNU manuals are readable in HTML format on gnu.org, it’s not easy
to find one starting from typical --help output and/or help2man-
generated manpages.  Let’s do a little to make this easier, and have
“https://www.gnu.org/software/autoconf/manual/” appear prominently in
both the --help output and the trailer text of our generated manpages.

This uses the extended tmac.an “.MT” and “.UR” directives, which are
not universal, but I suspect anyone who’s actively using Autoconf on
an old system does not need the advice, and they can get it from
--help regardless.

* bin/autoconf.in, bin/autoheader.in, bin/autom4te.in, bin/autoreconf.in
* bin/autoscan.in, bin/autoupdate.in, bin/ifnames.in:
  Refer specifically to https://www.gnu.org/software/autoconf/manual/
  for the web version of the complete Autoconf manual.
* man/common.x: Likewise; also, suggest the Savannah tracker as
  well as bug-autoconf for bug reports.

diff --git a/bin/autoconf.in b/bin/autoconf.in
index 5f4a2e5cc94404acea66e8710c9d3a17439da31d..421154aec072ec9ad8adaa7a993f95063138a599 100644 (file)
--- a/bin/autoconf.in
+++ b/bin/autoconf.in
@@ -80,8 +80,9 @@ In tracing mode, no configuration script is created.  FORMAT defaults
 to '\$f:\$l:\$n:\$%'; see 'autom4te --help' for information about FORMAT.
 
 Report bugs to <bug-autoconf\@gnu.org>.
-GNU Autoconf home page: <https://www.gnu.org/software/autoconf/>.
-General help using GNU software: <https://www.gnu.org/gethelp/>.
+
+The full documentation for Autoconf can be read via 'info autoconf',
+or on the Web at <https://www.gnu.org/software/autoconf/manual/>.
 ";
 
 # $VERSION

diff --git a/bin/autoheader.in b/bin/autoheader.in
index f5af0df2dfa56b90a1de7a47e92827167f22479b..6ca60488a4bf17f836245558eed813cf69e710b0 100644 (file)
--- a/bin/autoheader.in
+++ b/bin/autoheader.in
@@ -83,8 +83,9 @@ Library directories:
   -I, --include=DIR          append directory DIR to search path
 
 Report bugs to <bug-autoconf\@gnu.org>.
-GNU Autoconf home page: <https://www.gnu.org/software/autoconf/>.
-General help using GNU software: <https://www.gnu.org/gethelp/>.
+
+The full documentation for Autoconf can be read via 'info autoconf',
+or on the Web at <https://www.gnu.org/software/autoconf/manual/>.
 ";
 
 

diff --git a/bin/autom4te.in b/bin/autom4te.in
index 2e4e7d522dc1eb7ee98e031fa8b40f7019a780ff..475221ac187cd35fc7cdee6eceb16f82c88820f4 100644 (file)
--- a/bin/autom4te.in
+++ b/bin/autom4te.in
@@ -202,8 +202,9 @@ SEP can be empty for the default (comma for \@ and *, colon for %),
 a single character for that character, or {STRING} to use a string.
 
 Report bugs to <bug-autoconf\@gnu.org>.
-GNU Autoconf home page: <https://www.gnu.org/software/autoconf/>.
-General help using GNU software: <https://www.gnu.org/gethelp/>.
+
+The full documentation for Autoconf can be read via 'info autoconf',
+or on the Web at <https://www.gnu.org/software/autoconf/manual/>.
 ";
 
 # $VERSION

diff --git a/bin/autoreconf.in b/bin/autoreconf.in
index 285d0f4955e49867c16f3543018fe92ab0872e41..98ebab64a3aaecf6a5e787a045e1579eda781b66 100644 (file)
--- a/bin/autoreconf.in
+++ b/bin/autoreconf.in
@@ -98,8 +98,9 @@ AUTOMAKE, AUTOPOINT, GTKDOCIZE, INTLTOOLIZE, LIBTOOLIZE, M4, MAKE,
 and WARNINGS are honored.
 
 Report bugs to <bug-autoconf\@gnu.org>.
-GNU Autoconf home page: <https://www.gnu.org/software/autoconf/>.
-General help using GNU software: <https://www.gnu.org/gethelp/>.
+
+The full documentation for Autoconf can be read via 'info autoconf',
+or on the Web at <https://www.gnu.org/software/autoconf/manual/>.
 ";
 
 # $VERSION

diff --git a/bin/autoscan.in b/bin/autoscan.in
index 4289aafc390b96d194b1c23b0fc2c4facc40c18d..779b7d2d7aaf7de0eae39c731e1aebda62dca7bf 100644 (file)
--- a/bin/autoscan.in
+++ b/bin/autoscan.in
@@ -120,8 +120,9 @@ Library directories:
   -I, --include=DIR          append directory DIR to search path
 
 Report bugs to <bug-autoconf\@gnu.org>.
-GNU Autoconf home page: <https://www.gnu.org/software/autoconf/>.
-General help using GNU software: <https://www.gnu.org/gethelp/>.
+
+The full documentation for Autoconf can be read via 'info autoconf',
+or on the Web at <https://www.gnu.org/software/autoconf/manual/>.
 ";
 
 # $version

diff --git a/bin/autoupdate.in b/bin/autoupdate.in
index 5a71fe76068cabc5b3aadbccbf2aed9a3fd9f37b..1ec84f7268ae8f6f55aae380be9e57bb310ba165 100644 (file)
--- a/bin/autoupdate.in
+++ b/bin/autoupdate.in
@@ -81,8 +81,9 @@ Library directories:
   -I, --include=DIR          append directory DIR to search path
 
 Report bugs to <bug-autoconf\@gnu.org>.
-GNU Autoconf home page: <https://www.gnu.org/software/autoconf/>.
-General help using GNU software: <https://www.gnu.org/gethelp/>.
+
+The full documentation for Autoconf can be read via 'info autoconf',
+or on the Web at <https://www.gnu.org/software/autoconf/manual/>.
 ";
 
 # $VERSION

diff --git a/bin/ifnames.in b/bin/ifnames.in
index 2626b167b4d472c76abe52c46e6b90edc5fc8a9f..1d6e36330e59ca9bd772eef7a6e134a1c263a667 100644 (file)
--- a/bin/ifnames.in
+++ b/bin/ifnames.in
@@ -63,8 +63,9 @@ space-separated list of the files in which that identifier occurs.
   -V, --version   print version number, then exit
 
 Report bugs to <bug-autoconf\@gnu.org>.
-GNU Autoconf home page: <https://www.gnu.org/software/autoconf/>.
-General help using GNU software: <https://www.gnu.org/gethelp/>.
+
+The full documentation for Autoconf can be read via 'info autoconf',
+or on the Web at <https://www.gnu.org/software/autoconf/manual/>.
 ";
 
 

diff --git a/man/common.x b/man/common.x
index ea3b237b08d0f9c6b9461c258af98145abd354e1..f8dda0f1d7d095d859d2fce44a173b72b2bc1459 100644 (file)
--- a/man/common.x
+++ b/man/common.x
@@ -1,4 +1,12 @@
-[see also]
+[=reporting bugs]
+Report bugs to
+.MT bug-autoconf@gnu.org
+.ME ,
+or via Savannah:
+.UR https://savannah.gnu.org/support/?group=autoconf
+.UE .
+
+[=see also]
 .BR autoconf (1),
 .BR automake (1),
 .BR autoreconf (1),
@@ -9,3 +17,12 @@
 .BR config.sub (1),
 .BR ifnames (1),
 .BR libtool (1).
+
+The full documentation for Autoconf is maintained as a Texinfo manual.
+To read the manual locally, use the command
+.IP
+.B info autoconf
+.PP
+You can also consult the Web version of the manual at
+.UR https://gnu.org/software/autoconf/manual/
+.UE .