From: Chet Ramey Date: Sat, 3 Dec 2011 18:43:32 +0000 (-0500) Subject: commit bash-20050217 snapshot X-Git-Tag: bash-3.1-alpha~20 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=2206f89ab425e2b10a68edac5dd749c1541c9694;p=thirdparty%2Fbash.git commit bash-20050217 snapshot --- diff --git a/CWRU/CWRU.chlog b/CWRU/CWRU.chlog index 0a73ecf0d..757113801 100644 --- a/CWRU/CWRU.chlog +++ b/CWRU/CWRU.chlog @@ -11063,3 +11063,54 @@ variables.c doc/{bashref.texi,bash.1} - a couple of clarifying changes to the description of $_ based on comments from Glenn Morris + + 2/15 + ---- +shell.c + - use strstr instead of strmatch when checking whether $EMACS contains + `term' -- simpler and faster + + 2/18 + ---- +builtins/cd.def + - implement posix requirement that `pwd -P' set $PWD to a directory + name containing no symlinks + - add new function, setpwd(), just sets (and changes exported value) + of PWD + +doc/bashref.texi + - add note to posix mode section about pwd -P setting $PWD + +doc{bash.1,bashref.texi} + - added note that BASH_ARGC and BASH_ARGV are only set in extended + debug mode + - expand description of extdebug option to include everything changed + by extended debug mode + + 2/19 + ---- +pathexp.h + - new flag macro, FNMATCH_IGNCASE, evaluates to FNM_CASEFOLD if the + match_ignore_case variable is non-zero + +execute_cmd.c + - new variable, match_ignore_case + - change call to strmatch() in execute_case_command so it includes + FNMATCH_IGNCASE + +test.c + - change call to strmatch() in patcomp() so that pattern matching + calls for [[ ... ]] obey the match_ignore_case variable + +lib/sh/shmatch.c + - if match_ignore_case is set, enable REG_ICASE in the regexp match + flags + +builtins/shopt.def + - new settable option, `nocasematch', controls the match_ignore_case + variable. Currently alters pattern matching for case and [[ ... ]] + commands (==, !=, and =~ operators) + +doc/{bashref.texi,bash.1} + - updated descriptions of [[ and case to include reference to + nocasematch option diff --git a/CWRU/CWRU.chlog~ b/CWRU/CWRU.chlog~ index 9e684be2e..251a83c05 100644 --- a/CWRU/CWRU.chlog~ +++ b/CWRU/CWRU.chlog~ @@ -11056,6 +11056,57 @@ jobs.c to fix pid aliasing and reuse problems on cygwin +variables.c + - set $_ from the environment if we get it there, set to $0 by + default if not in env + doc/{bashref.texi,bash.1} - a couple of clarifying changes to the description of $_ based on comments from Glenn Morris + + 2/15 + ---- +shell.c + - use strstr instead of strmatch when checking whether $EMACS contains + `term' -- simpler and faster + + 2/18 + ---- +builtins/cd.def + - implement posix requirement that `pwd -P' set $PWD to a directory + name containing no symlinks + - add new function, setpwd(), just sets (and changes exported value) + of PWD + +doc/bashref.texi + - add note to posix mode section about pwd -P setting $PWD + +doc{bash.1,bashref.texi} + - added note that BASH_ARGC and BASH_ARGV are only set in extended + debug mode + - expand description of extdebug option to include everything changed + by extended debug mode + + 2/19 + ---- +pathexp.h + - new flag macro, FNMATCH_IGNCASE, evaluates to FNM_CASEFOLD if the + match_ignore_case variable is non-zero + +execute_cmd.c + - new variable, match_ignore_case + - change call to strmatch() in execute_case_command so it includes + FNMATCH_IGNCASE + +test.c + - change call to strmatch() in patcomp() so that pattern matching + calls for [[ ... ]] obey the match_ignore_case variable + +lib/sh/shmatch.c + - if match_ignore_case is set, enable REG_ICASE in the regexp match + flags + +builtins/shopt.def + - new settable option, `nocasematch', controls the match_ignore_case + variable. Currently alters pattern matching for case and [[ ... ]] + commands (==, !=, and =~ operators) diff --git a/builtins/cd.def b/builtins/cd.def index 8bf41158c..6734b8162 100644 --- a/builtins/cd.def +++ b/builtins/cd.def @@ -1,7 +1,7 @@ This file is cd.def, from which is created cd.c. It implements the builtins "cd" and "pwd" in Bash. -Copyright (C) 1987-2004 Free Software Foundation, Inc. +Copyright (C) 1987-2005 Free Software Foundation, Inc. This file is part of GNU Bash, the Bourne Again SHell. @@ -59,6 +59,7 @@ extern int array_needs_making; extern char *bash_getcwd_errstr; static int bindpwd __P((int)); +static void setpwd __P((char *)); static int change_to_directory __P((char *, int)); static char *cdspell __P((char *)); @@ -84,6 +85,23 @@ instead of following symbolic links; the -L option forces symbolic links to be followed. $END +/* Just set $PWD, don't change OLDPWD. Used by `pwd -P' in posix mode. */ +static void +setpwd (dirname) + char *dirname; +{ + int old_anm; + SHELL_VAR *tvar; + + old_anm = array_needs_making; + tvar = bind_variable ("PWD", dirname ? dirname : "", 0); + if (old_anm == 0 && array_needs_making && exported_p (tvar)) + { + update_export_env_inplace ("PWD=", 4, dirname ? dirname : ""); + array_needs_making = 0; + } +} + static int bindpwd (no_symlinks) int no_symlinks; @@ -107,12 +125,7 @@ bindpwd (no_symlinks) array_needs_making = 0; } - tvar = bind_variable ("PWD", dirname ? dirname : "", 0); - if (old_anm == 0 && array_needs_making && exported_p (tvar)) - { - update_export_env_inplace ("PWD=", 4, dirname ? dirname : ""); - array_needs_making = 0; - } + setpwd (dirname); if (dirname && dirname != the_current_working_directory) free (dirname); @@ -314,16 +327,17 @@ pwd_builtin (list) WORD_LIST *list; { char *directory; - int opt; + int opt, pflag; verbatim_pwd = no_symbolic_links; + pflag = 0; reset_internal_getopt (); while ((opt = internal_getopt (list, "LP")) != -1) { switch (opt) { case 'P': - verbatim_pwd = 1; + verbatim_pwd = pflag = 1; break; case 'L': verbatim_pwd = 0; @@ -350,6 +364,9 @@ pwd_builtin (list) if (directory) { printf ("%s\n", directory); + /* This is dumb but posix-mandated. */ + if (posixly_correct && pflag) + setpwd (directory); if (directory != the_current_working_directory) free (directory); fflush (stdout); diff --git a/builtins/cd.def~ b/builtins/cd.def~ index f949e6d13..e95825408 100644 --- a/builtins/cd.def~ +++ b/builtins/cd.def~ @@ -1,7 +1,7 @@ This file is cd.def, from which is created cd.c. It implements the builtins "cd" and "pwd" in Bash. -Copyright (C) 1987-2003 Free Software Foundation, Inc. +Copyright (C) 1987-2005 Free Software Foundation, Inc. This file is part of GNU Bash, the Bourne Again SHell. @@ -59,6 +59,7 @@ extern int array_needs_making; extern char *bash_getcwd_errstr; static int bindpwd __P((int)); +static void setpwd __P((char *)); static int change_to_directory __P((char *, int)); static char *cdspell __P((char *)); @@ -120,6 +121,23 @@ bindpwd (no_symlinks) return (EXECUTION_SUCCESS); } +/* Just set $PWD, don't change OLDPWD. Used by `pwd -P' in posix mode. */ +static void +setpwd (dirname) + char *dirname; +{ + int old_anm; + SHELL_VAR *tvar; + + old_anm = array_needs_making; + tvar = bind_variable ("PWD", dirname ? dirname : "", 0); + if (old_anm == 0 && array_needs_making && exported_p (tvar)) + { + update_export_env_inplace ("PWD=", 4, dirname ? dirname : ""); + array_needs_making = 0; + } +} + /* Call get_working_directory to reset the value of the_current_working_directory () */ static char * @@ -314,16 +332,17 @@ pwd_builtin (list) WORD_LIST *list; { char *directory; - int opt; + int opt, pflag; verbatim_pwd = no_symbolic_links; + pflag = 0; reset_internal_getopt (); while ((opt = internal_getopt (list, "LP")) != -1) { switch (opt) { case 'P': - verbatim_pwd = 1; + verbatim_pwd = pflag = 1; break; case 'L': verbatim_pwd = 0; @@ -350,6 +369,9 @@ pwd_builtin (list) if (directory) { printf ("%s\n", directory); + /* This is dumb but posix-mandated. */ + if (posixly_correct && pflag) + setpwd (directory); if (directory != the_current_working_directory) free (directory); fflush (stdout); diff --git a/builtins/shopt.def b/builtins/shopt.def index c314c0254..ae100ace4 100644 --- a/builtins/shopt.def +++ b/builtins/shopt.def @@ -1,7 +1,7 @@ This file is shopt.def, from which is created shopt.c. It implements the Bash `shopt' builtin. -Copyright (C) 1994-2003 Free Software Foundation, Inc. +Copyright (C) 1994-2005 Free Software Foundation, Inc. This file is part of GNU Bash, the Bourne Again SHell. @@ -64,7 +64,7 @@ extern int check_hashed_filenames, promptvars; extern int cdspelling, expand_aliases; extern int extended_quote; extern int check_window_size; -extern int glob_ignore_case; +extern int glob_ignore_case, match_ignore_case; extern int hup_on_exit; extern int xpg_echo; extern int gnu_error_format; @@ -155,6 +155,7 @@ static struct { { "no_empty_cmd_completion", &no_empty_command_completion, (shopt_set_func_t *)NULL }, #endif { "nocaseglob", &glob_ignore_case, (shopt_set_func_t *)NULL }, + { "nocasematch", &match_ignore_case, (shopt_set_func_t *)NULL }, { "nullglob", &allow_null_glob_expansion, (shopt_set_func_t *)NULL }, #if defined (PROGRAMMABLE_COMPLETION) { "progcomp", &prog_completion_enabled, (shopt_set_func_t *)NULL }, diff --git a/builtins/shopt.def~ b/builtins/shopt.def~ index ad432e0c5..b0587cc11 100644 --- a/builtins/shopt.def~ +++ b/builtins/shopt.def~ @@ -64,7 +64,7 @@ extern int check_hashed_filenames, promptvars; extern int cdspelling, expand_aliases; extern int extended_quote; extern int check_window_size; -extern int glob_ignore_case; +extern int glob_ignore_case, match_ignore_case; extern int hup_on_exit; extern int xpg_echo; extern int gnu_error_format; @@ -134,13 +134,13 @@ static struct { { "failglob", &fail_glob_expansion, (shopt_set_func_t *)NULL }, #if defined (READLINE) { "force_fignore", &force_fignore, (shopt_set_func_t *)NULL }, - { "gnu_errfmt", &gnu_error_format, (shopt_set_func_t *)NULL }, - { "histreedit", &history_reediting, (shopt_set_func_t *)NULL }, #endif + { "gnu_errfmt", &gnu_error_format, (shopt_set_func_t *)NULL }, #if defined (HISTORY) { "histappend", &force_append_history, (shopt_set_func_t *)NULL }, #endif #if defined (READLINE) + { "histreedit", &history_reediting, (shopt_set_func_t *)NULL }, { "histverify", &hist_verify, (shopt_set_func_t *)NULL }, { "hostcomplete", &perform_hostname_completion, enable_hostname_completion }, #endif @@ -155,6 +155,7 @@ static struct { { "no_empty_cmd_completion", &no_empty_command_completion, (shopt_set_func_t *)NULL }, #endif { "nocaseglob", &glob_ignore_case, (shopt_set_func_t *)NULL }, + { "nocasematch", &match_ignore_case, (shopt_set_func_t *)NULL }, { "nullglob", &allow_null_glob_expansion, (shopt_set_func_t *)NULL }, #if defined (PROGRAMMABLE_COMPLETION) { "progcomp", &prog_completion_enabled, (shopt_set_func_t *)NULL }, diff --git a/doc/FAQ b/doc/FAQ index ede1272bf..e9ab38754 100644 --- a/doc/FAQ +++ b/doc/FAQ @@ -1,4 +1,4 @@ -This is the Bash FAQ, version 3.29, for Bash version 3.0. +This is the Bash FAQ, version 3.30, for Bash version 3.0. This document contains a set of frequently-asked questions concerning Bash, the GNU Bourne-Again Shell. Bash is a freely-available command @@ -157,6 +157,10 @@ Formatted versions of the documentation are available with the URLs: ftp://ftp.gnu.org/pub/gnu/bash/bash-doc-3.0.tar.gz ftp://ftp.cwru.edu/pub/bash/bash-doc-3.0.tar.gz +Any patches for the current version are available with the URL: + +ftp://ftp.cwru.edu/pub/bash/bash-3.0-patches/ + A4) On what machines will bash run? Bash has been ported to nearly every version of Unix. All you diff --git a/doc/bash.0 b/doc/bash.0 index 3a5fb493b..46e777500 100644 --- a/doc/bash.0 +++ b/doc/bash.0 @@ -1,3 +1,4 @@ + BASH(1) BASH(1) @@ -9,7 +10,7 @@ SSYYNNOOPPSSIISS bbaasshh [options] [file] CCOOPPYYRRIIGGHHTT - Bash is Copyright (C) 1989-2004 by the Free Software Foundation, Inc. + Bash is Copyright (C) 1989-2005 by the Free Software Foundation, Inc. DDEESSCCRRIIPPTTIIOONN BBaasshh is an sshh-compatible command language interpreter that executes @@ -133,8 +134,8 @@ IINNVVOOCCAATTIIOONN The following paragraphs describe how bbaasshh executes its startup files. If any of the files exist but cannot be read, bbaasshh reports an error. - Tildes are expanded in file names as described below under TTiillddee - EExxppaannssiioonn in the EEXXPPAANNSSIIOONN section. + Tildes are expanded in file names as described below under TTiillddee EExxppaann-- + ssiioonn in the EEXXPPAANNSSIIOONN section. When bbaasshh is invoked as an interactive login shell, or as a non-inter- active shell with the ----llooggiinn option, it first reads and executes com- @@ -394,8 +395,8 @@ SSHHEELLLL GGRRAAMMMMAARR value, _l_i_s_t is executed and the arithmetic expression _e_x_p_r_3 is evaluated. If any expression is omitted, it behaves as if it evaluates to 1. The return value is the exit status of the last - command in _l_i_s_t that is executed, or false if any of the expres- - sions is invalid. + command in _l_i_s_t that is executed, or false if any of the + expressions is invalid. sseelleecctt _n_a_m_e [ iinn _w_o_r_d ] ; ddoo _l_i_s_t ; ddoonnee The list of words following iinn is expanded, generating a list of @@ -405,10 +406,10 @@ SSHHEELLLL GGRRAAMMMMAARR The PPSS33 prompt is then displayed and a line read from the stan- dard input. If the line consists of a number corresponding to one of the displayed words, then the value of _n_a_m_e is set to - that word. If the line is empty, the words and prompt are - displayed again. If EOF is read, the command completes. Any - other value read causes _n_a_m_e to be set to null. The line read - is saved in the variable RREEPPLLYY. The _l_i_s_t is executed after each + that word. If the line is empty, the words and prompt are dis- + played again. If EOF is read, the command completes. Any other + value read causes _n_a_m_e to be set to null. The line read is + saved in the variable RREEPPLLYY. The _l_i_s_t is executed after each selection until a bbrreeaakk command is executed. The exit status of sseelleecctt is the exit status of the last command executed in _l_i_s_t, or zero if no commands were executed. @@ -625,178 +626,179 @@ PPAARRAAMMEETTEERRSS the string to be executed, if one is present. Otherwise, it is set to the file name used to invoke bbaasshh, as given by argument zero. - __ At shell startup, set to the absolute file name of the shell or - shell script being executed as passed in the argument list. - Subsequently, expands to the last argument to the previous com- - mand, after expansion. Also set to the full file name of each - command executed and placed in the environment exported to that - command. When checking mail, this parameter holds the name of - the mail file currently being checked. + __ At shell startup, set to the absolute pathname used to invoke + the shell or shell script being executed as passed in the envi- + ronment or argument list. Subsequently, expands to the last + argument to the previous command, after expansion. Also set to + the full pathname used to invoke each command executed and + placed in the environment exported to that command. When check- + ing mail, this parameter holds the name of the mail file cur- + rently being checked. SShheellll VVaarriiaabblleess The following variables are set by the shell: - BBAASSHH Expands to the full file name used to invoke this instance of + BBAASSHH Expands to the full file name used to invoke this instance of bbaasshh. BBAASSHH__AARRGGCC - An array variable whose values are the number of parameters in + An array variable whose values are the number of parameters in each frame of the current bash execution call stack. The number - of parameters to the current subroutine (shell function or - script executed with .. or ssoouurrccee) is at the top of the stack. - When a subroutine is executed, the number of parameters passed + of parameters to the current subroutine (shell function or + script executed with .. or ssoouurrccee) is at the top of the stack. + When a subroutine is executed, the number of parameters passed is pushed onto BBAASSHH__AARRGGCC. BBAASSHH__AARRGGVV - An array variable containing all of the parameters in the cur- + An array variable containing all of the parameters in the cur- rent bash execution call stack. The final parameter of the last - subroutine call is at the top of the stack; the first parameter + subroutine call is at the top of the stack; the first parameter of the initial call is at the bottom. When a subroutine is exe- cuted, the parameters supplied are pushed onto BBAASSHH__AARRGGVV. BBAASSHH__CCOOMMMMAANNDD - The command currently being executed or about to be executed, + The command currently being executed or about to be executed, unless the shell is executing a command as the result of a trap, - in which case it is the command executing at the time of the + in which case it is the command executing at the time of the trap. BBAASSHH__EEXXEECCUUTTIIOONN__SSTTRRIINNGG The command argument to the --cc invocation option. BBAASSHH__LLIINNEENNOO - An array variable whose members are the line numbers in source - files corresponding to each member of FFUUNNCCNNAAMMEE. - $${{BBAASSHH__LLIINNEENNOO[[_$_i]]}} is the line number in the source file where - $${{FFUUNNCCNNAAMMEE[[_$_i_f_P]]}} _w_a_s _c_a_l_l_e_d_. _T_h_e _c_o_r_r_e_s_p_o_n_d_i_n_g _s_o_u_r_c_e _f_i_l_e - _n_a_m_e _i_s $${{BBAASSHH__SSOOUURRCCEE[[_$_i]]}}.. UUssee LLIINNEENNOO ttoo oobbttaaiinn tthhee ccuurrrreenntt + An array variable whose members are the line numbers in source + files corresponding to each member of FFUUNNCCNNAAMMEE. + $${{BBAASSHH__LLIINNEENNOO[[_$_i]]}} is the line number in the source file where + $${{FFUUNNCCNNAAMMEE[[_$_i_f_P]]}} _w_a_s _c_a_l_l_e_d_. _T_h_e _c_o_r_r_e_s_p_o_n_d_i_n_g _s_o_u_r_c_e _f_i_l_e + _n_a_m_e _i_s $${{BBAASSHH__SSOOUURRCCEE[[_$_i]]}}.. UUssee LLIINNEENNOO ttoo oobbttaaiinn tthhee ccuurrrreenntt lliinnee nnuummbbeerr.. BBAASSHH__RREEMMAATTCCHH - An array variable whose members are assigned by the ==~~ binary - operator to the [[[[ conditional command. The element with index - 0 is the portion of the string matching the entire regular - expression. The element with index _n is the portion of the + An array variable whose members are assigned by the ==~~ binary + operator to the [[[[ conditional command. The element with index + 0 is the portion of the string matching the entire regular + expression. The element with index _n is the portion of the string matching the _nth parenthesized subexpression. This vari- able is read-only. BBAASSHH__SSOOUURRCCEE - An array variable whose members are the source filenames corre- + An array variable whose members are the source filenames corre- sponding to the elements in the FFUUNNCCNNAAMMEE array variable. BBAASSHH__SSUUBBSSHHEELLLL - Incremented by one each time a subshell or subshell environment + Incremented by one each time a subshell or subshell environment is spawned. The initial value is 0. BBAASSHH__VVEERRSSIINNFFOO A readonly array variable whose members hold version information - for this instance of bbaasshh. The values assigned to the array + for this instance of bbaasshh. The values assigned to the array members are as follows: - BBAASSHH__VVEERRSSIINNFFOO[[0]] The major version number (the _r_e_l_e_a_s_e). - BBAASSHH__VVEERRSSIINNFFOO[[1]] The minor version number (the _v_e_r_s_i_o_n). + BBAASSHH__VVEERRSSIINNFFOO[[0]] The major version number (the _r_e_l_e_a_s_e). + BBAASSHH__VVEERRSSIINNFFOO[[1]] The minor version number (the _v_e_r_s_i_o_n). BBAASSHH__VVEERRSSIINNFFOO[[2]] The patch level. BBAASSHH__VVEERRSSIINNFFOO[[3]] The build version. BBAASSHH__VVEERRSSIINNFFOO[[4]] The release status (e.g., _b_e_t_a_1). BBAASSHH__VVEERRSSIINNFFOO[[5]] The value of MMAACCHHTTYYPPEE. BBAASSHH__VVEERRSSIIOONN - Expands to a string describing the version of this instance of + Expands to a string describing the version of this instance of bbaasshh. CCOOMMPP__CCWWOORRDD - An index into $${{CCOOMMPP__WWOORRDDSS}} of the word containing the current + An index into $${{CCOOMMPP__WWOORRDDSS}} of the word containing the current cursor position. This variable is available only in shell func- - tions invoked by the programmable completion facilities (see + tions invoked by the programmable completion facilities (see PPrrooggrraammmmaabbllee CCoommpplleettiioonn below). CCOOMMPP__LLIINNEE - The current command line. This variable is available only in - shell functions and external commands invoked by the pro- - grammable completion facilities (see PPrrooggrraammmmaabbllee CCoommpplleettiioonn + The current command line. This variable is available only in + shell functions and external commands invoked by the pro- + grammable completion facilities (see PPrrooggrraammmmaabbllee CCoommpplleettiioonn below). CCOOMMPP__PPOOIINNTT - The index of the current cursor position relative to the begin- - ning of the current command. If the current cursor position is + The index of the current cursor position relative to the begin- + ning of the current command. If the current cursor position is at the end of the current command, the value of this variable is - equal to $${{##CCOOMMPP__LLIINNEE}}. This variable is available only in - shell functions and external commands invoked by the pro- - grammable completion facilities (see PPrrooggrraammmmaabbllee CCoommpplleettiioonn + equal to $${{##CCOOMMPP__LLIINNEE}}. This variable is available only in + shell functions and external commands invoked by the pro- + grammable completion facilities (see PPrrooggrraammmmaabbllee CCoommpplleettiioonn below). CCOOMMPP__WWOORRDDBBRREEAAKKSS - The set of characters that the Readline library treats as word - separators when performing word completion. If CCOOMMPP__WWOORRDDBBRREEAAKKSS - is unset, it loses its special properties, even if it is subse- + The set of characters that the Readline library treats as word + separators when performing word completion. If CCOOMMPP__WWOORRDDBBRREEAAKKSS + is unset, it loses its special properties, even if it is subse- quently reset. CCOOMMPP__WWOORRDDSS - An array variable (see AArrrraayyss below) consisting of the individ- - ual words in the current command line. This variable is avail- + An array variable (see AArrrraayyss below) consisting of the individ- + ual words in the current command line. This variable is avail- able only in shell functions invoked by the programmable comple- tion facilities (see PPrrooggrraammmmaabbllee CCoommpplleettiioonn below). DDIIRRSSTTAACCKK An array variable (see AArrrraayyss below) containing the current con- - tents of the directory stack. Directories appear in the stack - in the order they are displayed by the ddiirrss builtin. Assigning + tents of the directory stack. Directories appear in the stack + in the order they are displayed by the ddiirrss builtin. Assigning to members of this array variable may be used to modify directo- - ries already in the stack, but the ppuusshhdd and ppooppdd builtins must - be used to add and remove directories. Assignment to this vari- - able will not change the current directory. If DDIIRRSSTTAACCKK is - unset, it loses its special properties, even if it is subse- + ries already in the stack, but the ppuusshhdd and ppooppdd builtins must + be used to add and remove directories. Assignment to this + variable will not change the current directory. If DDIIRRSSTTAACCKK is + unset, it loses its special properties, even if it is subse- quently reset. - EEUUIIDD Expands to the effective user ID of the current user, initial- + EEUUIIDD Expands to the effective user ID of the current user, initial- ized at shell startup. This variable is readonly. FFUUNNCCNNAAMMEE - An array variable containing the names of all shell functions + An array variable containing the names of all shell functions currently in the execution call stack. The element with index 0 is the name of any currently-executing shell function. The bot- - tom-most element is "main". This variable exists only when a - shell function is executing. Assignments to FFUUNNCCNNAAMMEE have no - effect and return an error status. If FFUUNNCCNNAAMMEE is unset, it - loses its special properties, even if it is subsequently reset. - - GGRROOUUPPSS An array variable containing the list of groups of which the - current user is a member. Assignments to GGRROOUUPPSS have no effect - and return an error status. If GGRROOUUPPSS is unset, it loses its + tom-most element is "main". This variable exists only when a + shell function is executing. Assignments to FFUUNNCCNNAAMMEE have no + effect and return an error status. If FFUUNNCCNNAAMMEE is unset, it + loses its special properties, even if it is subsequently reset. + + GGRROOUUPPSS An array variable containing the list of groups of which the + current user is a member. Assignments to GGRROOUUPPSS have no effect + and return an error status. If GGRROOUUPPSS is unset, it loses its special properties, even if it is subsequently reset. HHIISSTTCCMMDD The history number, or index in the history list, of the current - command. If HHIISSTTCCMMDD is unset, it loses its special properties, + command. If HHIISSTTCCMMDD is unset, it loses its special properties, even if it is subsequently reset. HHOOSSTTNNAAMMEE Automatically set to the name of the current host. HHOOSSTTTTYYPPEE - Automatically set to a string that uniquely describes the type - of machine on which bbaasshh is executing. The default is system- + Automatically set to a string that uniquely describes the type + of machine on which bbaasshh is executing. The default is system- dependent. - LLIINNEENNOO Each time this parameter is referenced, the shell substitutes a - decimal number representing the current sequential line number - (starting with 1) within a script or function. When not in a - script or function, the value substituted is not guaranteed to + LLIINNEENNOO Each time this parameter is referenced, the shell substitutes a + decimal number representing the current sequential line number + (starting with 1) within a script or function. When not in a + script or function, the value substituted is not guaranteed to be meaningful. If LLIINNEENNOO is unset, it loses its special proper- ties, even if it is subsequently reset. MMAACCHHTTYYPPEE - Automatically set to a string that fully describes the system - type on which bbaasshh is executing, in the standard GNU _c_p_u_-_c_o_m_- + Automatically set to a string that fully describes the system + type on which bbaasshh is executing, in the standard GNU _c_p_u_-_c_o_m_- _p_a_n_y_-_s_y_s_t_e_m format. The default is system-dependent. OOLLDDPPWWDD The previous working directory as set by the ccdd command. - OOPPTTAARRGG The value of the last option argument processed by the ggeettooppttss + OOPPTTAARRGG The value of the last option argument processed by the ggeettooppttss builtin command (see SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below). - OOPPTTIINNDD The index of the next argument to be processed by the ggeettooppttss + OOPPTTIINNDD The index of the next argument to be processed by the ggeettooppttss builtin command (see SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below). - OOSSTTYYPPEE Automatically set to a string that describes the operating sys- - tem on which bbaasshh is executing. The default is system-depen- + OOSSTTYYPPEE Automatically set to a string that describes the operating sys- + tem on which bbaasshh is executing. The default is system-depen- dent. PPIIPPEESSTTAATTUUSS - An array variable (see AArrrraayyss below) containing a list of exit - status values from the processes in the most-recently-executed + An array variable (see AArrrraayyss below) containing a list of exit + status values from the processes in the most-recently-executed foreground pipeline (which may contain only a single command). - PPPPIIDD The process ID of the shell's parent. This variable is read- + PPPPIIDD The process ID of the shell's parent. This variable is read- only. PPWWDD The current working directory as set by the ccdd command. @@ -804,27 +806,27 @@ PPAARRAAMMEETTEERRSS RRAANNDDOOMM Each time this parameter is referenced, a random integer between 0 and 32767 is generated. The sequence of random numbers may be initialized by assigning a value to RRAANNDDOOMM. If RRAANNDDOOMM is unset, - it loses its special properties, even if it is subsequently + it loses its special properties, even if it is subsequently reset. - RREEPPLLYY Set to the line of input read by the rreeaadd builtin command when + RREEPPLLYY Set to the line of input read by the rreeaadd builtin command when no arguments are supplied. SSEECCOONNDDSS - Each time this parameter is referenced, the number of seconds - since shell invocation is returned. If a value is assigned to - SSEECCOONNDDSS, the value returned upon subsequent references is the - number of seconds since the assignment plus the value assigned. + Each time this parameter is referenced, the number of seconds + since shell invocation is returned. If a value is assigned to + SSEECCOONNDDSS, the value returned upon subsequent references is the + number of seconds since the assignment plus the value assigned. If SSEECCOONNDDSS is unset, it loses its special properties, even if it is subsequently reset. SSHHEELLLLOOPPTTSS - A colon-separated list of enabled shell options. Each word in - the list is a valid argument for the --oo option to the sseett + A colon-separated list of enabled shell options. Each word in + the list is a valid argument for the --oo option to the sseett builtin command (see SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below). The options - appearing in SSHHEELLLLOOPPTTSS are those reported as _o_n by sseett --oo. If - this variable is in the environment when bbaasshh starts up, each - shell option in the list will be enabled before reading any + appearing in SSHHEELLLLOOPPTTSS are those reported as _o_n by sseett --oo. If + this variable is in the environment when bbaasshh starts up, each + shell option in the list will be enabled before reading any startup files. This variable is read-only. SSHHLLVVLL Incremented by one each time an instance of bbaasshh is started. @@ -832,202 +834,202 @@ PPAARRAAMMEETTEERRSS UUIIDD Expands to the user ID of the current user, initialized at shell startup. This variable is readonly. - The following variables are used by the shell. In some cases, bbaasshh + The following variables are used by the shell. In some cases, bbaasshh assigns a default value to a variable; these cases are noted below. BBAASSHH__EENNVV - If this parameter is set when bbaasshh is executing a shell script, - its value is interpreted as a filename containing commands to + If this parameter is set when bbaasshh is executing a shell script, + its value is interpreted as a filename containing commands to initialize the shell, as in _~_/_._b_a_s_h_r_c. The value of BBAASSHH__EENNVV is - subjected to parameter expansion, command substitution, and - arithmetic expansion before being interpreted as a file name. + subjected to parameter expansion, command substitution, and + arithmetic expansion before being interpreted as a file name. PPAATTHH is not used to search for the resultant file name. - CCDDPPAATTHH The search path for the ccdd command. This is a colon-separated - list of directories in which the shell looks for destination - directories specified by the ccdd command. A sample value is + CCDDPPAATTHH The search path for the ccdd command. This is a colon-separated + list of directories in which the shell looks for destination + directories specified by the ccdd command. A sample value is ".:~:/usr". CCOOLLUUMMNNSS - Used by the sseelleecctt builtin command to determine the terminal - width when printing selection lists. Automatically set upon + Used by the sseelleecctt builtin command to determine the terminal + width when printing selection lists. Automatically set upon receipt of a SIGWINCH. CCOOMMPPRREEPPLLYY An array variable from which bbaasshh reads the possible completions - generated by a shell function invoked by the programmable com- + generated by a shell function invoked by the programmable com- pletion facility (see PPrrooggrraammmmaabbllee CCoommpplleettiioonn below). - EEMMAACCSS If bbaasshh finds this variable in the environment when the shell - starts with value "t", it assumes that the shell is running in + EEMMAACCSS If bbaasshh finds this variable in the environment when the shell + starts with value "t", it assumes that the shell is running in an emacs shell buffer and disables line editing. FFCCEEDDIITT The default editor for the ffcc builtin command. FFIIGGNNOORREE - A colon-separated list of suffixes to ignore when performing + A colon-separated list of suffixes to ignore when performing filename completion (see RREEAADDLLIINNEE below). A filename whose suf- - fix matches one of the entries in FFIIGGNNOORREE is excluded from the + fix matches one of the entries in FFIIGGNNOORREE is excluded from the list of matched filenames. A sample value is ".o:~". GGLLOOBBIIGGNNOORREE A colon-separated list of patterns defining the set of filenames to be ignored by pathname expansion. If a filename matched by a - pathname expansion pattern also matches one of the patterns in + pathname expansion pattern also matches one of the patterns in GGLLOOBBIIGGNNOORREE, it is removed from the list of matches. HHIISSTTCCOONNTTRROOLL - A colon-separated list of values controlling how commands are - saved on the history list. If the list of values includes - _i_g_n_o_r_e_s_p_a_c_e, lines which begin with a ssppaaccee character are not - saved in the history list. A value of _i_g_n_o_r_e_d_u_p_s causes lines + A colon-separated list of values controlling how commands are + saved on the history list. If the list of values includes + _i_g_n_o_r_e_s_p_a_c_e, lines which begin with a ssppaaccee character are not + saved in the history list. A value of _i_g_n_o_r_e_d_u_p_s causes lines matching the previous history entry to not be saved. A value of _i_g_n_o_r_e_b_o_t_h is shorthand for _i_g_n_o_r_e_s_p_a_c_e and _i_g_n_o_r_e_d_u_p_s. A value of _e_r_a_s_e_d_u_p_s causes all previous lines matching the current line - to be removed from the history list before that line is saved. - Any value not in the above list is ignored. If HHIISSTTCCOONNTTRROOLL is - unset, or does not include a valid value, all lines read by the + to be removed from the history list before that line is saved. + Any value not in the above list is ignored. If HHIISSTTCCOONNTTRROOLL is + unset, or does not include a valid value, all lines read by the shell parser are saved on the history list, subject to the value - of HHIISSTTIIGGNNOORREE. The second and subsequent lines of a multi-line - compound command are not tested, and are added to the history + of HHIISSTTIIGGNNOORREE. The second and subsequent lines of a multi-line + compound command are not tested, and are added to the history regardless of the value of HHIISSTTCCOONNTTRROOLL. HHIISSTTFFIILLEE The name of the file in which command history is saved (see HHIISS-- - TTOORRYY below). The default value is _~_/_._b_a_s_h___h_i_s_t_o_r_y. If unset, - the command history is not saved when an interactive shell + TTOORRYY below). The default value is _~_/_._b_a_s_h___h_i_s_t_o_r_y. If unset, + the command history is not saved when an interactive shell exits. HHIISSTTFFIILLEESSIIZZEE The maximum number of lines contained in the history file. When - this variable is assigned a value, the history file is trun- - cated, if necessary, to contain no more than that number of - lines. The default value is 500. The history file is also - truncated to this size after writing it when an interactive + this variable is assigned a value, the history file is trun- + cated, if necessary, to contain no more than that number of + lines. The default value is 500. The history file is also + truncated to this size after writing it when an interactive shell exits. HHIISSTTIIGGNNOORREE - A colon-separated list of patterns used to decide which command - lines should be saved on the history list. Each pattern is - anchored at the beginning of the line and must match the com- - plete line (no implicit `**' is appended). Each pattern is - tested against the line after the checks specified by HHIISSTTCCOONN-- - TTRROOLL are applied. In addition to the normal shell pattern + A colon-separated list of patterns used to decide which command + lines should be saved on the history list. Each pattern is + anchored at the beginning of the line and must match the com- + plete line (no implicit `**' is appended). Each pattern is + tested against the line after the checks specified by HHIISSTTCCOONN-- + TTRROOLL are applied. In addition to the normal shell pattern matching characters, `&&' matches the previous history line. `&&' - may be escaped using a backslash; the backslash is removed + may be escaped using a backslash; the backslash is removed before attempting a match. The second and subsequent lines of a multi-line compound command are not tested, and are added to the history regardless of the value of HHIISSTTIIGGNNOORREE. HHIISSTTSSIIZZEE - The number of commands to remember in the command history (see + The number of commands to remember in the command history (see HHIISSTTOORRYY below). The default value is 500. HHIISSTTTTIIMMEEFFOORRMMAATT - If this variable is set and not null, its value is used as a + If this variable is set and not null, its value is used as a format string for _s_t_r_f_t_i_m_e(3) to print the time stamp associated - with each history entry displayed by the hhiissttoorryy builtin. If - this variable is set, time stamps are written to the history + with each history entry displayed by the hhiissttoorryy builtin. If + this variable is set, time stamps are written to the history file so they may be preserved across shell sessions. HHOOMMEE The home directory of the current user; the default argument for the ccdd builtin command. The value of this variable is also used when performing tilde expansion. HHOOSSTTFFIILLEE - Contains the name of a file in the same format as _/_e_t_c_/_h_o_s_t_s + Contains the name of a file in the same format as _/_e_t_c_/_h_o_s_t_s that should be read when the shell needs to complete a hostname. - The list of possible hostname completions may be changed while - the shell is running; the next time hostname completion is - attempted after the value is changed, bbaasshh adds the contents of - the new file to the existing list. If HHOOSSTTFFIILLEE is set, but has + The list of possible hostname completions may be changed while + the shell is running; the next time hostname completion is + attempted after the value is changed, bbaasshh adds the contents of + the new file to the existing list. If HHOOSSTTFFIILLEE is set, but has no value, bbaasshh attempts to read _/_e_t_c_/_h_o_s_t_s to obtain the list of - possible hostname completions. When HHOOSSTTFFIILLEE is unset, the + possible hostname completions. When HHOOSSTTFFIILLEE is unset, the hostname list is cleared. - IIFFSS The _I_n_t_e_r_n_a_l _F_i_e_l_d _S_e_p_a_r_a_t_o_r that is used for word splitting - after expansion and to split lines into words with the rreeaadd + IIFFSS The _I_n_t_e_r_n_a_l _F_i_e_l_d _S_e_p_a_r_a_t_o_r that is used for word splitting + after expansion and to split lines into words with the rreeaadd builtin command. The default value is ``''. IIGGNNOORREEEEOOFF Controls the action of an interactive shell on receipt of an EEOOFF character as the sole input. If set, the value is the number of - consecutive EEOOFF characters which must be typed as the first - characters on an input line before bbaasshh exits. If the variable - exists but does not have a numeric value, or has no value, the - default value is 10. If it does not exist, EEOOFF signifies the + consecutive EEOOFF characters which must be typed as the first + characters on an input line before bbaasshh exits. If the variable + exists but does not have a numeric value, or has no value, the + default value is 10. If it does not exist, EEOOFF signifies the end of input to the shell. IINNPPUUTTRRCC - The filename for the rreeaaddlliinnee startup file, overriding the + The filename for the rreeaaddlliinnee startup file, overriding the default of _~_/_._i_n_p_u_t_r_c (see RREEAADDLLIINNEE below). - LLAANNGG Used to determine the locale category for any category not + LLAANNGG Used to determine the locale category for any category not specifically selected with a variable starting with LLCC__. - LLCC__AALLLL This variable overrides the value of LLAANNGG and any other LLCC__ + LLCC__AALLLL This variable overrides the value of LLAANNGG and any other LLCC__ variable specifying a locale category. LLCC__CCOOLLLLAATTEE - This variable determines the collation order used when sorting - the results of pathname expansion, and determines the behavior - of range expressions, equivalence classes, and collating + This variable determines the collation order used when sorting + the results of pathname expansion, and determines the behavior + of range expressions, equivalence classes, and collating sequences within pathname expansion and pattern matching. LLCC__CCTTYYPPEE - This variable determines the interpretation of characters and - the behavior of character classes within pathname expansion and + This variable determines the interpretation of characters and + the behavior of character classes within pathname expansion and pattern matching. LLCC__MMEESSSSAAGGEESS - This variable determines the locale used to translate double- + This variable determines the locale used to translate double- quoted strings preceded by a $$. LLCC__NNUUMMEERRIICC - This variable determines the locale category used for number + This variable determines the locale category used for number formatting. - LLIINNEESS Used by the sseelleecctt builtin command to determine the column - length for printing selection lists. Automatically set upon + LLIINNEESS Used by the sseelleecctt builtin command to determine the column + length for printing selection lists. Automatically set upon receipt of a SIGWINCH. - MMAAIILL If this parameter is set to a file name and the MMAAIILLPPAATTHH vari- + MMAAIILL If this parameter is set to a file name and the MMAAIILLPPAATTHH vari- able is not set, bbaasshh informs the user of the arrival of mail in the specified file. MMAAIILLCCHHEECCKK - Specifies how often (in seconds) bbaasshh checks for mail. The - default is 60 seconds. When it is time to check for mail, the - shell does so before displaying the primary prompt. If this - variable is unset, or set to a value that is not a number + Specifies how often (in seconds) bbaasshh checks for mail. The + default is 60 seconds. When it is time to check for mail, the + shell does so before displaying the primary prompt. If this + variable is unset, or set to a value that is not a number greater than or equal to zero, the shell disables mail checking. MMAAIILLPPAATTHH - A colon-separated list of file names to be checked for mail. + A colon-separated list of file names to be checked for mail. The message to be printed when mail arrives in a particular file - may be specified by separating the file name from the message + may be specified by separating the file name from the message with a `?'. When used in the text of the message, $$__ expands to the name of the current mailfile. Example: MMAAIILLPPAATTHH='/var/mail/bfox?"You have mail":~/shell-mail?"$_ has mail!"' - BBaasshh supplies a default value for this variable, but the loca- - tion of the user mail files that it uses is system dependent + BBaasshh supplies a default value for this variable, but the loca- + tion of the user mail files that it uses is system dependent (e.g., /var/mail/$$UUSSEERR). OOPPTTEERRRR If set to the value 1, bbaasshh displays error messages generated by - the ggeettooppttss builtin command (see SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below). - OOPPTTEERRRR is initialized to 1 each time the shell is invoked or a + the ggeettooppttss builtin command (see SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below). + OOPPTTEERRRR is initialized to 1 each time the shell is invoked or a shell script is executed. - PPAATTHH The search path for commands. It is a colon-separated list of - directories in which the shell looks for commands (see CCOOMMMMAANNDD - EEXXEECCUUTTIIOONN below). A zero-length (null) directory name in the + PPAATTHH The search path for commands. It is a colon-separated list of + directories in which the shell looks for commands (see CCOOMMMMAANNDD + EEXXEECCUUTTIIOONN below). A zero-length (null) directory name in the value of PPAATTHH indicates the current directory. A null directory - name may appear as two adjacent colons, or as an initial or - trailing colon. The default path is system-dependent, and is - set by the administrator who installs bbaasshh. A common value is + name may appear as two adjacent colons, or as an initial or + trailing colon. The default path is system-dependent, and is + set by the administrator who installs bbaasshh. A common value is ``/usr/gnu/bin:/usr/local/bin:/usr/ucb:/bin:/usr/bin''. PPOOSSIIXXLLYY__CCOORRRREECCTT - If this variable is in the environment when bbaasshh starts, the - shell enters _p_o_s_i_x _m_o_d_e before reading the startup files, as if - the ----ppoossiixx invocation option had been supplied. If it is set - while the shell is running, bbaasshh enables _p_o_s_i_x _m_o_d_e, as if the + If this variable is in the environment when bbaasshh starts, the + shell enters _p_o_s_i_x _m_o_d_e before reading the startup files, as if + the ----ppoossiixx invocation option had been supplied. If it is set + while the shell is running, bbaasshh enables _p_o_s_i_x _m_o_d_e, as if the command _s_e_t _-_o _p_o_s_i_x had been executed. PPRROOMMPPTT__CCOOMMMMAANNDD If set, the value is executed as a command prior to issuing each primary prompt. - PPSS11 The value of this parameter is expanded (see PPRROOMMPPTTIINNGG below) - and used as the primary prompt string. The default value is + PPSS11 The value of this parameter is expanded (see PPRROOMMPPTTIINNGG below) + and used as the primary prompt string. The default value is ``\\ss--\\vv\\$$ ''. - PPSS22 The value of this parameter is expanded as with PPSS11 and used as + PPSS22 The value of this parameter is expanded as with PPSS11 and used as the secondary prompt string. The default is ``>> ''. PPSS33 The value of this parameter is used as the prompt for the sseelleecctt command (see SSHHEELLLL GGRRAAMMMMAARR above). - PPSS44 The value of this parameter is expanded as with PPSS11 and the - value is printed before each command bbaasshh displays during an - execution trace. The first character of PPSS44 is replicated mul- - tiple times, as necessary, to indicate multiple levels of indi- + PPSS44 The value of this parameter is expanded as with PPSS11 and the + value is printed before each command bbaasshh displays during an + execution trace. The first character of PPSS44 is replicated mul- + tiple times, as necessary, to indicate multiple levels of indi- rection. The default is ``++ ''. SSHHEELLLL The full pathname to the shell is kept in this environment vari- - able. If it is not set when the shell starts, bbaasshh assigns to + able. If it is not set when the shell starts, bbaasshh assigns to it the full pathname of the current user's login shell. TTIIMMEEFFOORRMMAATT - The value of this parameter is used as a format string specify- - ing how the timing information for pipelines prefixed with the - ttiimmee reserved word should be displayed. The %% character intro- - duces an escape sequence that is expanded to a time value or - other information. The escape sequences and their meanings are + The value of this parameter is used as a format string specify- + ing how the timing information for pipelines prefixed with the + ttiimmee reserved word should be displayed. The %% character intro- + duces an escape sequence that is expanded to a time value or + other information. The escape sequences and their meanings are as follows; the braces denote optional portions. %%%% A literal %%. %%[[_p]][[ll]]RR The elapsed time in seconds. @@ -1035,165 +1037,165 @@ PPAARRAAMMEETTEERRSS %%[[_p]][[ll]]SS The number of CPU seconds spent in system mode. %%PP The CPU percentage, computed as (%U + %S) / %R. - The optional _p is a digit specifying the _p_r_e_c_i_s_i_o_n, the number + The optional _p is a digit specifying the _p_r_e_c_i_s_i_o_n, the number of fractional digits after a decimal point. A value of 0 causes no decimal point or fraction to be output. At most three places - after the decimal point may be specified; values of _p greater - than 3 are changed to 3. If _p is not specified, the value 3 is + after the decimal point may be specified; values of _p greater + than 3 are changed to 3. If _p is not specified, the value 3 is used. - The optional ll specifies a longer format, including minutes, of - the form _M_Mm_S_S._F_Fs. The value of _p determines whether or not + The optional ll specifies a longer format, including minutes, of + the form _M_Mm_S_S._F_Fs. The value of _p determines whether or not the fraction is included. - If this variable is not set, bbaasshh acts as if it had the value - $$''\\nnrreeaall\\tt%%33llRR\\nnuusseerr\\tt%%33llUU\\nnssyyss%%33llSS''. If the value is null, no - timing information is displayed. A trailing newline is added + If this variable is not set, bbaasshh acts as if it had the value + $$''\\nnrreeaall\\tt%%33llRR\\nnuusseerr\\tt%%33llUU\\nnssyyss%%33llSS''. If the value is null, no + timing information is displayed. A trailing newline is added when the format string is displayed. - TTMMOOUUTT If set to a value greater than zero, TTMMOOUUTT is treated as the + TTMMOOUUTT If set to a value greater than zero, TTMMOOUUTT is treated as the default timeout for the rreeaadd builtin. The sseelleecctt command termi- nates if input does not arrive after TTMMOOUUTT seconds when input is - coming from a terminal. In an interactive shell, the value is - interpreted as the number of seconds to wait for input after - issuing the primary prompt. BBaasshh terminates after waiting for + coming from a terminal. In an interactive shell, the value is + interpreted as the number of seconds to wait for input after + issuing the primary prompt. BBaasshh terminates after waiting for that number of seconds if input does not arrive. aauuttoo__rreessuummee This variable controls how the shell interacts with the user and - job control. If this variable is set, single word simple com- + job control. If this variable is set, single word simple com- mands without redirections are treated as candidates for resump- tion of an existing stopped job. There is no ambiguity allowed; - if there is more than one job beginning with the string typed, - the job most recently accessed is selected. The _n_a_m_e of a - stopped job, in this context, is the command line used to start - it. If set to the value _e_x_a_c_t, the string supplied must match - the name of a stopped job exactly; if set to _s_u_b_s_t_r_i_n_g, the - string supplied needs to match a substring of the name of a - stopped job. The _s_u_b_s_t_r_i_n_g value provides functionality analo- - gous to the %%?? job identifier (see JJOOBB CCOONNTTRROOLL below). If set - to any other value, the supplied string must be a prefix of a + if there is more than one job beginning with the string typed, + the job most recently accessed is selected. The _n_a_m_e of a + stopped job, in this context, is the command line used to start + it. If set to the value _e_x_a_c_t, the string supplied must match + the name of a stopped job exactly; if set to _s_u_b_s_t_r_i_n_g, the + string supplied needs to match a substring of the name of a + stopped job. The _s_u_b_s_t_r_i_n_g value provides functionality analo- + gous to the %%?? job identifier (see JJOOBB CCOONNTTRROOLL below). If set + to any other value, the supplied string must be a prefix of a stopped job's name; this provides functionality analogous to the %%_s_t_r_i_n_g job identifier. hhiissttcchhaarrss - The two or three characters which control history expansion and + The two or three characters which control history expansion and tokenization (see HHIISSTTOORRYY EEXXPPAANNSSIIOONN below). The first character - is the _h_i_s_t_o_r_y _e_x_p_a_n_s_i_o_n character, the character which signals - the start of a history expansion, normally `!!'. The second - character is the _q_u_i_c_k _s_u_b_s_t_i_t_u_t_i_o_n character, which is used as - shorthand for re-running the previous command entered, substi- - tuting one string for another in the command. The default is - `^^'. The optional third character is the character which indi- - cates that the remainder of the line is a comment when found as - the first character of a word, normally `##'. The history com- - ment character causes history substitution to be skipped for the - remaining words on the line. It does not necessarily cause the - shell parser to treat the rest of the line as a comment. + is the _h_i_s_t_o_r_y _e_x_p_a_n_s_i_o_n character, the character which signals + the start of a history expansion, normally `!!'. The second + character is the _q_u_i_c_k _s_u_b_s_t_i_t_u_t_i_o_n character, which is used as + shorthand for re-running the previous command entered, + substituting one string for another in the command. The default + is `^^'. The optional third character is the character which + indicates that the remainder of the line is a comment when found + as the first character of a word, normally `##'. The history + comment character causes history substitution to be skipped for + the remaining words on the line. It does not necessarily cause + the shell parser to treat the rest of the line as a comment. AArrrraayyss - BBaasshh provides one-dimensional array variables. Any variable may be + BBaasshh provides one-dimensional array variables. Any variable may be used as an array; the ddeeccllaarree builtin will explicitly declare an array. - There is no maximum limit on the size of an array, nor any requirement - that members be indexed or assigned contiguously. Arrays are indexed + There is no maximum limit on the size of an array, nor any requirement + that members be indexed or assigned contiguously. Arrays are indexed using integers and are zero-based. - An array is created automatically if any variable is assigned to using - the syntax _n_a_m_e[_s_u_b_s_c_r_i_p_t]=_v_a_l_u_e. The _s_u_b_s_c_r_i_p_t is treated as an - arithmetic expression that must evaluate to a number greater than or - equal to zero. To explicitly declare an array, use ddeeccllaarree --aa _n_a_m_e + An array is created automatically if any variable is assigned to using + the syntax _n_a_m_e[_s_u_b_s_c_r_i_p_t]=_v_a_l_u_e. The _s_u_b_s_c_r_i_p_t is treated as an + arithmetic expression that must evaluate to a number greater than or + equal to zero. To explicitly declare an array, use ddeeccllaarree --aa _n_a_m_e (see SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below). ddeeccllaarree --aa _n_a_m_e[[_s_u_b_s_c_r_i_p_t]] is also accepted; the _s_u_b_s_c_r_i_p_t is ignored. Attributes may be specified for an array variable using the ddeeccllaarree and rreeaaddoonnllyy builtins. Each attribute applies to all members of an array. - Arrays are assigned to using compound assignments of the form - _n_a_m_e=((value_1 ... value_n)), where each _v_a_l_u_e is of the form [_s_u_b_- + Arrays are assigned to using compound assignments of the form + _n_a_m_e=((value_1 ... value_n)), where each _v_a_l_u_e is of the form [_s_u_b_- _s_c_r_i_p_t]=_s_t_r_i_n_g. Only _s_t_r_i_n_g is required. If the optional brackets and - subscript are supplied, that index is assigned to; otherwise the index - of the element assigned is the last index assigned to by the statement - plus one. Indexing starts at zero. This syntax is also accepted by - the ddeeccllaarree builtin. Individual array elements may be assigned to + subscript are supplied, that index is assigned to; otherwise the index + of the element assigned is the last index assigned to by the statement + plus one. Indexing starts at zero. This syntax is also accepted by + the ddeeccllaarree builtin. Individual array elements may be assigned to using the _n_a_m_e[_s_u_b_s_c_r_i_p_t]=_v_a_l_u_e syntax introduced above. - Any element of an array may be referenced using ${_n_a_m_e[_s_u_b_s_c_r_i_p_t]}. + Any element of an array may be referenced using ${_n_a_m_e[_s_u_b_s_c_r_i_p_t]}. The braces are required to avoid conflicts with pathname expansion. If - _s_u_b_s_c_r_i_p_t is @@ or **, the word expands to all members of _n_a_m_e. These - subscripts differ only when the word appears within double quotes. If + _s_u_b_s_c_r_i_p_t is @@ or **, the word expands to all members of _n_a_m_e. These + subscripts differ only when the word appears within double quotes. If the word is double-quoted, ${_n_a_m_e[*]} expands to a single word with the - value of each array member separated by the first character of the IIFFSS + value of each array member separated by the first character of the IIFFSS special variable, and ${_n_a_m_e[@]} expands each element of _n_a_m_e to a sep- - arate word. When there are no array members, ${_n_a_m_e[@]} expands to - nothing. If the double-quoted expansion occurs within a word, the - expansion of the first parameter is joined with the beginning part of - the original word, and the expansion of the last parameter is joined - with the last part of the original word. This is analogous to the - expansion of the special parameters ** and @@ (see SSppeecciiaall PPaarraammeetteerrss - above). ${#_n_a_m_e[_s_u_b_s_c_r_i_p_t]} expands to the length of ${_n_a_m_e[_s_u_b_- - _s_c_r_i_p_t]}. If _s_u_b_s_c_r_i_p_t is ** or @@, the expansion is the number of ele- - ments in the array. Referencing an array variable without a subscript + arate word. When there are no array members, ${_n_a_m_e[@]} expands to + nothing. If the double-quoted expansion occurs within a word, the + expansion of the first parameter is joined with the beginning part of + the original word, and the expansion of the last parameter is joined + with the last part of the original word. This is analogous to the + expansion of the special parameters ** and @@ (see SSppeecciiaall PPaarraammeetteerrss + above). ${#_n_a_m_e[_s_u_b_s_c_r_i_p_t]} expands to the length of ${_n_a_m_e[_s_u_b_- + _s_c_r_i_p_t]}. If _s_u_b_s_c_r_i_p_t is ** or @@, the expansion is the number of ele- + ments in the array. Referencing an array variable without a subscript is equivalent to referencing element zero. - The uunnsseett builtin is used to destroy arrays. uunnsseett _n_a_m_e[_s_u_b_s_c_r_i_p_t] - destroys the array element at index _s_u_b_s_c_r_i_p_t. uunnsseett _n_a_m_e, where _n_a_m_e - is an array, or uunnsseett _n_a_m_e[_s_u_b_s_c_r_i_p_t], where _s_u_b_s_c_r_i_p_t is ** or @@, + The uunnsseett builtin is used to destroy arrays. uunnsseett _n_a_m_e[_s_u_b_s_c_r_i_p_t] + destroys the array element at index _s_u_b_s_c_r_i_p_t. uunnsseett _n_a_m_e, where _n_a_m_e + is an array, or uunnsseett _n_a_m_e[_s_u_b_s_c_r_i_p_t], where _s_u_b_s_c_r_i_p_t is ** or @@, removes the entire array. - The ddeeccllaarree, llooccaall, and rreeaaddoonnllyy builtins each accept a --aa option to - specify an array. The rreeaadd builtin accepts a --aa option to assign a - list of words read from the standard input to an array. The sseett and - ddeeccllaarree builtins display array values in a way that allows them to be + The ddeeccllaarree, llooccaall, and rreeaaddoonnllyy builtins each accept a --aa option to + specify an array. The rreeaadd builtin accepts a --aa option to assign a + list of words read from the standard input to an array. The sseett and + ddeeccllaarree builtins display array values in a way that allows them to be reused as assignments. EEXXPPAANNSSIIOONN Expansion is performed on the command line after it has been split into - words. There are seven kinds of expansion performed: _b_r_a_c_e _e_x_p_a_n_s_i_o_n, - _t_i_l_d_e _e_x_p_a_n_s_i_o_n, _p_a_r_a_m_e_t_e_r _a_n_d _v_a_r_i_a_b_l_e _e_x_p_a_n_s_i_o_n, _c_o_m_m_a_n_d _s_u_b_s_t_i_t_u_- + words. There are seven kinds of expansion performed: _b_r_a_c_e _e_x_p_a_n_s_i_o_n, + _t_i_l_d_e _e_x_p_a_n_s_i_o_n, _p_a_r_a_m_e_t_e_r _a_n_d _v_a_r_i_a_b_l_e _e_x_p_a_n_s_i_o_n, _c_o_m_m_a_n_d _s_u_b_s_t_i_t_u_- _t_i_o_n, _a_r_i_t_h_m_e_t_i_c _e_x_p_a_n_s_i_o_n, _w_o_r_d _s_p_l_i_t_t_i_n_g, and _p_a_t_h_n_a_m_e _e_x_p_a_n_s_i_o_n. - The order of expansions is: brace expansion, tilde expansion, parame- - ter, variable and arithmetic expansion and command substitution (done + The order of expansions is: brace expansion, tilde expansion, parame- + ter, variable and arithmetic expansion and command substitution (done in a left-to-right fashion), word splitting, and pathname expansion. On systems that can support it, there is an additional expansion avail- able: _p_r_o_c_e_s_s _s_u_b_s_t_i_t_u_t_i_o_n. Only brace expansion, word splitting, and pathname expansion can change - the number of words of the expansion; other expansions expand a single - word to a single word. The only exceptions to this are the expansions + the number of words of the expansion; other expansions expand a single + word to a single word. The only exceptions to this are the expansions of "$$@@" and "$${{_n_a_m_e[[@@]]}}" as explained above (see PPAARRAAMMEETTEERRSS). BBrraaccee EExxppaannssiioonn _B_r_a_c_e _e_x_p_a_n_s_i_o_n is a mechanism by which arbitrary strings may be gener- - ated. This mechanism is similar to _p_a_t_h_n_a_m_e _e_x_p_a_n_s_i_o_n, but the file- + ated. This mechanism is similar to _p_a_t_h_n_a_m_e _e_x_p_a_n_s_i_o_n, but the file- names generated need not exist. Patterns to be brace expanded take the form of an optional _p_r_e_a_m_b_l_e, followed by either a series of comma-sep- - arated strings or a sequence expression between a pair of braces, fol- - lowed by an optional _p_o_s_t_s_c_r_i_p_t. The preamble is prefixed to each + arated strings or a sequence expression between a pair of braces, fol- + lowed by an optional _p_o_s_t_s_c_r_i_p_t. The preamble is prefixed to each string contained within the braces, and the postscript is then appended to each resulting string, expanding left to right. - Brace expansions may be nested. The results of each expanded string - are not sorted; left to right order is preserved. For example, + Brace expansions may be nested. The results of each expanded string + are not sorted; left to right order is preserved. For example, a{{d,c,b}}e expands into `ade ace abe'. - A sequence expression takes the form {{_x...._y}}, where _x and _y are either + A sequence expression takes the form {{_x...._y}}, where _x and _y are either integers or single characters. When integers are supplied, the expres- - sion expands to each number between _x and _y, inclusive. When charac- - ters are supplied, the expression expands to each character lexico- + sion expands to each number between _x and _y, inclusive. When charac- + ters are supplied, the expression expands to each character lexico- graphically between _x and _y, inclusive. Note that both _x and _y must be of the same type. Brace expansion is performed before any other expansions, and any char- - acters special to other expansions are preserved in the result. It is - strictly textual. BBaasshh does not apply any syntactic interpretation to + acters special to other expansions are preserved in the result. It is + strictly textual. BBaasshh does not apply any syntactic interpretation to the context of the expansion or the text between the braces. - A correctly-formed brace expansion must contain unquoted opening and - closing braces, and at least one unquoted comma or a valid sequence - expression. Any incorrectly formed brace expansion is left unchanged. + A correctly-formed brace expansion must contain unquoted opening and + closing braces, and at least one unquoted comma or a valid sequence + expression. Any incorrectly formed brace expansion is left unchanged. A {{ or ,, may be quoted with a backslash to prevent its being considered - part of a brace expression. To avoid conflicts with parameter expan- + part of a brace expression. To avoid conflicts with parameter expan- sion, the string $${{ is not considered eligible for brace expansion. This construct is typically used as shorthand when the common prefix of @@ -1203,36 +1205,36 @@ EEXXPPAANNSSIIOONN or chown root /usr/{ucb/{ex,edit},lib/{ex?.?*,how_ex}} - Brace expansion introduces a slight incompatibility with historical - versions of sshh. sshh does not treat opening or closing braces specially - when they appear as part of a word, and preserves them in the output. - BBaasshh removes braces from words as a consequence of brace expansion. - For example, a word entered to sshh as _f_i_l_e_{_1_,_2_} appears identically in - the output. The same word is output as _f_i_l_e_1 _f_i_l_e_2 after expansion by - bbaasshh. If strict compatibility with sshh is desired, start bbaasshh with the + Brace expansion introduces a slight incompatibility with historical + versions of sshh. sshh does not treat opening or closing braces specially + when they appear as part of a word, and preserves them in the output. + BBaasshh removes braces from words as a consequence of brace expansion. + For example, a word entered to sshh as _f_i_l_e_{_1_,_2_} appears identically in + the output. The same word is output as _f_i_l_e_1 _f_i_l_e_2 after expansion by + bbaasshh. If strict compatibility with sshh is desired, start bbaasshh with the ++BB option or disable brace expansion with the ++BB option to the sseett com- mand (see SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below). TTiillddee EExxppaannssiioonn - If a word begins with an unquoted tilde character (`~~'), all of the - characters preceding the first unquoted slash (or all characters, if - there is no unquoted slash) are considered a _t_i_l_d_e_-_p_r_e_f_i_x. If none of - the characters in the tilde-prefix are quoted, the characters in the - tilde-prefix following the tilde are treated as a possible _l_o_g_i_n _n_a_m_e. - If this login name is the null string, the tilde is replaced with the - value of the shell parameter HHOOMMEE. If HHOOMMEE is unset, the home direc- - tory of the user executing the shell is substituted instead. Other- - wise, the tilde-prefix is replaced with the home directory associated + If a word begins with an unquoted tilde character (`~~'), all of the + characters preceding the first unquoted slash (or all characters, if + there is no unquoted slash) are considered a _t_i_l_d_e_-_p_r_e_f_i_x. If none of + the characters in the tilde-prefix are quoted, the characters in the + tilde-prefix following the tilde are treated as a possible _l_o_g_i_n _n_a_m_e. + If this login name is the null string, the tilde is replaced with the + value of the shell parameter HHOOMMEE. If HHOOMMEE is unset, the home direc- + tory of the user executing the shell is substituted instead. Other- + wise, the tilde-prefix is replaced with the home directory associated with the specified login name. - If the tilde-prefix is a `~+', the value of the shell variable PPWWDD + If the tilde-prefix is a `~+', the value of the shell variable PPWWDD replaces the tilde-prefix. If the tilde-prefix is a `~-', the value of - the shell variable OOLLDDPPWWDD, if it is set, is substituted. If the char- - acters following the tilde in the tilde-prefix consist of a number _N, - optionally prefixed by a `+' or a `-', the tilde-prefix is replaced + the shell variable OOLLDDPPWWDD, if it is set, is substituted. If the char- + acters following the tilde in the tilde-prefix consist of a number _N, + optionally prefixed by a `+' or a `-', the tilde-prefix is replaced with the corresponding element from the directory stack, as it would be displayed by the ddiirrss builtin invoked with the tilde-prefix as an argu- - ment. If the characters following the tilde in the tilde-prefix con- + ment. If the characters following the tilde in the tilde-prefix con- sist of a number without a leading `+' or `-', `+' is assumed. If the login name is invalid, or the tilde expansion fails, the word is @@ -1240,82 +1242,81 @@ EEXXPPAANNSSIIOONN Each variable assignment is checked for unquoted tilde-prefixes immedi- ately following a :: or the first ==. In these cases, tilde expansion is - also performed. Consequently, one may use file names with tildes in - assignments to PPAATTHH, MMAAIILLPPAATTHH, and CCDDPPAATTHH, and the shell assigns the + also performed. Consequently, one may use file names with tildes in + assignments to PPAATTHH, MMAAIILLPPAATTHH, and CCDDPPAATTHH, and the shell assigns the expanded value. PPaarraammeetteerr EExxppaannssiioonn The `$$' character introduces parameter expansion, command substitution, - or arithmetic expansion. The parameter name or symbol to be expanded - may be enclosed in braces, which are optional but serve to protect the - variable to be expanded from characters immediately following it which + or arithmetic expansion. The parameter name or symbol to be expanded + may be enclosed in braces, which are optional but serve to protect the + variable to be expanded from characters immediately following it which could be interpreted as part of the name. - When braces are used, the matching ending brace is the first `}}' not - escaped by a backslash or within a quoted string, and not within an + When braces are used, the matching ending brace is the first `}}' not + escaped by a backslash or within a quoted string, and not within an embedded arithmetic expansion, command substitution, or parameter expansion. ${_p_a_r_a_m_e_t_e_r} - The value of _p_a_r_a_m_e_t_e_r is substituted. The braces are required - when _p_a_r_a_m_e_t_e_r is a positional parameter with more than one + The value of _p_a_r_a_m_e_t_e_r is substituted. The braces are required + when _p_a_r_a_m_e_t_e_r is a positional parameter with more than one digit, or when _p_a_r_a_m_e_t_e_r is followed by a character which is not to be interpreted as part of its name. If the first character of _p_a_r_a_m_e_t_e_r is an exclamation point, a level of - variable indirection is introduced. BBaasshh uses the value of the vari- - able formed from the rest of _p_a_r_a_m_e_t_e_r as the name of the variable; - this variable is then expanded and that value is used in the rest of - the substitution, rather than the value of _p_a_r_a_m_e_t_e_r itself. This is + variable indirection is introduced. BBaasshh uses the value of the vari- + able formed from the rest of _p_a_r_a_m_e_t_e_r as the name of the variable; + this variable is then expanded and that value is used in the rest of + the substitution, rather than the value of _p_a_r_a_m_e_t_e_r itself. This is known as _i_n_d_i_r_e_c_t _e_x_p_a_n_s_i_o_n. The exceptions to this are the expansions - of ${!_p_r_e_f_i_x*} and ${!!_n_a_m_e[_@]} described below. The exclamation point - must immediately follow the left brace in order to introduce indirec- + of ${!_p_r_e_f_i_x*} and ${!!_n_a_m_e[_@]} described below. The exclamation point + must immediately follow the left brace in order to introduce indirec- tion. In each of the cases below, _w_o_r_d is subject to tilde expansion, parame- - ter expansion, command substitution, and arithmetic expansion. When - not performing substring expansion, bbaasshh tests for a parameter that is - unset or null; omitting the colon results in a test only for a parame- + ter expansion, command substitution, and arithmetic expansion. When + not performing substring expansion, bbaasshh tests for a parameter that is + unset or null; omitting the colon results in a test only for a parame- ter that is unset. ${_p_a_r_a_m_e_t_e_r::--_w_o_r_d} - UUssee DDeeffaauulltt VVaalluueess. If _p_a_r_a_m_e_t_e_r is unset or null, the expan- - sion of _w_o_r_d is substituted. Otherwise, the value of _p_a_r_a_m_e_t_e_r + UUssee DDeeffaauulltt VVaalluueess. If _p_a_r_a_m_e_t_e_r is unset or null, the expan- + sion of _w_o_r_d is substituted. Otherwise, the value of _p_a_r_a_m_e_t_e_r is substituted. ${_p_a_r_a_m_e_t_e_r::==_w_o_r_d} - AAssssiiggnn DDeeffaauulltt VVaalluueess. If _p_a_r_a_m_e_t_e_r is unset or null, the + AAssssiiggnn DDeeffaauulltt VVaalluueess. If _p_a_r_a_m_e_t_e_r is unset or null, the expansion of _w_o_r_d is assigned to _p_a_r_a_m_e_t_e_r. The value of _p_a_r_a_m_- - _e_t_e_r is then substituted. Positional parameters and special + _e_t_e_r is then substituted. Positional parameters and special parameters may not be assigned to in this way. ${_p_a_r_a_m_e_t_e_r::??_w_o_r_d} - DDiissppllaayy EErrrroorr iiff NNuullll oorr UUnnsseett. If _p_a_r_a_m_e_t_e_r is null or unset, - the expansion of _w_o_r_d (or a message to that effect if _w_o_r_d is - not present) is written to the standard error and the shell, if + DDiissppllaayy EErrrroorr iiff NNuullll oorr UUnnsseett. If _p_a_r_a_m_e_t_e_r is null or unset, + the expansion of _w_o_r_d (or a message to that effect if _w_o_r_d is + not present) is written to the standard error and the shell, if it is not interactive, exits. Otherwise, the value of _p_a_r_a_m_e_t_e_r is substituted. ${_p_a_r_a_m_e_t_e_r::++_w_o_r_d} - UUssee AAlltteerrnnaattee VVaalluuee. If _p_a_r_a_m_e_t_e_r is null or unset, nothing is + UUssee AAlltteerrnnaattee VVaalluuee. If _p_a_r_a_m_e_t_e_r is null or unset, nothing is substituted, otherwise the expansion of _w_o_r_d is substituted. ${_p_a_r_a_m_e_t_e_r::_o_f_f_s_e_t} ${_p_a_r_a_m_e_t_e_r::_o_f_f_s_e_t::_l_e_n_g_t_h} - SSuubbssttrriinngg EExxppaannssiioonn.. Expands to up to _l_e_n_g_t_h characters of - _p_a_r_a_m_e_t_e_r starting at the character specified by _o_f_f_s_e_t. If - _l_e_n_g_t_h is omitted, expands to the substring of _p_a_r_a_m_e_t_e_r - starting at the character specified by _o_f_f_s_e_t. _l_e_n_g_t_h and _o_f_f_- - _s_e_t are arithmetic expressions (see AARRIITTHHMMEETTIICC EEVVAALLUUAATTIIOONN - below). _l_e_n_g_t_h must evaluate to a number greater than or equal - to zero. If _o_f_f_s_e_t evaluates to a number less than zero, the - value is used as an offset from the end of the value of _p_a_r_a_m_e_- - _t_e_r. If _p_a_r_a_m_e_t_e_r is @@, the result is _l_e_n_g_t_h positional parame- - ters beginning at _o_f_f_s_e_t. If _p_a_r_a_m_e_t_e_r is an array name indexed - by @ or *, the result is the _l_e_n_g_t_h members of the array begin- - ning with ${_p_a_r_a_m_e_t_e_r[_o_f_f_s_e_t]}. A negative _o_f_f_s_e_t is taken rel- - ative to one greater than the maximum index of the specified - array. Note that a negative offset must be separated from the - colon by at least one space to avoid being confused with the :- - expansion. Substring indexing is zero-based unless the posi- - tional parameters are used, in which case the indexing starts at - 1. + SSuubbssttrriinngg EExxppaannssiioonn.. Expands to up to _l_e_n_g_t_h characters of + _p_a_r_a_m_e_t_e_r starting at the character specified by _o_f_f_s_e_t. If + _l_e_n_g_t_h is omitted, expands to the substring of _p_a_r_a_m_e_t_e_r start- + ing at the character specified by _o_f_f_s_e_t. _l_e_n_g_t_h and _o_f_f_s_e_t are + arithmetic expressions (see AARRIITTHHMMEETTIICC EEVVAALLUUAATTIIOONN below). + _l_e_n_g_t_h must evaluate to a number greater than or equal to zero. + If _o_f_f_s_e_t evaluates to a number less than zero, the value is + used as an offset from the end of the value of _p_a_r_a_m_e_t_e_r. If + _p_a_r_a_m_e_t_e_r is @@, the result is _l_e_n_g_t_h positional parameters + beginning at _o_f_f_s_e_t. If _p_a_r_a_m_e_t_e_r is an array name indexed by @ + or *, the result is the _l_e_n_g_t_h members of the array beginning + with ${_p_a_r_a_m_e_t_e_r[_o_f_f_s_e_t]}. A negative _o_f_f_s_e_t is taken relative + to one greater than the maximum index of the specified array. + Note that a negative offset must be separated from the colon by + at least one space to avoid being confused with the :- expan- + sion. Substring indexing is zero-based unless the positional + parameters are used, in which case the indexing starts at 1. ${!!_p_r_e_f_i_x**} ${!!_p_r_e_f_i_x@@} @@ -1368,8 +1369,8 @@ EEXXPPAANNSSIIOONN ${_p_a_r_a_m_e_t_e_r//_p_a_t_t_e_r_n//_s_t_r_i_n_g} ${_p_a_r_a_m_e_t_e_r////_p_a_t_t_e_r_n//_s_t_r_i_n_g} The _p_a_t_t_e_r_n is expanded to produce a pattern just as in pathname - expansion. _P_a_r_a_m_e_t_e_r is expanded and the longest match of _p_a_t_- - _t_e_r_n against its value is replaced with _s_t_r_i_n_g. In the first + expansion. _P_a_r_a_m_e_t_e_r is expanded and the longest match of + _p_a_t_t_e_r_n against its value is replaced with _s_t_r_i_n_g. In the first form, only the first match is replaced. The second form causes all matches of _p_a_t_t_e_r_n to be replaced with _s_t_r_i_n_g. If _p_a_t_t_e_r_n begins with ##, it must match at the beginning of the expanded @@ -3105,11 +3106,11 @@ RREEAADDLLIINNEE ered. The string is first split using the characters in the IIFFSS spe- cial variable as delimiters. Shell quoting is honored. Each word is then expanded using brace expansion, tilde expansion, parameter and - variable expansion, command substitution, arithmetic expansion, and - pathname expansion, as described above under EEXXPPAANNSSIIOONN. The results - are split using the rules described above under WWoorrdd SSpplliittttiinngg. The - results of the expansion are prefix-matched against the word being com- - pleted, and the matching words become the possible completions. + variable expansion, command substitution, and arithmetic expansion, as + described above under EEXXPPAANNSSIIOONN. The results are split using the rules + described above under WWoorrdd SSpplliittttiinngg. The results of the expansion are + prefix-matched against the word being completed, and the matching words + become the possible completions. After these matches have been generated, any shell function or command specified with the --FF and --CC options is invoked. When the command or @@ -3452,8 +3453,8 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS _d_i_r begins with a slash (/), then CCDDPPAATTHH is not used. The --PP option says to use the physical directory structure instead of following symbolic links (see also the --PP option to the sseett - builtin command); the --LL option forces symbolic links to be fol- - lowed. An argument of -- is equivalent to $$OOLLDDPPWWDD. If a non- + builtin command); the --LL option forces symbolic links to be + followed. An argument of -- is equivalent to $$OOLLDDPPWWDD. If a non- empty directory name from CCDDPPAATTHH is used, or if -- is the first argument, and the directory change is successful, the absolute pathname of the new working directory is written to the standard @@ -4312,8 +4313,8 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS with a --. -- Signal the end of options, cause all remaining _a_r_gs to be assigned to the positional parameters. The --xx and --vv - options are turned off. If there are no _a_r_gs, the posi- - tional parameters remain unchanged. + options are turned off. If there are no _a_r_gs, the + positional parameters remain unchanged. The options are off by default unless otherwise noted. Using + rather than - causes these options to be turned off. The @@ -4366,11 +4367,11 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS whose value is the directory to change to. ccddssppeellll If set, minor errors in the spelling of a directory com- ponent in a ccdd command will be corrected. The errors - checked for are transposed characters, a missing - character, and one character too many. If a correction - is found, the corrected file name is printed, and the - command proceeds. This option is only used by interac- - tive shells. + checked for are transposed characters, a missing charac- + ter, and one character too many. If a correction is + found, the corrected file name is printed, and the com- + mand proceeds. This option is only used by interactive + shells. cchheecckkhhaasshh If set, bbaasshh checks that a command found in the hash ta- ble exists before trying to execute it. If a hashed @@ -4836,4 +4837,4 @@ BBUUGGSS -GNU Bash-3.1-devel 2004 Dec 22 BASH(1) +GNU Bash-3.1-devel 2005 Feb 11 BASH(1) diff --git a/doc/bash.1 b/doc/bash.1 index a12d691c5..abf2a50a4 100644 --- a/doc/bash.1 +++ b/doc/bash.1 @@ -6,12 +6,12 @@ .\" Case Western Reserve University .\" chet@po.CWRU.Edu .\" -.\" Last Change: Fri Feb 11 15:43:40 EST 2005 +.\" Last Change: Sat Feb 19 17:38:29 EST 2005 .\" .\" bash_builtins, strip all but Built-Ins section .if \n(zZ=1 .ig zZ .if \n(zY=1 .ig zY -.TH BASH 1 "2005 Feb 11" "GNU Bash-3.1-devel" +.TH BASH 1 "2005 Feb 19" "GNU Bash-3.1-devel" .\" .\" There's some problem with having a `@' .\" in a tagged paragraph with the BSD man macros. @@ -154,11 +154,13 @@ single-character options to be recognized. .TP .B \-\-debugger Arrange for the debugger profile to be executed before the shell -starts. Turns on extended debugging mode (see the description of the +starts. +Turns on extended debugging mode (see the description of the .B extdebug option to the .B shopt -builtin below) and shell function tracing (see the description of the +builtin below) +and shell function tracing (see the description of the \fB\-o functrace\fP option to the .B set builtin below). @@ -669,6 +671,10 @@ as primaries. When the \fB==\fP and \fB!=\fP operators are used, the string to the right of the operator is considered a pattern and matched according to the rules described below under \fBPattern Matching\fP. +If the shell option +.B nocasematch +is enabled, the match is performed without regard to the case +of alphabetic characters. The return value is 0 if the string matches or does not match the pattern, respectively, and 1 otherwise. Any part of the pattern may be quoted to force it to be matched as a @@ -684,7 +690,7 @@ the pattern, and 1 otherwise. If the regular expression is syntactically incorrect, the conditional expression's return value is 2. If the shell option -.B nocaseglob +.B nocasematch is enabled, the match is performed without regard to the case of alphabetic characters. Substrings matched by parenthesized subexpressions within the regular @@ -798,7 +804,12 @@ A \fBcase\fP command first expands \fIword\fP, and tries to match it against each \fIpattern\fP in turn, using the same matching rules as for pathname expansion (see .B Pathname Expansion -below). When a match is found, the +below). +If the shell option +.B nocasematch +is enabled, the match is performed without regard to the case +of alphabetic characters. +When a match is found, the corresponding \fIlist\fP is executed. After the first match, no subsequent matches are attempted. The exit status is zero if no pattern matches. Otherwise, it is the exit status of the @@ -1227,11 +1238,18 @@ Expands to the full file name used to invoke this instance of .TP .B BASH_ARGC An array variable whose values are the number of parameters in each -frame of the current bash execution call stack. The number of +frame of the current bash execution call stack. +The number of parameters to the current subroutine (shell function or script executed -with \fB.\fP or \fBsource\fP) is at the top of the stack. When a -subroutine is executed, the number of parameters passed is pushed onto +with \fB.\fP or \fBsource\fP) is at the top of the stack. +When a subroutine is executed, the number of parameters passed is pushed onto \fBBASH_ARGC\fP. +The shell sets \fBBASH_ARGC\fP only when in extended debugging mode +(see the description of the +.B extdebug +option to the +.B shopt +builtin below) .TP .B BASH_ARGV An array variable containing all of the parameters in the current bash @@ -1239,6 +1257,12 @@ execution call stack. The final parameter of the last subroutine call is at the top of the stack; the first parameter of the initial call is at the bottom. When a subroutine is executed, the parameters supplied are pushed onto \fBBASH_ARGV\fP. +The shell sets \fBBASH_ARGV\fP only when in extended debugging mode +(see the description of the +.B extdebug +option to the +.B shopt +builtin below) .TP .B BASH_COMMAND The command currently being executed or about to be executed, unless the @@ -7970,6 +7994,20 @@ If the command run by the \fBDEBUG\fP trap returns a value of 2, and the shell is executing in a subroutine (a shell function or a shell script executed by the \fB.\fP or \fBsource\fP builtins), a call to \fBreturn\fP is simulated. +.TP +.B 4. +\fBBASH_ARGC\fP and \fBBASH_ARGV\fP are updated as described in their +descriptions above. +.TP +.B 5. +Function tracing is enabled: command substitution, shell functions, and +subshells invoked with \fB(\fP \fIcommand\fP \fB)\fP inherit the +\fBDEBUG\fP and \fBRETURN\fP traps. +.TP +.B 6. +Error tracing is enabled: command substitution, shell functions, and +subshells invoked with \fB(\fP \fIcommand\fP \fB)\fP inherit the +\fBERROR\fP trap. .RE .TP 8 .B extglob @@ -8079,6 +8117,12 @@ expansion (see .B Pathname Expansion above). .TP 8 +.B nocasematch +If set, +.B bash +matches patterns in a case\-insensitive fashion when performing matching +while executing \fBcase\fP or \fB[[\fP conditional commands. +.TP 8 .B nullglob If set, .B bash diff --git a/doc/bash.1~ b/doc/bash.1~ index 614724503..d7f9aa202 100644 --- a/doc/bash.1~ +++ b/doc/bash.1~ @@ -6,12 +6,12 @@ .\" Case Western Reserve University .\" chet@po.CWRU.Edu .\" -.\" Last Change: Tue Jan 4 17:23:59 EST 2005 +.\" Last Change: Sat Feb 19 17:38:29 EST 2005 .\" .\" bash_builtins, strip all but Built-Ins section .if \n(zZ=1 .ig zZ .if \n(zY=1 .ig zY -.TH BASH 1 "2005 Jan 4" "GNU Bash-3.1-devel" +.TH BASH 1 "2005 Feb 19" "GNU Bash-3.1-devel" .\" .\" There's some problem with having a `@' .\" in a tagged paragraph with the BSD man macros. @@ -154,11 +154,13 @@ single-character options to be recognized. .TP .B \-\-debugger Arrange for the debugger profile to be executed before the shell -starts. Turns on extended debugging mode (see the description of the +starts. +Turns on extended debugging mode (see the description of the .B extdebug option to the .B shopt -builtin below) and shell function tracing (see the description of the +builtin below) +and shell function tracing (see the description of the \fB\-o functrace\fP option to the .B set builtin below). @@ -669,6 +671,10 @@ as primaries. When the \fB==\fP and \fB!=\fP operators are used, the string to the right of the operator is considered a pattern and matched according to the rules described below under \fBPattern Matching\fP. +If the shell option +.B nocasematch +is enabled, the match is performed without regard to the case +of alphabetic characters. The return value is 0 if the string matches or does not match the pattern, respectively, and 1 otherwise. Any part of the pattern may be quoted to force it to be matched as a @@ -684,7 +690,7 @@ the pattern, and 1 otherwise. If the regular expression is syntactically incorrect, the conditional expression's return value is 2. If the shell option -.B nocaseglob +.B nocasematch is enabled, the match is performed without regard to the case of alphabetic characters. Substrings matched by parenthesized subexpressions within the regular @@ -798,7 +804,12 @@ A \fBcase\fP command first expands \fIword\fP, and tries to match it against each \fIpattern\fP in turn, using the same matching rules as for pathname expansion (see .B Pathname Expansion -below). When a match is found, the +below). +If the shell option +.B nocasematch +is enabled, the match is performed without regard to the case +of alphabetic characters. +When a match is found, the corresponding \fIlist\fP is executed. After the first match, no subsequent matches are attempted. The exit status is zero if no pattern matches. Otherwise, it is the exit status of the @@ -1205,12 +1216,13 @@ to the file name used to invoke as given by argument zero. .TP .B _ -At shell startup, set to the absolute file name of the shell or shell -script being executed as passed in the argument list. +At shell startup, set to the absolute pathname used to invoke the +shell or shell script being executed as passed in the environment +or argument list. Subsequently, expands to the last argument to the previous command, after expansion. -Also set to the full file name of each command executed and placed in -the environment exported to that command. +Also set to the full pathname used to invoke each command executed +and placed in the environment exported to that command. When checking mail, this parameter holds the name of the mail file currently being checked. .PD @@ -1226,11 +1238,18 @@ Expands to the full file name used to invoke this instance of .TP .B BASH_ARGC An array variable whose values are the number of parameters in each -frame of the current bash execution call stack. The number of +frame of the current bash execution call stack. +The number of parameters to the current subroutine (shell function or script executed -with \fB.\fP or \fBsource\fP) is at the top of the stack. When a -subroutine is executed, the number of parameters passed is pushed onto +with \fB.\fP or \fBsource\fP) is at the top of the stack. +When a subroutine is executed, the number of parameters passed is pushed onto \fBBASH_ARGC\fP. +The shell sets \fBBASH_ARGC\fP only when in extended debugging mode +(see the description of the +.B extdebug +option to the +.B shopt +builtin below) .TP .B BASH_ARGV An array variable containing all of the parameters in the current bash @@ -1238,6 +1257,12 @@ execution call stack. The final parameter of the last subroutine call is at the top of the stack; the first parameter of the initial call is at the bottom. When a subroutine is executed, the parameters supplied are pushed onto \fBBASH_ARGV\fP. +The shell sets \fBBASH_ARGV\fP only when in extended debugging mode +(see the description of the +.B extdebug +option to the +.B shopt +builtin below) .TP .B BASH_COMMAND The command currently being executed or about to be executed, unless the @@ -7969,6 +7994,20 @@ If the command run by the \fBDEBUG\fP trap returns a value of 2, and the shell is executing in a subroutine (a shell function or a shell script executed by the \fB.\fP or \fBsource\fP builtins), a call to \fBreturn\fP is simulated. +.TP +.B 4. +\fBBASH_ARGC\fP and \fBBASH_ARGV\fP are updated as described in their +descriptions above. +.TP +.B 5. +Function tracing is enabled: command substitution, shell functions, and +subshells invoked with \fB(\fP \fIcommand\fP \fB)\fP inherit the +\fBDEBUG\fP and \fBRETURN\fP traps. +.TP +.B 6. +Error tracing is enabled: command substitution, shell functions, and +subshells invoked with \fB(\fP \fIcommand\fP \fB)\fP inherit the +\fBERROR\fP trap. .RE .TP 8 .B extglob diff --git a/doc/bash.html b/doc/bash.html index dc027b7cb..c98237abe 100644 --- a/doc/bash.html +++ b/doc/bash.html @@ -2,7 +2,7 @@ BASH(1) Manual Page -
BASH(1)2004 Dec 22BASH(1) +BASH(1)2005 Feb 11BASH(1)

Index
@@ -40,7 +40,7 @@ bash - GNU Bourne-Again SHell

COPYRIGHT

-Bash is Copyright © 1989-2004 by the Free Software Foundation, Inc. +Bash is Copyright © 1989-2005 by the Free Software Foundation, Inc.  

DESCRIPTION

@@ -1573,12 +1573,13 @@ as given by argument zero.
_
-At shell startup, set to the absolute file name of the shell or shell -script being executed as passed in the argument list. +At shell startup, set to the absolute pathname used to invoke the +shell or shell script being executed as passed in the environment +or argument list. Subsequently, expands to the last argument to the previous command, after expansion. -Also set to the full file name of each command executed and placed in -the environment exported to that command. +Also set to the full pathname used to invoke each command executed +and placed in the environment exported to that command. When checking mail, this parameter holds the name of the mail file currently being checked. @@ -7014,7 +7015,7 @@ special variable as delimiters. Shell quoting is honored. Each word is then expanded using brace expansion, tilde expansion, parameter and variable expansion, -command substitution, arithmetic expansion, and pathname expansion, +command substitution, and arithmetic expansion, as described above under EXPANSION. @@ -11428,6 +11429,6 @@ Array variables may not (yet) be exported.
This document was created by man2html from bash.1.
-Time: 30 December 2004 17:01:32 EST +Time: 14 February 2005 11:56:43 EST diff --git a/doc/bash.ps b/doc/bash.ps index 281271df5..102594522 100644 --- a/doc/bash.ps +++ b/doc/bash.ps @@ -1,6 +1,6 @@ %!PS-Adobe-3.0 %%Creator: groff version 1.18.1 -%%CreationDate: Thu Dec 30 17:01:21 2004 +%%CreationDate: Mon Feb 14 11:56:35 2005 %%DocumentNeededResources: font Times-Roman %%+ font Times-Bold %%+ font Times-Italic @@ -10,7 +10,7 @@ %%+ font Palatino-Italic %%+ font Palatino-Bold %%DocumentSuppliedResources: procset grops 1.18 1 -%%Pages: 64 +%%Pages: 65 %%PageOrder: Ascend %%Orientation: Portrait %%EndComments @@ -225,12 +225,17 @@ ENC0/Courier RE/Times-Italic@0 ENC0/Times-Italic RE/Times-Bold@0 ENC0 %%BeginPageSetup BP %%EndPageSetup +/F0 10/Times-Roman@0 SF(1)535 768 Q 0 Cg EP +%%Page: 1 2 +%%BeginPageSetup +BP +%%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S 389.54(SH\(1\) B).35 F(ASH\(1\)) -.35 E/F1 10.95/Times-Bold@0 SF -.219(NA)72 84 S(ME).219 E F0 (bash \255 GNU Bourne-Ag)108 96 Q(ain SHell)-.05 E F1(SYNOPSIS)72 112.8 Q/F2 10/Times-Bold@0 SF(bash)108 124.8 Q F0([options] [\214le])2.5 E F1 (COPYRIGHT)72 141.6 Q F0(Bash is Cop)108 153.6 Q -(yright \251 1989-2004 by the Free Softw)-.1 E(are F)-.1 E +(yright \251 1989-2005 by the Free Softw)-.1 E(are F)-.1 E (oundation, Inc.)-.15 E F1(DESCRIPTION)72 170.4 Q F2(Bash)108 182.4 Q F0 .973(is an)3.474 F F2(sh)3.473 E F0 .973 (-compatible command language interpreter that e)B -.15(xe)-.15 G .973 @@ -321,9 +326,9 @@ E F2(po)2.5 E F0(\(portable object\) \214le format.)2.5 E F2 144 686.4 Q .3 -.15(ve \()-.25 H(see).15 E F4(INV)2.5 E(OCA)-.405 E (TION)-.855 E F0(belo)2.25 E(w\).)-.25 E F2(\255\255login)108 703.2 Q F0 (Equi)144 715.2 Q -.25(va)-.25 G(lent to).25 E F22.5 E F0(.)A -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22) --123.87 E(1)203.45 E 0 Cg EP -%%Page: 2 2 +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11) +-124.42 E(1)204 E 0 Cg EP +%%Page: 2 3 %%BeginPageSetup BP %%EndPageSetup @@ -444,9 +449,9 @@ F(ariable)-.25 E F3 -.27(BA)108 679.2 S(SH_ENV).27 E F0 1.01(in the en) 108 727.2 S 2.5(tt).2 G(he v)-2.5 E(alue of the)-.25 E F3 -.666(PA)2.5 G (TH)-.189 E F0 -.25(va)2.25 G (riable is not used to search for the \214le name.).25 E -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22) --123.87 E(2)203.45 E 0 Cg EP -%%Page: 3 3 +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11) +-124.42 E(2)204 E 0 Cg EP +%%Page: 3 4 %%BeginPageSetup BP %%EndPageSetup @@ -570,9 +575,9 @@ F1(Pipelines)87 679.2 Q F0(A)108 691.2 Q F2(pipeline)2.919 E F0 .419 F F1(|)2.92 E F0 5.42(.T)C .42(he format for a pipeline)-5.42 F(is:)108 703.2 Q([)144 720 Q F1(time)A F0([)2.5 E F1A F0(]] [ ! ])A F2 (command)2.5 E F0([)2.5 E F1(|)2.5 E F2(command2)2.5 E F0(... ])2.5 E -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22) --123.87 E(3)203.45 E 0 Cg EP -%%Page: 4 4 +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11) +-124.42 E(3)204 E 0 Cg EP +%%Page: 4 5 %%BeginPageSetup BP %%EndPageSetup @@ -691,9 +696,9 @@ A({)108 573.6 Q F1(list)2.5 E F0 2.5(;})C F1(list)3.89 E F0 .402 F(SIONS)144 727.2 Q F5(.)A F0 -.8(Wo)5.633 G 1.133 (rd splitting and pathname e).8 F 1.133 (xpansion are not performed on the w)-.15 F 1.133(ords between the)-.1 F -F3([[)3.632 E F0(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87(l2).15 G -(004 Dec 22)-123.87 E(4)203.45 E 0 Cg EP -%%Page: 5 5 +F3([[)3.632 E F0(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G +(005 Feb 11)-124.42 E(4)204 E 0 Cg EP +%%Page: 5 6 %%BeginPageSetup BP %%EndPageSetup @@ -831,9 +836,9 @@ F F2(name)144 727.2 Q F0 .759(to be set to null.)3.439 F .759 (The line read is sa)5.759 F -.15(ve)-.2 G 3.26(di).15 G 3.26(nt)-3.26 G .76(he v)-3.26 F(ariable)-.25 E F1(REPL)3.26 E(Y)-.92 E F0 5.76(.T)C(he) -5.76 E F2(list)3.35 E F0 .76(is e)3.94 F -.15(xe)-.15 G .76 -(cuted after).15 F(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87(l2).15 -G(004 Dec 22)-123.87 E(5)203.45 E 0 Cg EP -%%Page: 6 6 +(cuted after).15 F(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 +G(005 Feb 11)-124.42 E(5)204 E 0 Cg EP +%%Page: 6 7 %%BeginPageSetup BP %%EndPageSetup @@ -969,9 +974,9 @@ E -.15(ve)-.25 G(nt history e).15 E(xpansion.)-.15 E G(he)-2.974 E F2 .474(escape c)2.974 F(har)-.15 E(acter)-.15 E F0 5.474 (.I).73 G 2.974(tp)-5.474 G(reserv)-2.974 E .474(es the literal v)-.15 F .474(alue of the ne)-.25 F .474(xt character that)-.15 F -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22) --123.87 E(6)203.45 E 0 Cg EP -%%Page: 7 7 +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11) +-124.42 E(6)204 E 0 Cg EP +%%Page: 7 8 %%BeginPageSetup BP %%EndPageSetup @@ -1092,9 +1097,9 @@ E F0(,)A F1(export)3.648 E F0(,)A F1 -.18(re)108 700.8 S(adonly).18 E F0 (operator can be used to append to or add to the v)108 729.6 R(ariable') -.25 E 2.757(sp)-.55 G(re)-2.757 E .257(vious v)-.25 F 2.757(alue. When) -.25 F .257(+= is applied to a v)2.757 F(ariable)-.25 E(GNU Bash-3.1-de) -72 768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22)-123.87 E(7)203.45 E -0 Cg EP -%%Page: 8 8 +72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11)-124.42 E(7)204 E 0 +Cg EP +%%Page: 8 9 %%BeginPageSetup BP %%EndPageSetup @@ -1190,23 +1195,24 @@ F0 .578(is started with the)3.078 F F23.078 E F0 .369 (-)-.2 E(wise, it is set to the \214le name used to in)144 530.4 Q -.2 (vo)-.4 G -.1(ke).2 G F2(bash)2.6 E F0 2.5(,a)C 2.5(sg)-2.5 G -2.15 -.25 (iv e)-2.5 H 2.5(nb).25 G 2.5(ya)-2.5 G -.18(rg)-2.5 G(ument zero.).18 E -F2(_)108 542.4 Q F0 .1(At shell startup, set to the absolute \214le nam\ -e of the shell or shell script being e)31 F -.15(xe)-.15 G .1 -(cuted as passed in).15 F 1.706(the ar)144 554.4 R 1.706(gument list.) --.18 F(Subsequently)6.706 E 4.206(,e)-.65 G 1.705(xpands to the last ar) --4.356 F 1.705(gument to the pre)-.18 F 1.705(vious command, after)-.25 -F -.15(ex)144 566.4 S 2.515(pansion. Also).15 F .016 -(set to the full \214le name of each command e)2.515 F -.15(xe)-.15 G -.016(cuted and placed in the en).15 F(vironment)-.4 E -.15(ex)144 578.4 -S 1.006(ported to that command.).15 F 1.006 -(When checking mail, this parameter holds the name of the mail \214le) -6.006 F(currently being check)144 590.4 Q(ed.)-.1 E F2(Shell V)87 607.2 -Q(ariables)-.92 E F0(The follo)108 619.2 Q(wing v)-.25 E -(ariables are set by the shell:)-.25 E F2 -.3(BA)108 636 S(SH).3 E F0 -(Expands to the full \214le name used to in)9.07 E -.2(vo)-.4 G .2 -.1 -(ke t).2 H(his instance of).1 E F2(bash)2.5 E F0(.)A F2 -.3(BA)108 648 S -(SH_ARGC).3 E F0 1.039(An array v)144 660 R 1.039(ariable whose v)-.25 F -1.039 +F2(_)108 542.4 Q F0 .054 +(At shell startup, set to the absolute pathname used to in)31 F -.2(vo) +-.4 G .255 -.1(ke t).2 H .055(he shell or shell script being e).1 F -.15 +(xe)-.15 G(cuted).15 E .692(as passed in the en)144 554.4 R .692 +(vironment or ar)-.4 F .691(gument list.)-.18 F(Subsequently)5.691 E +3.191(,e)-.65 G .691(xpands to the last ar)-3.341 F .691(gument to the) +-.18 F(pre)144 566.4 Q .57(vious command, after e)-.25 F 3.07 +(xpansion. Also)-.15 F .571(set to the full pathname used to in)3.071 F +-.2(vo)-.4 G .771 -.1(ke e).2 H .571(ach command).1 F -.15(exe)144 578.4 +S 1.6(cuted and placed in the en).15 F 1.6(vironment e)-.4 F 1.6 +(xported to that command.)-.15 F 1.6(When checking mail, this)6.6 F +(parameter holds the name of the mail \214le currently being check)144 +590.4 Q(ed.)-.1 E F2(Shell V)87 607.2 Q(ariables)-.92 E F0(The follo)108 +619.2 Q(wing v)-.25 E(ariables are set by the shell:)-.25 E F2 -.3(BA) +108 636 S(SH).3 E F0(Expands to the full \214le name used to in)9.07 E +-.2(vo)-.4 G .2 -.1(ke t).2 H(his instance of).1 E F2(bash)2.5 E F0(.)A +F2 -.3(BA)108 648 S(SH_ARGC).3 E F0 1.039(An array v)144 660 R 1.039 +(ariable whose v)-.25 F 1.039 (alues are the number of parameters in each frame of the current bash) -.25 F -.15(exe)144 672 S .535(cution call stack.).15 F .535(The number\ of parameters to the current subroutine \(shell function or script) @@ -1216,8 +1222,8 @@ Q(ariables)-.92 E F0(The follo)108 619.2 Q(wing v)-.25 E (When a subroutine is e)5.142 F -.15(xe)-.15 G .142 (cuted, the number of).15 F(parameters passed is pushed onto)144 696 Q F2 -.3(BA)2.5 G(SH_ARGC).3 E F0(.)A(GNU Bash-3.1-de)72 768 Q -.15(ve) --.25 G 123.87(l2).15 G(004 Dec 22)-123.87 E(8)203.45 E 0 Cg EP -%%Page: 9 9 +-.25 G 124.42(l2).15 G(005 Feb 11)-124.42 E(8)204 E 0 Cg EP +%%Page: 9 10 %%BeginPageSetup BP %%EndPageSetup @@ -1310,9 +1316,9 @@ F .667(If the)5.667 F .535 F(in)144 697.2 Q -.2(vo)-.4 G -.1(ke).2 G 2.5(db).1 G 2.5(yt)-2.5 G (he programmable completion f)-2.5 E(acilities \(see)-.1 E F1(Pr)2.5 E (ogrammable Completion)-.18 E F0(belo)2.5 E(w\).)-.25 E(GNU Bash-3.1-de) -72 768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22)-123.87 E(9)203.45 E -0 Cg EP -%%Page: 10 10 +72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11)-124.42 E(9)204 E 0 +Cg EP +%%Page: 10 11 %%BeginPageSetup BP %%EndPageSetup @@ -1404,9 +1410,9 @@ F1(cd)2.5 E F0(command.)2.5 E F1(OPT)108 681.6 Q(ARG)-.9 E F0 1.627 (gument processed by the)-.18 F F1(getopts)4.127 E F0 -.2(bu)4.127 G 1.626(iltin command \(see).2 F F2(SHELL)4.126 E -.09(BU)144 705.6 S(IL) .09 E(TIN COMMANDS)-.828 E F0(belo)2.25 E(w\).)-.25 E(GNU Bash-3.1-de)72 -768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22)-123.87 E(10)198.45 E 0 -Cg EP -%%Page: 11 11 +768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11)-124.42 E(10)199 E 0 Cg +EP +%%Page: 11 12 %%BeginPageSetup BP %%EndPageSetup @@ -1500,9 +1506,9 @@ en printing selection lists.).2 F (in)144 705.6 Q -.2(vo)-.4 G -.1(ke).2 G 2.5(db).1 G 2.5(yt)-2.5 G (he programmable completion f)-2.5 E(acility \(see)-.1 E F1(Pr)2.5 E (ogrammable Completion)-.18 E F0(belo)2.5 E(w\).)-.25 E(GNU Bash-3.1-de) -72 768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22)-123.87 E(11)198.45 E -0 Cg EP -%%Page: 12 12 +72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11)-124.42 E(11)199 E 0 +Cg EP +%%Page: 12 13 %%BeginPageSetup BP %%EndPageSetup @@ -1620,9 +1626,9 @@ R F1(history)3.173 E F0 -.2(bu)3.172 G 3.172(iltin. If).2 F .672(this v) (adds the contents of the ne)3.215 F 3.215<778c>-.25 G .715(le to the e) -3.215 F .715(xisting list.)-.15 F(If)5.716 E F3(HOSTFILE)3.216 E F0 .716(is set, b)2.966 F .716(ut has no v)-.2 F(alue,)-.25 E -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22) --123.87 E(12)198.45 E 0 Cg EP -%%Page: 13 13 +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11) +-124.42 E(12)199 E 0 Cg EP +%%Page: 13 14 %%BeginPageSetup BP %%EndPageSetup @@ -1727,9 +1733,9 @@ F F3 .359(SHELL B)144 636 R(UIL)-.09 E .359(TIN COMMANDS)-.828 F F0 -.1 F 26.329(administrator who installs)144 708 R F1(bash)28.829 E F0 31.329(.A)C 26.328(common v)-2.501 F 26.328(alue is)-.25 F/F4 10 /Courier@0 SF(/usr/gnu/bin:/usr/local/bin:/usr/ucb:/bin:/usr/bin)144 720 -Q F0(.)A(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87(l2).15 G -(004 Dec 22)-123.87 E(13)198.45 E 0 Cg EP -%%Page: 14 14 +Q F0(.)A(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G +(005 Feb 11)-124.42 E(13)199 E 0 Cg EP +%%Page: 14 15 %%BeginPageSetup BP %%EndPageSetup @@ -1845,9 +1851,9 @@ F F2(substring)3.125 E F0 3.125(,t).22 G .625 .833(job identi\214er \(see)5.833 F F4 .834(JOB CONTR)3.334 F(OL)-.27 E F0(belo)3.084 E 3.334(w\). If)-.25 F .834(set to an)3.334 F 3.334(yo) -.15 G .834(ther v)-3.334 F .834(alue, the supplied string)-.25 F -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22) --123.87 E(14)198.45 E 0 Cg EP -%%Page: 15 15 +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11) +-124.42 E(14)199 E 0 Cg EP +%%Page: 15 16 %%BeginPageSetup BP %%EndPageSetup @@ -1989,9 +1995,9 @@ E .471(The order of e)108 703.2 R .471(xpansions is: brace e)-.15 F .471 .47(ariable and arithmetic e)-3.221 F(xpansion)-.15 E (and command substitution \(done in a left-to-right f)108 715.2 Q (ashion\), w)-.1 E(ord splitting, and pathname e)-.1 E(xpansion.)-.15 E -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22) --123.87 E(15)198.45 E 0 Cg EP -%%Page: 16 16 +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11) +-124.42 E(15)199 E 0 Cg EP +%%Page: 16 17 %%BeginPageSetup BP %%EndPageSetup @@ -2121,9 +2127,9 @@ ith the corresponding element from the directory stack, as it w)108 (consist of a number without a leading `+' or `\255', `+' is assumed.) 108 712.8 Q(If the login name is in)108 729.6 Q -.25(va)-.4 G (lid, or the tilde e).25 E(xpansion f)-.15 E(ails, the w)-.1 E -(ord is unchanged.)-.1 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87 -(l2).15 G(004 Dec 22)-123.87 E(16)198.45 E 0 Cg EP -%%Page: 17 17 +(ord is unchanged.)-.1 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42 +(l2).15 G(005 Feb 11)-124.42 E(16)199 E 0 Cg EP +%%Page: 17 18 %%BeginPageSetup BP %%EndPageSetup @@ -2253,9 +2259,9 @@ F0 .111(is tak)2.61 F .111(en relati)-.1 F .411 -.15(ve t)-.25 H 2.611 (id being confused with the :- e).2 F 3.141(xpansion. Substring)-.15 F (inde)3.141 E .641(xing is zero-based unless the)-.15 F (positional parameters are used, in which case the inde)144 712.8 Q -(xing starts at 1.)-.15 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87 -(l2).15 G(004 Dec 22)-123.87 E(17)198.45 E 0 Cg EP -%%Page: 18 18 +(xing starts at 1.)-.15 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42 +(l2).15 G(005 Feb 11)-124.42 E(17)199 E 0 Cg EP +%%Page: 18 19 %%BeginPageSetup BP %%EndPageSetup @@ -2373,9 +2379,8 @@ F1(`)A(Bash)108 715.2 Q F0 .019(performs the e)2.519 F .019 (dard output of the command, with an)108 727.2 R 3.268(yt)-.15 G .768 (railing ne)-3.268 F .768(wlines deleted.)-.25 F .768(Embedded ne)5.768 F .768(wlines are not deleted, b)-.25 F(ut)-.2 E(GNU Bash-3.1-de)72 768 -Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22)-123.87 E(18)198.45 E 0 Cg -EP -%%Page: 19 19 +Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11)-124.42 E(18)199 E 0 Cg EP +%%Page: 19 20 %%BeginPageSetup BP %%EndPageSetup @@ -2502,8 +2507,8 @@ F .765(ord is left unchanged.)-.1 F .765(If the)5.765 F F1(nullglob) 2.065(is printed and the command is not e)108 727.2 R -.15(xe)-.15 G 4.565(cuted. If).15 F 2.065(the shell option)4.565 F F1(nocaseglob)4.565 E F0 2.066(is enabled, the match is)4.566 F(GNU Bash-3.1-de)72 768 Q --.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22)-123.87 E(19)198.45 E 0 Cg EP -%%Page: 20 20 +-.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11)-124.42 E(19)199 E 0 Cg EP +%%Page: 20 21 %%BeginPageSetup BP %%EndPageSetup @@ -2620,9 +2625,9 @@ F0(.)A(Composite patterns may be formed using one or more of the follo) (Matches one or more occurrences of the gi)180 682.8 Q -.15(ve)-.25 G 2.5(np).15 G(atterns)-2.5 E F1(@\()144 694.8 Q F3(pattern-list).833 E F1 (\)).833 E F0(Matches one of the gi)180 706.8 Q -.15(ve)-.25 G 2.5(np) -.15 G(atterns)-2.5 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87(l2) -.15 G(004 Dec 22)-123.87 E(20)198.45 E 0 Cg EP -%%Page: 21 21 +.15 G(atterns)-2.5 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2) +.15 G(005 Feb 11)-124.42 E(20)199 E 0 Cg EP +%%Page: 21 22 %%BeginPageSetup BP %%EndPageSetup @@ -2712,8 +2717,8 @@ hould be used with care, as the)108 626.4 R 3.447(ym)-.15 G .947 (is not speci\214ed.)2.74 E (The general format for redirecting input is:)108 696 Q([)144 712.8 Q F2 (n)A F0(])A F1(<)A F2(wor)A(d)-.37 E F0(GNU Bash-3.1-de)72 768 Q -.15 -(ve)-.25 G 123.87(l2).15 G(004 Dec 22)-123.87 E(21)198.45 E 0 Cg EP -%%Page: 22 22 +(ve)-.25 G 124.42(l2).15 G(005 Feb 11)-124.42 E(21)199 E 0 Cg EP +%%Page: 22 23 %%BeginPageSetup BP %%EndPageSetup @@ -2802,9 +2807,9 @@ F0 .774(are quoted, the)4.044 F F2(delimiter)3.624 E F0 .774 (<<<)144 679.2 Q F2(wor)A(d)-.37 E F0(The)108 696 Q F2(wor)2.5 E(d)-.37 E F0(is e)2.5 E (xpanded and supplied to the command on its standard input.)-.15 E -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22) --123.87 E(22)198.45 E 0 Cg EP -%%Page: 23 23 +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11) +-124.42 E(22)199 E 0 Cg EP +%%Page: 23 24 %%BeginPageSetup BP %%EndPageSetup @@ -2917,9 +2922,9 @@ E .436 (another command does not tak)108 727.2 R 3.662(ee)-.1 G -.25(ff)-3.662 G 1.162(ect until the ne).25 F 1.162(xt line of input is read.)-.15 F 1.162(The commands follo)6.162 F 1.162(wing the)-.25 F(GNU Bash-3.1-de) -72 768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22)-123.87 E(23)198.45 E -0 Cg EP -%%Page: 24 24 +72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11)-124.42 E(23)199 E 0 +Cg EP +%%Page: 24 25 %%BeginPageSetup BP %%EndPageSetup @@ -3040,9 +3045,9 @@ F .206(gers with no)-.15 F .429(check for o)108 537.6 R -.15(ve)-.15 G (multiplication, di)10.72 E(vision, remainder)-.25 E F1 2.5<2bad>108 674.4 S F0(addition, subtraction)19.6 E F1(<< >>)108 686.4 Q F0 (left and right bitwise shifts)10.7 E F1(<= >= < >)108 698.4 Q F0 -(comparison)144 710.4 Q(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87 -(l2).15 G(004 Dec 22)-123.87 E(24)198.45 E 0 Cg EP -%%Page: 25 25 +(comparison)144 710.4 Q(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42 +(l2).15 G(005 Feb 11)-124.42 E(24)199 E 0 Cg EP +%%Page: 25 26 %%BeginPageSetup BP %%EndPageSetup @@ -3146,8 +3151,8 @@ F2(\214le)2.5 E F0 -.35(Tr)10.02 G(ue if).35 E F2(\214le)2.5 E F0 -.15 (ex)2.5 G(ists and its set-user).15 E(-id bit is set.)-.2 E F1108 708 Q F2(\214le)2.5 E F0 -.35(Tr)8.36 G(ue if).35 E F2(\214le)2.5 E F0 -.15(ex)2.5 G(ists and is writable.).15 E(GNU Bash-3.1-de)72 768 Q -.15 -(ve)-.25 G 123.87(l2).15 G(004 Dec 22)-123.87 E(25)198.45 E 0 Cg EP -%%Page: 26 26 +(ve)-.25 G 124.42(l2).15 G(005 Feb 11)-124.42 E(25)199 E 0 Cg EP +%%Page: 26 27 %%BeginPageSetup BP %%EndPageSetup @@ -3247,8 +3252,8 @@ R(an)3.176 E 3.176(yo)-.15 G 3.176(ft)-3.176 G .677 .149(ut do not af)-.2 F .149(fect the current shell en)-.25 F 2.649 (vironment. A)-.4 F(redirection error causes the command to e)108 729.6 Q(xit with a non-zero status.)-.15 E(GNU Bash-3.1-de)72 768 Q -.15(ve) --.25 G 123.87(l2).15 G(004 Dec 22)-123.87 E(26)198.45 E 0 Cg EP -%%Page: 27 27 +-.25 G 124.42(l2).15 G(005 Feb 11)-124.42 E(26)199 E 0 Cg EP +%%Page: 27 28 %%BeginPageSetup BP %%EndPageSetup @@ -3358,9 +3363,9 @@ F4($PPID)2.5 E F0 .426(When a simple command other than a b)108 686.4 R -2.927 G(eparate)-2.927 E -.15(exe)108 698.4 S .134(cution en).15 F .134 (vironment that consists of the follo)-.4 F 2.634(wing. Unless)-.25 F .133(otherwise noted, the v)2.634 F .133(alues are inherited from)-.25 F -(the shell.)108 710.4 Q(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87 -(l2).15 G(004 Dec 22)-123.87 E(27)198.45 E 0 Cg EP -%%Page: 28 28 +(the shell.)108 710.4 Q(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42 +(l2).15 G(005 Feb 11)-124.42 E(27)199 E 0 Cg EP +%%Page: 28 29 %%BeginPageSetup BP %%EndPageSetup @@ -3476,9 +3481,9 @@ F0 .202(itself returns the e)2.702 F .202 (cuted, unless a syntax error occurs, in which case).15 F(it e)108 705.6 Q(xits with a non-zero v)-.15 E 2.5(alue. See)-.25 F(also the)2.5 E F1 (exit)2.5 E F0 -.2(bu)2.5 G(iltin command belo).2 E -.65(w.)-.25 G -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22) --123.87 E(28)198.45 E 0 Cg EP -%%Page: 29 29 +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11) +-124.42 E(28)199 E 0 Cg EP +%%Page: 29 30 %%BeginPageSetup BP %%EndPageSetup @@ -3614,9 +3619,9 @@ E F0 .277(refers to a stopped)2.777 F F2(ce)2.777 E F0(job)2.777 E 5.277 724.8 R F2(bash)2.88 E F0 .38(reports an error)2.88 F 5.38(.U)-.55 G (sing)-5.38 E F2(%?ce)2.88 E F0 2.88(,o)C 2.88(nt)-2.88 G .38 (he other hand, refers to an)-2.88 F 2.88(yj)-.15 G(ob)-2.88 E -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22) --123.87 E(29)198.45 E 0 Cg EP -%%Page: 30 30 +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11) +-124.42 E(29)199 E 0 Cg EP +%%Page: 30 31 %%BeginPageSetup BP %%EndPageSetup @@ -3719,9 +3724,9 @@ uld be used to embed a terminal)-.15 F(control sequence into the prompt) (end a sequence of non-printing characters)29.89 E .119 (The command number and the history number are usually dif)108 720 R .12 (ferent: the history number of a command is its)-.25 F(GNU Bash-3.1-de) -72 768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22)-123.87 E(30)198.45 E -0 Cg EP -%%Page: 31 31 +72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11)-124.42 E(30)199 E 0 +Cg EP +%%Page: 31 32 %%BeginPageSetup BP %%EndPageSetup @@ -3850,9 +3855,9 @@ F0(,).72 E F4(SP)2.5 E -.3(AC)-.9 G(E).3 E F0 2.5(,a).73 G(nd)-2.5 E F4 E F4(macr)4.042 E(o)-.45 E F0(,)A F4 -.1(ke)4.042 G(yname)-.2 E F0 1.542 (is the name of a k)4.222 F 1.841 -.15(ey s)-.1 H 1.541(pelled out in) .15 F 2.5(English. F)108 717.6 R(or e)-.15 E(xample:)-.15 E -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22) --123.87 E(31)198.45 E 0 Cg EP -%%Page: 32 32 +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11) +-124.42 E(31)199 E 0 Cg EP +%%Page: 32 33 %%BeginPageSetup BP %%EndPageSetup @@ -3939,9 +3944,9 @@ F0 .01(Controls what happens when readline w)144 700.8 R .011 F0 3.44(,r)C .94(eadline uses a visible bell if one is a)-3.44 F -.25 (va)-.2 G 3.44(ilable. If).25 F .94(set to)3.44 F F2(audible)3.44 E F0 (,)A(readline attempts to ring the terminal')144 724.8 Q 2.5(sb)-.55 G -(ell.)-2.5 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87(l2).15 G -(004 Dec 22)-123.87 E(32)198.45 E 0 Cg EP -%%Page: 33 33 +(ell.)-2.5 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G +(005 Feb 11)-124.42 E(32)199 E 0 Cg EP +%%Page: 33 34 %%BeginPageSetup BP %%EndPageSetup @@ -4038,9 +4043,9 @@ E(ault k)-.1 E -.15(ey)-.1 G(map.).15 E F1(mark\255dir)108 672 Q .15 E F1(mark\255modi\214ed\255lines \(Off\))108 696 Q F0(If set to)144 708 Q F1(On)2.5 E F0 2.5(,h)C(istory lines that ha)-2.5 E .3 -.15(ve b) -.2 H(een modi\214ed are displayed with a preceding asterisk \().15 E F1 -(*)A F0(\).)A(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87(l2).15 G -(004 Dec 22)-123.87 E(33)198.45 E 0 Cg EP -%%Page: 34 34 +(*)A F0(\).)A(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G +(005 Feb 11)-124.42 E(33)199 E 0 Cg EP +%%Page: 34 35 %%BeginPageSetup BP %%EndPageSetup @@ -4138,9 +4143,9 @@ Q F1(application)3.003 E F0 .503 (ey s)-.1 H .397(equence that quotes the).15 F(current or pre)180 684 Q (vious w)-.25 E(ord in Bash:)-.1 E F1($if)180 708 Q F0(Bash)2.5 E 2.5 (#Q)180 720 S(uote the current or pre)-2.5 E(vious w)-.25 E(ord)-.1 E -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22) --123.87 E(34)198.45 E 0 Cg EP -%%Page: 35 35 +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11) +-124.42 E(34)199 E 0 Cg EP +%%Page: 35 36 %%BeginPageSetup BP %%EndPageSetup @@ -4230,8 +4235,8 @@ Q .822 -.15(ve f)-.15 H(orw).15 E .522(ard to the end of the ne)-.1 F (ack to the start of the current or pre).15 F 1.41(vious w)-.25 F 3.91 (ord. W)-.1 F 1.41(ords are composed of alphanumeric)-.8 F (characters \(letters and digits\).)144 696 Q(GNU Bash-3.1-de)72 768 Q --.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22)-123.87 E(35)198.45 E 0 Cg EP -%%Page: 36 36 +-.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11)-124.42 E(35)199 E 0 Cg EP +%%Page: 36 37 %%BeginPageSetup BP %%EndPageSetup @@ -4327,9 +4332,9 @@ E(g)-.1 E F0(mo)3.236 E -.15(ve)-.15 G .728 (See)5.939 E F2(HIST)3.439 E(OR)-.162 E 3.189(YE)-.315 G(XP)-3.189 E (ANSION)-.666 E F0(belo)3.189 E 3.439(wf)-.25 G .939(or a descrip-) -3.439 F(tion of history e)144 724.8 Q(xpansion.)-.15 E(GNU Bash-3.1-de) -72 768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22)-123.87 E(36)198.45 E -0 Cg EP -%%Page: 37 37 +72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11)-124.42 E(36)199 E 0 +Cg EP +%%Page: 37 38 %%BeginPageSetup BP %%EndPageSetup @@ -4431,9 +4436,9 @@ F(ferently)-.25 E 6.894(.E)-.65 G 1.894(ach call to)-6.894 F F4 -.37(re) (mode. In)144 724.8 R -.15(ove)3.968 G 1.468 (rwrite mode, characters bound to).15 F F1(self\255insert)3.969 E F0 1.469(replace the te)3.969 F 1.469(xt at point rather than)-.15 F -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22) --123.87 E(37)198.45 E 0 Cg EP -%%Page: 38 38 +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11) +-124.42 E(37)199 E 0 Cg EP +%%Page: 38 39 %%BeginPageSetup BP %%EndPageSetup @@ -4516,9 +4521,9 @@ F0(or)2.5 E F1(yank\255pop)2.5 E F0(.)A F1(Numeric Ar)87 549.6 Q (cuting this function the \214rst time mak).15 F .378(es the ar)-.1 F .378(gument count)-.18 F(four)144 681.6 Q 2.5(,as)-.4 G(econd time mak) -2.5 E(es the ar)-.1 E(gument count sixteen, and so on.)-.18 E F1 -(Completing)87 698.4 Q F0(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87 -(l2).15 G(004 Dec 22)-123.87 E(38)198.45 E 0 Cg EP -%%Page: 39 39 +(Completing)87 698.4 Q F0(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42 +(l2).15 G(005 Feb 11)-124.42 E(38)199 E 0 Cg EP +%%Page: 39 40 %%BeginPageSetup BP %%EndPageSetup @@ -4609,9 +4614,9 @@ in braces so)144 648 R(the list is a)144 660 Q -.25(va)-.2 G E(start\255kbd\255macr)108 688.8 Q 2.5(o\()-.18 G(C\255x \()-2.5 E(\)) .833 E F0(Be)144 700.8 Q(gin sa)-.15 E (ving the characters typed into the current k)-.2 E -.15(ey)-.1 G -(board macro.).15 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87(l2) -.15 G(004 Dec 22)-123.87 E(39)198.45 E 0 Cg EP -%%Page: 40 40 +(board macro.).15 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2) +.15 G(005 Feb 11)-124.42 E(39)199 E 0 Cg EP +%%Page: 40 41 %%BeginPageSetup BP %%EndPageSetup @@ -4709,8 +4714,8 @@ F .872(the line is redra)144 712.8 R 3.372(wn. If)-.15 F 3.372(an)3.372 G .872(umeric ar)-3.372 F .872 (gument is supplied, an asterisk is appended before pathname)-.18 F -.15 (ex)144 724.8 S(pansion.).15 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G -123.87(l2).15 G(004 Dec 22)-123.87 E(40)198.45 E 0 Cg EP -%%Page: 41 41 +124.42(l2).15 G(005 Feb 11)-124.42 E(40)199 E 0 Cg EP +%%Page: 41 42 %%BeginPageSetup BP %%EndPageSetup @@ -4779,18 +4784,17 @@ F12.821 E F0 .32(option is considered.)2.821 F .32 (The string is \214rst split using the)5.32 F .412(characters in the)108 472.8 R F3(IFS)2.912 E F0 .412(special v)2.662 F .412 (ariable as delimiters.)-.25 F .412(Shell quoting is honored.)5.412 F -.413(Each w)5.412 F .413(ord is then e)-.1 F(xpanded)-.15 E 1.64 -(using brace e)108 484.8 R 1.64(xpansion, tilde e)-.15 F 1.64 -(xpansion, parameter and v)-.15 F 1.64(ariable e)-.25 F 1.64 -(xpansion, command substitution, arith-)-.15 F 1.344(metic e)108 496.8 R -1.344(xpansion, and pathname e)-.15 F 1.344(xpansion, as described abo) --.15 F 1.644 -.15(ve u)-.15 H(nder).15 E F3(EXP)3.844 E(ANSION)-.666 E -/F4 9/Times-Roman@0 SF(.)A F0 1.345(The results are split)5.844 F 1.265 -(using the rules described abo)108 508.8 R 1.565 -.15(ve u)-.15 H(nder) -.15 E F1 -.75(Wo)3.765 G 1.265(rd Splitting).75 F F0 6.265(.T)C 1.265 -(he results of the e)-6.265 F 1.265(xpansion are pre\214x-matched)-.15 F -(ag)108 520.8 Q(ainst the w)-.05 E -(ord being completed, and the matching w)-.1 E +.413(Each w)5.412 F .413(ord is then e)-.1 F(xpanded)-.15 E .092 +(using brace e)108 484.8 R .092(xpansion, tilde e)-.15 F .092 +(xpansion, parameter and v)-.15 F .092(ariable e)-.25 F .091 +(xpansion, command substitution, and arith-)-.15 F 1.396(metic e)108 +496.8 R 1.396(xpansion, as described abo)-.15 F 1.696 -.15(ve u)-.15 H +(nder).15 E F3(EXP)3.896 E(ANSION)-.666 E/F4 9/Times-Roman@0 SF(.)A F0 +1.396(The results are split using the rules described)5.896 F(abo)108 +508.8 Q .51 -.15(ve u)-.15 H(nder).15 E F1 -.75(Wo)2.71 G .21 +(rd Splitting).75 F F0 5.21(.T)C .209(he results of the e)-5.21 F .209 +(xpansion are pre\214x-matched ag)-.15 F .209(ainst the w)-.05 F .209 +(ord being com-)-.1 F(pleted, and the matching w)108 520.8 Q (ords become the possible completions.)-.1 E 1.237 (After these matches ha)108 537.6 R 1.537 -.15(ve b)-.2 H 1.237 (een generated, an).15 F 3.737(ys)-.15 G 1.238 @@ -4833,8 +4837,8 @@ F12.581 E F0 .081(option is in)2.581 F -.2(vo)-.4 G -.1(ke).2 G .377(After all of the possible completions are generated, an)108 720 R 2.877<798c>-.15 G .377(lter speci\214ed with the)-2.877 F F12.876 E F0 .376(option is applied to the)2.876 F(GNU Bash-3.1-de)72 768 Q -.15 -(ve)-.25 G 123.87(l2).15 G(004 Dec 22)-123.87 E(41)198.45 E 0 Cg EP -%%Page: 42 42 +(ve)-.25 G 124.42(l2).15 G(005 Feb 11)-124.42 E(41)199 E 0 Cg EP +%%Page: 42 43 %%BeginPageSetup BP %%EndPageSetup @@ -4978,9 +4982,9 @@ H .374(he command with embedded ne).15 F .373 2.014(can be disabled using the)108 720 R F1(+H)4.514 E F0 2.014 (option to the)4.514 F F1(set)4.514 E F0 -.2(bu)4.514 G 2.014 (iltin command \(see).2 F F4 2.013(SHELL B)4.513 F(UIL)-.09 E 2.013 -(TIN COMMANDS)-.828 F F0(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87 -(l2).15 G(004 Dec 22)-123.87 E(42)198.45 E 0 Cg EP -%%Page: 43 43 +(TIN COMMANDS)-.828 F F0(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42 +(l2).15 G(005 Feb 11)-124.42 E(42)199 E 0 Cg EP +%%Page: 43 44 %%BeginPageSetup BP %%EndPageSetup @@ -5098,9 +5102,9 @@ F2 2.5(0\()108 667.2 S(zer)-2.5 E(o\))-.18 E F0(The zeroth w)144 679.2 Q F1(n)108.36 691.2 Q F0(The)30.64 E F1(n)2.5 E F0(th w)A(ord.)-.1 E F2(^) 108 703.2 Q F0(The \214rst ar)32.67 E 2.5(gument. That)-.18 F(is, w)2.5 E(ord 1.)-.1 E F2($)108 715.2 Q F0(The last ar)31 E(gument.)-.18 E -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22) --123.87 E(43)198.45 E 0 Cg EP -%%Page: 44 44 +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11) +-124.42 E(43)199 E 0 Cg EP +%%Page: 44 45 %%BeginPageSetup BP %%EndPageSetup @@ -5225,8 +5229,8 @@ F 1.313(plied, the name and v)144 730.8 R 1.314 (alue of the alias is printed.)-.25 F F1(Alias)6.314 E F0 1.314 (returns true unless a)3.814 F F2(name)3.814 E F0 1.314(is gi)3.814 F -.15(ve)-.25 G 3.814(nf).15 G(or)-3.814 E(GNU Bash-3.1-de)72 768 Q -.15 -(ve)-.25 G 123.87(l2).15 G(004 Dec 22)-123.87 E(44)198.45 E 0 Cg EP -%%Page: 45 45 +(ve)-.25 G 124.42(l2).15 G(005 Feb 11)-124.42 E(44)199 E 0 Cg EP +%%Page: 45 46 %%BeginPageSetup BP %%EndPageSetup @@ -5339,9 +5343,9 @@ R F2(dir)2.71 E F0 5.21(.T)C .21(he v)-5.21 F(ariable)-.25 E/F4 9 (de\214nes the search path for the directory containing)144 724.8 R F2 (dir)3.276 E F0 5.776(.A).73 G(lternati)-5.776 E 1.076 -.15(ve d)-.25 H .776(irectory names in).15 F F4(CDP)3.276 E -.855(AT)-.666 G(H).855 E F0 -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22) --123.87 E(45)198.45 E 0 Cg EP -%%Page: 46 46 +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11) +-124.42 E(45)199 E 0 Cg EP +%%Page: 46 47 %%BeginPageSetup BP %%EndPageSetup @@ -5471,9 +5475,9 @@ F23.223 E F0 .722 (options\) should be quoted to protect them from e)3.223 F(xpan-)-.15 E (sion before the)144 715.2 Q F2(complete)2.5 E F0 -.2(bu)2.5 G (iltin is in).2 E -.2(vo)-.4 G -.1(ke).2 G(d.).1 E(GNU Bash-3.1-de)72 -768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22)-123.87 E(46)198.45 E 0 -Cg EP -%%Page: 47 47 +768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11)-124.42 E(46)199 E 0 Cg +EP +%%Page: 47 48 %%BeginPageSetup BP %%EndPageSetup @@ -5543,9 +5547,9 @@ F0(option to the)2.5 E F1(set)2.5 E F0 -.2(bu)2.5 G(iltin.).2 E F1 (May also be speci\214ed as)5 E F12.5 E F0(.)A F1 -.1(va)184 708 S (riable).1 E F0(Names of all shell v)5.1 E 2.5(ariables. May)-.25 F (also be speci\214ed as)2.5 E F12.5 E F0(.)A(GNU Bash-3.1-de)72 -768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22)-123.87 E(47)198.45 E 0 -Cg EP -%%Page: 48 48 +768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11)-124.42 E(47)199 E 0 Cg +EP +%%Page: 48 49 %%BeginPageSetup BP %%EndPageSetup @@ -5665,9 +5669,9 @@ E(UG)-.1 E F0(and)2.929 E F1(RETURN)2.929 E F0 .801(return v)144 727.2 R .801(alue is 0 unless an in)-.25 F -.25(va)-.4 G .8 (lid option is encountered, an attempt is made to de\214ne a function) -.25 F(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87(l2).15 G -(004 Dec 22)-123.87 E(48)198.45 E 0 Cg EP -%%Page: 49 49 +.25 F(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G +(005 Feb 11)-124.42 E(48)199 E 0 Cg EP +%%Page: 49 50 %%BeginPageSetup BP %%EndPageSetup @@ -5777,9 +5781,9 @@ F3(\214lename)2.5 E F0 2.5(][)C F3(name)-2.5 E F0(...])2.5 E .277 (ws a disk command which has)-.25 F .834(the same name as a shell b)144 720 R .834(uiltin to be e)-.2 F -.15(xe)-.15 G .834 (cuted without specifying a full pathname, e).15 F -.15(ve)-.25 G 3.333 -(nt).15 G(hough)-3.333 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87 -(l2).15 G(004 Dec 22)-123.87 E(49)198.45 E 0 Cg EP -%%Page: 50 50 +(nt).15 G(hough)-3.333 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42 +(l2).15 G(005 Feb 11)-124.42 E(49)199 E 0 Cg EP +%%Page: 50 51 %%BeginPageSetup BP %%EndPageSetup @@ -5921,8 +5925,8 @@ F0 -.25(va)2.881 G .631(riable is used, and the v).25 F .631(alue of) (ariable is set,)-.25 F F2(vi)5.116 E F0 .95(is used.)5.116 F .951 (When editing is complete, the edited commands are echoed and)5.95 F -.15(exe)144 708 S(cuted.).15 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G -123.87(l2).15 G(004 Dec 22)-123.87 E(50)198.45 E 0 Cg EP -%%Page: 51 51 +124.42(l2).15 G(005 Feb 11)-124.42 E(50)199 E 0 Cg EP +%%Page: 51 52 %%BeginPageSetup BP %%EndPageSetup @@ -6049,9 +6053,9 @@ F32.952 E F0 .452(option causes the shell to for)2.952 F .453 (If the)144 722.4 R F34.206 E F0 1.706 (option is supplied, the full pathname to which each)4.206 F F1(name) 4.206 E F0 1.707(corresponds is printed.)4.207 F(If)6.707 E -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22) --123.87 E(51)198.45 E 0 Cg EP -%%Page: 52 52 +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11) +-124.42 E(51)199 E 0 Cg EP +%%Page: 52 53 %%BeginPageSetup BP %%EndPageSetup @@ -6160,9 +6164,9 @@ E F1(jobspec)4.24 E F0(is supplied.)2.81 E 2.067(If the)144 724.8 R F2 4.567 E F0 2.067(option is supplied,)4.567 F F2(jobs)4.567 E F0 2.067(replaces an)4.567 F(y)-.15 E F1(jobspec)6.307 E F0 2.067(found in) 4.877 F F1(command)4.767 E F0(or)5.337 E F1(ar)4.897 E(gs)-.37 E F0 -2.066(with the)4.836 F(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87 -(l2).15 G(004 Dec 22)-123.87 E(52)198.45 E 0 Cg EP -%%Page: 53 53 +2.066(with the)4.836 F(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42 +(l2).15 G(005 Feb 11)-124.42 E(52)199 E 0 Cg EP +%%Page: 53 54 %%BeginPageSetup BP %%EndPageSetup @@ -6288,9 +6292,9 @@ F0 .033(than are supplied, the e)2.534 F .033 .15 G 2.533(faz)-2.533 G .033(ero v)-2.533 F .033(alue or null string,) -.25 F(as appropriate, had been supplied.)144 693.6 Q(The return v)5 E (alue is zero on success, non-zero on f)-.25 E(ailure.)-.1 E -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22) --123.87 E(53)198.45 E 0 Cg EP -%%Page: 54 54 +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11) +-124.42 E(53)199 E 0 Cg EP +%%Page: 54 55 %%BeginPageSetup BP %%EndPageSetup @@ -6406,9 +6410,9 @@ F4(.)A .335(If no)144 727.2 R F5(names)3.095 E F4(ar)2.895 E 2.835(es) -.18 G .335(upplied, the line r)-2.835 F .336 (ead is assigned to the variable)-.18 F/F6 9/Palatino-Bold@0 SF(REPL) 2.836 E(Y)-.828 E/F7 9/Palatino-Roman@0 SF(.)A F4 .336(The r)4.836 F -.336(eturn code)-.18 F F0(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87 -(l2).15 G(004 Dec 22)-123.87 E(54)198.45 E 0 Cg EP -%%Page: 55 55 +.336(eturn code)-.18 F F0(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42 +(l2).15 G(005 Feb 11)-124.42 E(54)199 E 0 Cg EP +%%Page: 55 56 %%BeginPageSetup BP %%EndPageSetup @@ -6521,9 +6525,9 @@ F1(or)3.196 E F2(until)3.196 E F1(keywor)3.196 E .696 -.18 E F2144 662.4 Q F3(option\255name)2.5 E F1(The)184 674.4 Q F3 (option\255name)2.5 E F1(can be one of the following:)2.5 E F2 (allexport)184 686.4 Q F1(Same as)224 698.4 Q F22.5 E F1(.)A F0 -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22) --123.87 E(55)198.45 E 0 Cg EP -%%Page: 56 56 +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11) +-124.42 E(55)199 E 0 Cg EP +%%Page: 56 57 %%BeginPageSetup BP %%EndPageSetup @@ -6596,9 +6600,9 @@ F F13.185 E F2 .684(option is supplied at startup, the ef)3.185 F (fective)-.18 E .752(user id is not r)184 726 R 3.252(eset. T)-.18 F .752(urning this option of)-.9 F 3.252(fc)-.18 G .752(auses the ef) -3.252 F .753(fective user and gr)-.18 F(oup)-.18 E F0(GNU Bash-3.1-de) -72 768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22)-123.87 E(56)198.45 E -0 Cg EP -%%Page: 57 57 +72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11)-124.42 E(56)199 E 0 +Cg EP +%%Page: 57 58 %%BeginPageSetup BP %%EndPageSetup @@ -6713,8 +6717,8 @@ F1(Disable \(unset\) each)23.83 E F3(optname)2.5 E F1(.)A F2144 (re)180 710.4 S(turn status is zer).18 E 2.5(oi)-.18 G 2.5(fa)-2.5 G(ll) -2.5 E F3(optnames)2.5 E F1(ar)2.5 E 2.5(ee)-.18 G(nabled; non-zer)-2.5 E 2.5(oo)-.18 G(therwise.)-2.5 E F0(GNU Bash-3.1-de)72 768 Q -.15(ve) --.25 G 123.87(l2).15 G(004 Dec 22)-123.87 E(57)198.45 E 0 Cg EP -%%Page: 58 58 +-.25 G 124.42(l2).15 G(005 Feb 11)-124.42 E(57)199 E 0 Cg EP +%%Page: 58 59 %%BeginPageSetup BP %%EndPageSetup @@ -6801,8 +6805,8 @@ Q F2(ar)2.5 E 2.5(ee)-.18 G(nabled.)-2.5 E F1(extquote)144 680.4 Q F2 (uoting is performed within)-2.643 F F1(${)2.643 E F3(parameter)A F1(})A F2(expansions)2.643 E(enclosed in double quotes.)184 704.4 Q (This option is enabled by default.)5 E F0(GNU Bash-3.1-de)72 768 Q -.15 -(ve)-.25 G 123.87(l2).15 G(004 Dec 22)-123.87 E(58)198.45 E 0 Cg EP -%%Page: 59 59 +(ve)-.25 G 124.42(l2).15 G(005 Feb 11)-124.42 E(58)199 E 0 Cg EP +%%Page: 59 60 %%BeginPageSetup BP %%EndPageSetup @@ -6880,9 +6884,9 @@ F1(progcomp)144 684 Q F2 1.198(If set, the pr)184 696 R 1.199 (ogrammable completion facilities \(see)-.18 F F1 1.199 (Programmable Completion)3.699 F F2(above\) ar)184 708 Q 2.5(ee)-.18 G 2.5(nabled. This)-2.5 F(option is enabled by default.)2.5 E F0 -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22) --123.87 E(59)198.45 E 0 Cg EP -%%Page: 60 60 +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11) +-124.42 E(59)199 E 0 Cg EP +%%Page: 60 61 %%BeginPageSetup BP %%EndPageSetup @@ -6973,8 +6977,8 @@ F .107(gument test using the second and)-.18 F(thir)180 712.8 Q 4.633 .18 F(exactly)180 724.8 Q F1(\))2.925 E F2 2.925(,t)C .426(he r)-2.925 F .426(esult is the one-ar)-.18 F .426(gument test of the second ar)-.18 F 2.926(gument. Otherwise,)-.18 F F0(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 -G 123.87(l2).15 G(004 Dec 22)-123.87 E(60)198.45 E 0 Cg EP -%%Page: 61 61 +G 124.42(l2).15 G(005 Feb 11)-124.42 E(60)199 E 0 Cg EP +%%Page: 61 62 %%BeginPageSetup BP %%EndPageSetup @@ -7111,9 +7115,9 @@ E F1 2.515(,e)C .015(ven if)-2.515 F F7 .015(type -t)2.515 F(name)144 7.058 E F1 -.18(re)4.558 G 2.058(turns tr).18 F 2.057 (ue if any of the ar)-.08 F 2.057(guments ar)-.18 F 4.557(ef)-.18 G 2.057(ound, false if none ar)-4.557 F(e)-.18 E(found.)144 698.4 Q F0 -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22) --123.87 E(61)198.45 E 0 Cg EP -%%Page: 62 62 +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11) +-124.42 E(61)199 E 0 Cg EP +%%Page: 62 63 %%BeginPageSetup BP %%EndPageSetup @@ -7233,8 +7237,8 @@ E F1(wait)108 684 Q F2([)2.5 E F3 2.5(n.)C(..)-2.5 E F2(])A -.92(Wa)144 (is not given, all curr)3.595 F 1.014(ently active child pr)-.18 F 1.014 (ocesses ar)-.18 F 3.514(ew)-.18 G 1.014(aited for)-3.514 F 3.514(,a) -.74 G 1.014(nd the)-3.514 F F0(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G -123.87(l2).15 G(004 Dec 22)-123.87 E(62)198.45 E 0 Cg EP -%%Page: 63 63 +124.42(l2).15 G(005 Feb 11)-124.42 E(62)199 E 0 Cg EP +%%Page: 63 64 %%BeginPageSetup BP %%EndPageSetup @@ -7312,8 +7316,8 @@ Q F2(~/.bashr)109.666 650.4 Q(c)-.18 E F1(The individual per)144 662.4 Q ogin shell exits)144 686.4 Q F2(~/.inputr)109.666 698.4 Q(c)-.18 E F1 (Individual)144 710.4 Q F2 -.18(re)2.5 G(adline).18 E F1 (initialization \214le)2.5 E F0(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G -123.87(l2).15 G(004 Dec 22)-123.87 E(63)198.45 E 0 Cg EP -%%Page: 64 64 +124.42(l2).15 G(005 Feb 11)-124.42 E(63)199 E 0 Cg EP +%%Page: 64 65 %%BeginPageSetup BP %%EndPageSetup @@ -7376,8 +7380,8 @@ G(onfusing in some uses.)-2.5 E(Shell builtin commands and functions ar) -.18 F .431(or messages while the con-)-.18 F(str)108 578.4 Q (uct is being r)-.08 E(ead.)-.18 E (Array variables may not \(yet\) be exported.)108 595.2 Q F0 -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.87(l2).15 G(004 Dec 22) --123.87 E(64)198.45 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 11) +-124.42 E(64)199 E 0 Cg EP %%Trailer end %%EOF diff --git a/doc/bashref.dvi b/doc/bashref.dvi index a1c15d172..70e19f60b 100644 Binary files a/doc/bashref.dvi and b/doc/bashref.dvi differ diff --git a/doc/bashref.html b/doc/bashref.html index fc20b43d7..ae5630a1f 100644 --- a/doc/bashref.html +++ b/doc/bashref.html @@ -1,6 +1,6 @@ - +