* 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 <[email protected]> --- 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 <[email protected]> + + 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 <[email protected]> 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 pa...@var{variable} +...@evindex ac_pa...@var{variable} This macro was introduced in Autoconf 2.62. If @var{variable} is not empty, then set the cache variable @code{ac_cv_pa...@var{variable}} to its value. Otherwise, check for each program in the blank-separated @@ -15375,7 +15376,7 @@ Shell Substitutions @table @code @item $@@ -...@cindex @samp{"$@@"} +...@cindex @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 $...@{@var{var}:-...@var{value}@} @c Info cannot handle `:' in index entries. @ifnotinfo -...@cindex $...@{@var{var}:-...@var{value}@} +...@cindex @cod...@{@var{var}:-...@var{value}@}} @end ifnotinfo -...@cindex $...@{@var{va...@var{value}@} +...@cindex @cod...@{@var{va...@var{value}@}} Old BSD shells, including the Ultrix @code{sh}, don't accept the colon for any shell substitution, and complain and die. Similarly for $...@{@var{var}:=...@var{value}@}, $...@{@var{var}:?...@var{value}@}, etc. @@ -15463,7 +15464,7 @@ Shell Substitutions use null variable substitution patterns in configure scripts. @item $...@{@var{va...@var{value}@} -...@cindex $...@{@var{va...@var{value}@} +...@cindex @cod...@{@var{va...@var{value}@}} When using @sam...@{@var{va...@var{value}@}} or @sam...@{@var{va...@var{value}@}} 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 $...@{@var{va...@var{value}@} -...@cindex $...@{@var{va...@var{value}@} +...@cindex @cod...@{@var{va...@var{value}@}} When using @sam...@{@var{va...@var{value}@}} 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 $...@{@var{va...@var{value}@} -...@cindex $...@{@var{va...@var{literal}@} +...@cindex @cod...@{@var{va...@var{literal}@}} Solaris @command{/bin/sh} has a frightening bug in its handling of literal assignments. Imagine you need set a variable to a string containing @sa...@}}. This @sa...@}} character confuses Solaris @command{/bin/sh} @@ -15654,7 +15655,7 @@ Shell Substitutions problematic string. @item $...@{@var{va...@var{expanded-value}@} -...@cindex $...@{@var{va...@var{expanded-value}@} +...@cindex @cod...@{@var{va...@var{expanded-value}@}} On Ultrix, running @@ -15722,11 +15723,11 @@ Shell Substitutions @itemx $...@{@var{var...@var{word}@} @itemx $...@{@var{va...@var{word}@} @itemx $...@{@var{var...@var{word}@} -...@cindex $...@{#@var{v...@} -...@cindex $...@{@var{va...@var{word}@} -...@cindex $...@{@var{var...@var{word}@} -...@cindex $...@{@var{va...@var{word}@} -...@cindex $...@{@var{var...@var{word}@} +...@cindex @cod...@{#@var{v...@}} +...@cindex @cod...@{@var{va...@var{word}@}} +...@cindex @cod...@{@var{var...@var{word}@}} +...@cindex @cod...@{@var{va...@var{word}@}} +...@cindex @cod...@{@var{var...@var{word}@}} 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 `...@var{commands}` -...@cindex `...@var{commands}` +...@cindex @cod...@var{commands}`} @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}) -...@cindex $(@var{commands}) +...@cindex @code{$(@var{commands})} This construct is meant to replace @sam...@var{commands}`}, and it has most of the problems listed under @cod...@var{commands}`}. @@ -15836,7 +15837,7 @@ Shell Substitutions @item $((@var{expression})) -...@cindex $((@var{expression})) +...@cindex @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 ^ -...@cindex ^ quoting +...@cindex @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 -...@cindex lib64 +...@cindex @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
