Re: texinfo cleanups - $PATH issues

[Eric Blake]

Eric Blake <ebb9 <at> byu.net> writes:

> 
> I'm committing the following, which reduces the number of >80-column lines, 
and 
> avoids all warnings on overfull/underfull hbox (via paragraph rewording) and 
> overfull vbox (via adding index entries, so that indices no longer end too 
> close to a page boundary).  Checked via both 'make info' and 'make pdf'.

And the next independent issue carved out of my AC_PATH_PROGS_FEATURE_CHECK 
patch:

2007-09-06  Eric Blake  <address@hidden>

        * doc/autoconf.texi (Generic Programs): Use $PATH_SEPARATOR, not
        :, and make it clear that optional @var{path} defaults to $PATH.
        (Erlang Compiler and Interpreter): Likewise.


Index: doc/autoconf.texi
===================================================================
RCS file: /sources/autoconf/autoconf/doc/autoconf.texi,v
retrieving revision 1.1167
diff -u -p -r1.1167 autoconf.texi
--- doc/autoconf.texi   6 Sep 2007 15:43:58 -0000       1.1167
+++ doc/autoconf.texi   6 Sep 2007 23:19:06 -0000
@@ -3839,7 +3839,8 @@ instead, like this:
 
 @example
 AC_PATH_PROG([INETD], [inetd], [/usr/libexec/inetd],
-             [$PATH:/usr/libexec:/usr/sbin:/usr/etc:/etc])
+             [$PATH$PATH_SEPARATOR/usr/libexec$PATH_SEPARATOR]dnl
+[/usr/sbin$PATH_SEPARATOR/usr/etc$PATH_SEPARTOR/etc])
 @end example
 
 You are strongly encouraged to declare the @var{variable} passed to
@@ -3847,9 +3848,10 @@ You are strongly encouraged to declare t
 @code{AC_ARG_VAR}, for more details.
 
 @defmac AC_CHECK_PROG (@var{variable}, @var{prog-to-check-for}, @
-  @var{value-if-found}, @ovar{value-if-not-found}, @ovar{path},  @ovar{reject})
+  @var{value-if-found}, @ovar{value-if-not-found}, @dvar{path, $PATH}, @
+  @ovar{reject})
 @acindex{CHECK_PROG}
-Check whether program @var{prog-to-check-for} exists in @env{PATH}.  If
+Check whether program @var{prog-to-check-for} exists in @var{path}.  If
 it is found, set @var{variable} to @var{value-if-found}, otherwise to
 @var{value-if-not-found}, if given.  Always pass over @var{reject} (an
 absolute file name) even if it is the first found in the search path; in
@@ -3860,10 +3862,10 @@ that case, set @var{variable} using the 
 @end defmac
 
 @defmac AC_CHECK_PROGS (@var{variable}, @var{progs-to-check-for}, @
-  @ovar{value-if-not-found}, @ovar{path})
+  @ovar{value-if-not-found}, @dvar{path, $PATH})
 @acindex{CHECK_PROGS}
 Check for each program in the blank-separated list
address@hidden existing in the @env{PATH}.  If one is found, set
address@hidden existing in the @var{path}.  If one is found, set
 @var{variable} to the name of that program.  Otherwise, continue
 checking the next program in the list.  If none of the programs in the
 list are found, set @var{variable} to @var{value-if-not-found}; if
@@ -3872,7 +3874,7 @@ is not changed.  Calls @code{AC_SUBST} f
 @end defmac
 
 @defmac AC_CHECK_TARGET_TOOL (@var{variable}, @var{prog-to-check-for}, @
-  @ovar{value-if-not-found}, @ovar{path})
+  @ovar{value-if-not-found}, @dvar{path, $PATH})
 @acindex{CHECK_TARGET_TOOL}
 Like @code{AC_CHECK_PROG}, but first looks for @var{prog-to-check-for}
 with a prefix of the target type as determined by
@@ -3890,7 +3892,7 @@ uses to produce objects, archives or exe
 @end defmac
 
 @defmac AC_CHECK_TOOL (@var{variable}, @var{prog-to-check-for}, @
-  @ovar{value-if-not-found}, @ovar{path})
+  @ovar{value-if-not-found}, @dvar{path, $PATH})
 @acindex{CHECK_TOOL}
 Like @code{AC_CHECK_PROG}, but first looks for @var{prog-to-check-for}
 with a prefix of the host type as determined by
@@ -3902,8 +3904,8 @@ AC_CHECK_TOOL([RANLIB], [ranlib], [:])
 @end example
 @noindent
 sets @code{RANLIB} to @file{i386-gnu-ranlib} if that program exists in
address@hidden, or otherwise to @samp{ranlib} if that program exists in
address@hidden, or to @samp{:} if neither program exists.
address@hidden, or otherwise to @samp{ranlib} if that program exists in
address@hidden, or to @samp{:} if neither program exists.
 
 In the future, when cross-compiling this macro will @emph{only}
 accept program names that are prefixed with the host type.
@@ -3912,7 +3914,7 @@ system type}.
 @end defmac
 
 @defmac AC_CHECK_TARGET_TOOLS (@var{variable}, @var{progs-to-check-for}, @
-  @ovar{value-if-not-found}, @ovar{path})
+  @ovar{value-if-not-found}, @dvar{path, $PATH})
 @acindex{CHECK_TARGET_TOOLS}
 Like @code{AC_CHECK_TARGET_TOOL}, each of the tools in the list
 @var{progs-to-check-for} are checked with a prefix of the target type as
@@ -3927,7 +3929,7 @@ is not specified, the value of @var{vari
 @end defmac
 
 @defmac AC_CHECK_TOOLS (@var{variable}, @var{progs-to-check-for}, @
-  @ovar{value-if-not-found}, @ovar{path})
+  @ovar{value-if-not-found}, @dvar{path, $PATH})
 @acindex{CHECK_TOOLS}
 Like @code{AC_CHECK_TOOL}, each of the tools in the list
 @var{progs-to-check-for} are checked with a prefix of the host type as
@@ -3944,14 +3946,14 @@ accept program names that are not prefix
 @end defmac
 
 @defmac AC_PATH_PROG (@var{variable}, @var{prog-to-check-for}, @
-  @ovar{value-if-not-found}, @ovar{path})
+  @ovar{value-if-not-found}, @dvar{path, $PATH})
 @acindex{PATH_PROG}
 Like @code{AC_CHECK_PROG}, but set @var{variable} to the absolute
 name of @var{prog-to-check-for} if found.
 @end defmac
 
 @defmac AC_PATH_PROGS (@var{variable}, @var{progs-to-check-for}, @
-  @ovar{value-if-not-found}, @ovar{path})
+  @ovar{value-if-not-found}, @dvar{path, $PATH})
 @acindex{PATH_PROGS}
 Like @code{AC_CHECK_PROGS}, but if any of @var{progs-to-check-for}
 are found, set @var{variable} to the absolute name of the program
@@ -3959,14 +3961,14 @@ found.
 @end defmac
 
 @defmac AC_PATH_TARGET_TOOL (@var{variable}, @var{prog-to-check-for}, @
-  @ovar{value-if-not-found}, @ovar{path})
+  @ovar{value-if-not-found}, @dvar{path, $PATH})
 @acindex{PATH_TARGET_TOOL}
 Like @code{AC_CHECK_TARGET_TOOL}, but set @var{variable} to the absolute
 name of the program if it is found.
 @end defmac
 
 @defmac AC_PATH_TOOL (@var{variable}, @var{prog-to-check-for}, @
-  @ovar{value-if-not-found}, @ovar{path})
+  @ovar{value-if-not-found}, @dvar{path, $PATH})
 @acindex{PATH_TOOL}
 Like @code{AC_CHECK_TOOL}, but set @var{variable} to the absolute
 name of the program if it is found.
@@ -6896,7 +6898,7 @@ preprocessor.  If @samp{$OBJC -E} doesn'
 Autoconf defines the following macros for determining paths to the essential
 Erlang/OTP programs:
 
address@hidden AC_ERLANG_PATH_ERLC (@ovar{value-if-not-found}, @ovar{path})
address@hidden AC_ERLANG_PATH_ERLC (@ovar{value-if-not-found}, @dvar{path, 
$PATH})
 @acindex{ERLANG_PATH_ERLC}
 @ovindex ERLC
 @ovindex ERLCFLAGS
@@ -6915,14 +6917,14 @@ AC_ERLANG_PATH_ERLC([not found], [/usr/l
 @end example
 @end defmac
 
address@hidden AC_ERLANG_NEED_ERLC (@ovar{path})
address@hidden AC_ERLANG_NEED_ERLC (@dvar{path, $PATH})
 @acindex{ERLANG_NEED_ERLC}
 A simplified variant of the @code{AC_ERLANG_PATH_ERLC} macro, that prints an
 error message and exits the @command{configure} script if the @command{erlc}
 program is not found.
 @end defmac
 
address@hidden AC_ERLANG_PATH_ERL (@ovar{value-if-not-found}, @ovar{path})
address@hidden AC_ERLANG_PATH_ERL (@ovar{value-if-not-found}, @dvar{path, 
$PATH})
 @acindex{ERLANG_PATH_ERL}
 @ovindex ERL
 Determine an Erlang interpreter to use.  If @code{ERL} is not already
@@ -6940,7 +6942,7 @@ AC_ERLANG_PATH_ERL([not found], [/usr/li
 @end example
 @end defmac
 
address@hidden AC_ERLANG_NEED_ERL (@ovar{path})
address@hidden AC_ERLANG_NEED_ERL (@dvar{path, $PATH})
 @acindex{ERLANG_NEED_ERL}
 A simplified variant of the @code{AC_ERLANG_PATH_ERL} macro, that prints an
 error message and exits the @command{configure} script if the @command{erl}