[PATCH 1/2] doc: minor indexing update.

[Ralf Wildenhues]

* doc/autoconf.texi (Generic Programs): Add variable index for
ac_path_VARIABLE.
(Shell Substitutions, Site Defaults): Fix markup for indexed
entried, using @code and @file as appropriate.
(M4 Macro Index): Clarify which of the indexed macros have m4_
and which have AS_ prefix.

Signed-off-by: Ralf Wildenhues <address@hidden>
---
 ChangeLog         |   10 ++++++++++
 doc/autoconf.texi |   39 +++++++++++++++++++++------------------
 2 files changed, 31 insertions(+), 18 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 0c3e5d4..a7ff0a5 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,13 @@
+2010-09-05  Ralf Wildenhues  <address@hidden>
+
+       doc: minor indexing update.
+       * doc/autoconf.texi (Generic Programs): Add variable index for
+       ac_path_VARIABLE.
+       (Shell Substitutions, Site Defaults): Fix markup for indexed
+       entried, using @code and @file as appropriate.
+       (M4 Macro Index): Clarify which of the indexed macros have m4_
+       and which have AS_ prefix.
+
 2010-08-30  Eric Blake  <address@hidden>
 
        tests: avoid trashing /
diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 923fff6..0957c91 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -4316,6 +4316,7 @@ Generic Programs
   @ovar{action-if-not-found}, @dvar{path, $PATH})
 @acindex{PATH_PROGS_FEATURE_CHECK}
 @caindex address@hidden
address@hidden address@hidden
 This macro was introduced in Autoconf 2.62.  If @var{variable} is not
 empty, then set the cache variable @address@hidden to
 its value.  Otherwise, check for each program in the blank-separated
@@ -15375,7 +15376,7 @@ Shell Substitutions
 
 @table @code
 @item $@@
address@hidden @samp{"$@@"}
address@hidden @code{"$@@"}
 One of the most famous shell-portability issues is related to
 @samp{"$@@"}.  When there are no positional arguments, Posix says
 that @samp{"$@@"} is supposed to be equivalent to nothing, but the
@@ -15452,9 +15453,9 @@ Shell Substitutions
 @item address@hidden@var{var}:address@hidden@}
 @c Info cannot handle `:' in index entries.
 @ifnotinfo
address@hidden address@hidden@var{var}:address@hidden@}
address@hidden @address@hidden@var{var}:address@hidden@}}
 @end ifnotinfo
address@hidden address@hidden@address@hidden@}
address@hidden @address@hidden@address@hidden@}}
 Old BSD shells, including the Ultrix @code{sh}, don't accept the
 colon for any shell substitution, and complain and die.
 Similarly for address@hidden@var{var}:address@hidden@}, 
address@hidden@var{var}:address@hidden@}, etc.
@@ -15463,7 +15464,7 @@ Shell Substitutions
 use null variable substitution patterns in configure scripts.
 
 @item address@hidden@address@hidden@}
address@hidden address@hidden@address@hidden@}
address@hidden @address@hidden@address@hidden@}}
 When using @address@hidden@address@hidden@}} or
 @address@hidden@address@hidden@}} for providing alternate substitutions,
 @var{value} must either be a single shell word, quoted, or in the
@@ -15537,7 +15538,7 @@ Shell Substitutions
 @end example
 
 @item address@hidden@address@hidden@}
address@hidden address@hidden@address@hidden@}
address@hidden @address@hidden@address@hidden@}}
 When using @address@hidden@address@hidden@}} to assign a default value
 to @var{var}, remember that even though the assignment to @var{var} does
 not undergo file name expansion, the result of the variable expansion
@@ -15627,7 +15628,7 @@ Shell Substitutions
 @end example
 
 @item address@hidden@address@hidden@}
address@hidden address@hidden@address@hidden@}
address@hidden @address@hidden@address@hidden@}}
 Solaris @command{/bin/sh} has a frightening bug in its handling of
 literal assignments.  Imagine you need set a variable to a string containing
 @address@hidden  This @address@hidden character confuses Solaris 
@command{/bin/sh}
@@ -15654,7 +15655,7 @@ Shell Substitutions
 problematic string.
 
 @item address@hidden@address@hidden@}
address@hidden address@hidden@address@hidden@}
address@hidden @address@hidden@address@hidden@}}
 On Ultrix,
 running
 
@@ -15722,11 +15723,11 @@ Shell Substitutions
 @itemx address@hidden@address@hidden@}
 @itemx address@hidden@address@hidden@}
 @itemx address@hidden@address@hidden@}
address@hidden address@hidden@address@hidden
address@hidden address@hidden@address@hidden@}
address@hidden address@hidden@address@hidden@}
address@hidden address@hidden@address@hidden@}
address@hidden address@hidden@address@hidden@}
address@hidden @address@hidden@address@hidden
address@hidden @address@hidden@address@hidden@}}
address@hidden @address@hidden@address@hidden@}}
address@hidden @address@hidden@address@hidden@}}
address@hidden @address@hidden@address@hidden@}}
 Posix requires support for these usages, but they do not work with many
 traditional shells, e.g., Solaris 10 @command{/bin/sh}.
 
@@ -15737,7 +15738,7 @@ Shell Substitutions
 
 
 @item address@hidden
address@hidden address@hidden
address@hidden @address@hidden
 @cindex Command Substitution
 Posix requires shells to trim all trailing newlines from command
 output before substituting it, so assignments like
@@ -15794,7 +15795,7 @@ Shell Substitutions
 @end example
 
 @item $(@var{commands})
address@hidden $(@var{commands})
address@hidden @code{$(@var{commands})}
 This construct is meant to replace @address@hidden,
 and it has most of the problems listed under @address@hidden
 
@@ -15836,7 +15837,7 @@ Shell Substitutions
 
 
 @item $((@var{expression}))
address@hidden $((@var{expression}))
address@hidden @code{$((@var{expression}))}
 Arithmetic expansion is not portable as some shells (most
 notably Solaris 10 @command{/bin/sh}) don't support it.
 
@@ -15881,7 +15882,7 @@ Shell Substitutions
 
 
 @item ^
address@hidden ^ quoting
address@hidden @code{^} quoting
 Always quote @samp{^}, otherwise traditional shells such as
 @command{/bin/sh} on Solaris 10 treat this like @samp{|}.
 
@@ -21601,7 +21602,7 @@ Site Defaults
 fi
 @end example
 
address@hidden lib64
address@hidden @file{lib64}
 @cindex 64-bit libraries
 Likewise, on platforms where 64-bit libraries are built by default, then
 installed in @file{/usr/local/@/lib64} instead of @file{/usr/local/@/lib},
@@ -25511,7 +25512,9 @@ M4 Macro Index
 This is an alphabetical list of the M4, M4sugar, and M4sh macros.
 @ifset shortindexflag
 To make the list easier to use, the macros are listed without their
-preceding @samp{m4_} or @samp{AS_}.
+preceding @samp{m4_} or @samp{AS_}.  The prefix is @samp{m4_} for
+all-lowercase macro names and @samp{AS_} for all-uppercase macro
+names.
 @end ifset
 
 @printindex MS
-- 
1.7.2.1.222.g9988