summaryrefslogtreecommitdiff
path: root/doc/bashref.html
diff options
context:
space:
mode:
authorChet Ramey <chet.ramey@case.edu>2011-12-12 22:01:40 -0500
committerChet Ramey <chet.ramey@case.edu>2011-12-12 22:01:40 -0500
commit7d92f73f39072f1d6888f41c90cd8bb47d28b489 (patch)
tree552c39af6a2042c80ac5bc8e552520334f6d2c7c /doc/bashref.html
parent3d35553ad4469d6c48ee27e87cb8bb3cc3628bb2 (diff)
downloadbash-7d92f73f39072f1d6888f41c90cd8bb47d28b489.tar.gz
commit bash-20100701 snapshot
Diffstat (limited to 'doc/bashref.html')
-rw-r--r--doc/bashref.html31
1 files changed, 23 insertions, 8 deletions
diff --git a/doc/bashref.html b/doc/bashref.html
index a9d26a23..d2f2efd7 100644
--- a/doc/bashref.html
+++ b/doc/bashref.html
@@ -1,6 +1,6 @@
<HTML>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-<!-- Created on June, 7 2010 by texi2html 1.64 -->
+<!-- Created on June, 29 2010 by texi2html 1.64 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -33,10 +33,10 @@ Send bugs and suggestions to <texi2html@mathematik.uni-kl.de>
<H1>Bash Reference Manual</H1></P><P>
This text is a brief description of the features that are present in
-the Bash shell (version 4.1, 30 May 2010).
+the Bash shell (version 4.1, 12 June 2010).
</P><P>
-This is Edition 4.1, last updated 30 May 2010,
+This is Edition 4.1, last updated 12 June 2010,
of <CITE>The GNU Bash Reference Manual</CITE>,
for <CODE>Bash</CODE>, Version 4.1.
</P><P>
@@ -2332,9 +2332,13 @@ If <VAR>length</VAR> is omitted, expands to the substring of
This is referred to as Substring Expansion.
<P>
-<VAR>length</VAR> must evaluate to a number greater than or equal to zero.
If <VAR>offset</VAR> evaluates to a number less than zero, the value
is used as an offset from the end of the value of <VAR>parameter</VAR>.
+If <VAR>length</VAR> evaluates to a number less than zero, and <VAR>parameter</VAR>
+is not <SAMP>`@'</SAMP> and not an indexed or associative array, it is interpreted
+as an offset from the end of the value of <VAR>parameter</VAR> rather than
+a number of characters, and the expansion is the characters between the
+two offsets.
If <VAR>parameter</VAR> is <SAMP>`@'</SAMP>, the result is <VAR>length</VAR> positional
parameters beginning at <VAR>offset</VAR>.
If <VAR>parameter</VAR> is an indexed array name subscripted
@@ -5763,6 +5767,14 @@ string comparison when using the conditional command's &#60; and &#62; operators
and the effect of interrupting a command list.
<P>
+<DT><CODE>compat41</CODE>
+<DD>If set, Bash, when in posix mode, treats a single quote in a double-quoted
+parameter expansion as a special character. The single quotes must match
+(an even number) and the characters between the single quotes are considered
+quoted. This is the behavior of POSIX mode through version 4.1.
+The default Bash behavior remains as in previous versions.
+<P>
+
<DT><CODE>dirspell</CODE>
<DD>If set, Bash
attempts spelling correction on directory names during word completion
@@ -8162,8 +8174,11 @@ using the syntax
</pre></td></tr></table></P><P>
The <VAR>subscript</VAR>
-is treated as an arithmetic expression that must evaluate to a number
-greater than or equal to zero. To explicitly declare an array, use
+is treated as an arithmetic expression that must evaluate to a number.
+If <VAR>subscript</VAR> evaluates to a number less than zero, it is used as
+an offset from one greater than the array's maximum index (so a subcript
+of -1 refers to the last element of the array).
+To explicitly declare an array, use
<TABLE><tr><td>&nbsp;</td><td class=example><pre>declare -a <VAR>name</VAR>
</pre></td></tr></table>The syntax
<TABLE><tr><td>&nbsp;</td><td class=example><pre>declare -a <VAR>name</VAR>[<VAR>subscript</VAR>]
@@ -16312,7 +16327,7 @@ to permit their use in free software.
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="bashref.html#SEC_About"> ? </A>]</TD>
</TR></TABLE>
<H1>About this document</H1>
-This document was generated by <I>Chet Ramey</I> on <I>June, 7 2010</I>
+This document was generated by <I>Chet Ramey</I> on <I>June, 29 2010</I>
using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
"><I>texi2html</I></A>
<P></P>
@@ -16474,7 +16489,7 @@ the following structure:
<BR>
<FONT SIZE="-1">
This document was generated
-by <I>Chet Ramey</I> on <I>June, 7 2010</I>
+by <I>Chet Ramey</I> on <I>June, 29 2010</I>
using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
"><I>texi2html</I></A>