From: Zack Weinberg Date: Tue, 19 Dec 2023 21:13:43 +0000 (-0500) Subject: Adjust --help and manpages to make it easier to find the Web manual. X-Git-Tag: v2.72e~2 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=abe8af20476bedf3124bfc9839f6eb8c8aaf7a30;p=thirdparty%2Fautoconf.git 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 5f4a2e5cc..421154aec 100644 --- 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 . -GNU Autoconf home page: . -General help using GNU software: . + +The full documentation for Autoconf can be read via 'info autoconf', +or on the Web at . "; # $VERSION diff --git a/bin/autoheader.in b/bin/autoheader.in index f5af0df2d..6ca60488a 100644 --- 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 . -GNU Autoconf home page: . -General help using GNU software: . + +The full documentation for Autoconf can be read via 'info autoconf', +or on the Web at . "; diff --git a/bin/autom4te.in b/bin/autom4te.in index 2e4e7d522..475221ac1 100644 --- 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 . -GNU Autoconf home page: . -General help using GNU software: . + +The full documentation for Autoconf can be read via 'info autoconf', +or on the Web at . "; # $VERSION diff --git a/bin/autoreconf.in b/bin/autoreconf.in index 285d0f495..98ebab64a 100644 --- 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 . -GNU Autoconf home page: . -General help using GNU software: . + +The full documentation for Autoconf can be read via 'info autoconf', +or on the Web at . "; # $VERSION diff --git a/bin/autoscan.in b/bin/autoscan.in index 4289aafc3..779b7d2d7 100644 --- 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 . -GNU Autoconf home page: . -General help using GNU software: . + +The full documentation for Autoconf can be read via 'info autoconf', +or on the Web at . "; # $version diff --git a/bin/autoupdate.in b/bin/autoupdate.in index 5a71fe760..1ec84f726 100644 --- 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 . -GNU Autoconf home page: . -General help using GNU software: . + +The full documentation for Autoconf can be read via 'info autoconf', +or on the Web at . "; # $VERSION diff --git a/bin/ifnames.in b/bin/ifnames.in index 2626b167b..1d6e36330 100644 --- 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 . -GNU Autoconf home page: . -General help using GNU software: . + +The full documentation for Autoconf can be read via 'info autoconf', +or on the Web at . "; diff --git a/man/common.x b/man/common.x index ea3b237b0..f8dda0f1d 100644 --- 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 .