[SCM] GNU Autoconf source repository branch, master, updated. v2.67-54-gb8e54a3
"Ralf Wildenhues" <[email protected]> Sun, 12 Sep 2010 07:41:36 +0000
| Newsgroups | gmane.comp.sysutils.autoconf.cvs |
|---|---|
| Message-ID | <[email protected]> |
This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "GNU Autoconf source repository".
http://git.sv.gnu.org/gitweb/?p=autoconf.git;a=commitdiff;h=b8e54a39f0827a829f69cb869450efc6d3716084
The branch, master has been updated
via b8e54a39f0827a829f69cb869450efc6d3716084 (commit)
from cd12a7faeaac12c8f55f1a48e56436146be9e3ce (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
commit b8e54a39f0827a829f69cb869450efc6d3716084
Author: Ralf Wildenhues <[email protected]>
Date: Sun Sep 12 09:40:20 2010 +0200
doc: minor indexing update.
(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]>
-----------------------------------------------------------------------
Summary of changes:
ChangeLog | 8 ++++++++
doc/autoconf.texi | 38 ++++++++++++++++++++------------------
2 files changed, 28 insertions(+), 18 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index 0277419..5a2715c 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2010-09-12 Ralf Wildenhues <[email protected]>
+
+ doc: minor indexing update.
+ (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-09-08 Eric Blake <[email protected]>
m4sh: preserve set -vx over re-exec
diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index acc2687..e068ff7 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -15388,7 +15388,7 @@ There are also portability pitfalls with particular expansions:
@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
@@ -15465,9 +15465,9 @@ bad substitution
@item $@{@var{var}:-@var{value}@}
@c Info cannot handle `:' in index entries.
@ifnotinfo
-@cindex $@{@var{var}:-@var{value}@}
+@cindex @code{$@{@var{var}:-@var{value}@}}
@end ifnotinfo
-@cindex $@{@var{var}-@var{value}@}
+@cindex @code{$@{@var{var}-@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.
@@ -15476,7 +15476,7 @@ shell substitution, and since m4sh requires functions, you can portably
use null variable substitution patterns in configure scripts.
@item $@{@var{var}+@var{value}@}
-@cindex $@{@var{var}+@var{value}@}
+@cindex @code{$@{@var{var}+@var{value}@}}
When using @samp{$@{@var{var}-@var{value}@}} or
@samp{$@{@var{var}-@var{value}@}} for providing alternate substitutions,
@var{value} must either be a single shell word, quoted, or in the
@@ -15550,7 +15550,7 @@ b c"'@}\
@end example
@item $@{@var{var}=@var{value}@}
-@cindex $@{@var{var}=@var{value}@}
+@cindex @code{$@{@var{var}=@var{value}@}}
When using @samp{$@{@var{var}=@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
@@ -15640,7 +15640,7 @@ $ @kbd{ksh -c 'x= y=$@{x:=b@} sh -c "echo +\$x+\$y+";echo -$x-'}
@end example
@item $@{@var{var}=@var{value}@}
-@cindex $@{@var{var}=@var{literal}@}
+@cindex @code{$@{@var{var}=@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
@samp{@}}. This @samp{@}} character confuses Solaris @command{/bin/sh}
@@ -15667,7 +15667,7 @@ using double quotes, or when using a temporary variable holding the
problematic string.
@item $@{@var{var}=@var{expanded-value}@}
-@cindex $@{@var{var}=@var{expanded-value}@}
+@cindex @code{$@{@var{var}=@var{expanded-value}@}}
On Ultrix,
running
@@ -15735,11 +15735,11 @@ test "$@{var+set@}" = set || var=@var{@{value@}}
@itemx $@{@var{var}%%@var{word}@}
@itemx $@{@var{var}#@var{word}@}
@itemx $@{@var{var}##@var{word}@}
-@cindex $@{#@var{var}@}
-@cindex $@{@var{var}%@var{word}@}
-@cindex $@{@var{var}%%@var{word}@}
-@cindex $@{@var{var}#@var{word}@}
-@cindex $@{@var{var}##@var{word}@}
+@cindex @code{$@{#@var{var}@}}
+@cindex @code{$@{@var{var}%@var{word}@}}
+@cindex @code{$@{@var{var}%%@var{word}@}}
+@cindex @code{$@{@var{var}#@var{word}@}}
+@cindex @code{$@{@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}.
@@ -15750,7 +15750,7 @@ yields the empty string.
@item `@var{commands}`
-@cindex `@var{commands}`
+@cindex @code{`@var{commands}`}
@cindex Command Substitution
Posix requires shells to trim all trailing newlines from command
output before substituting it, so assignments like
@@ -15807,7 +15807,7 @@ $ @kbd{^C}
@end example
@item $(@var{commands})
-@cindex $(@var{commands})
+@cindex @code{$(@var{commands})}
This construct is meant to replace @samp{`@var{commands}`},
and it has most of the problems listed under @code{`@var{commands}`}.
@@ -15849,7 +15849,7 @@ echo $(case x in x) echo hello;; esac)
@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.
@@ -15894,7 +15894,7 @@ foo=$func_arith_result
@item ^
-@cindex ^ quoting
+@cindex @code{^} quoting
Always quote @samp{^}, otherwise traditional shells such as
@command{/bin/sh} on Solaris 10 treat this like @samp{|}.
@@ -21637,7 +21637,7 @@ if test "$prefix" = /usr; then
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},
@@ -25547,7 +25547,9 @@ preceding @samp{AC_}.
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
hooks/post-receive
--
GNU Autoconf source repository