mirror/autoconf
2
0
Fork 0
mirror of git://git.sv.gnu.org/autoconf synced 2025-02-17 14:01:27 +08:00
Code Issues Packages Projects Releases Wiki Activity

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

Browse Source 
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.
This commit is contained in:
Zack Weinberg 2023-12-19 16:13:43 -05:00
parent 9800e2e34a
commit abe8af2047
8 changed files with 39 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
bin/autoconf.in
View File

@ -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

5
bin/autoheader.in
View File

@ -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/>.
";

5
bin/autom4te.in
View File

@ -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

5
bin/autoreconf.in
View File

@ -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

5
bin/autoscan.in
View File

@ -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

5
bin/autoupdate.in
View File

@ -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

5
bin/ifnames.in
View File

@ -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/>.
";

19
man/common.x
View File

@ -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 .