From 8fed35894bd572854295131eba95c07ae54962ec Mon Sep 17 00:00:00 2001 From: Chet Ramey Date: Sat, 3 Dec 2011 13:41:01 -0500 Subject: [PATCH] commit bash-20041209 snapshot --- CWRU/CWRU.chlog | 22 + CWRU/CWRU.chlog~ | 45 +- builtins/set.def | 2 + builtins/set.def~ | 2 +- builtins/shopt.def | 4 +- builtins/shopt.def~ | 539 +++++++++++++++++++++ doc/bash.0 | 1059 +++++++++++++++++++++--------------------- doc/bash.html | 24 +- doc/bash.ps | 320 ++++++------- doc/bashref.dvi | Bin 584548 -> 584768 bytes doc/bashref.html | 31 +- doc/bashref.info | 286 ++++++------ doc/bashref.log | 20 +- doc/bashref.ps | 249 +++++----- doc/builtins.0 | 1003 +++++++++++++++++++-------------------- doc/builtins.ps | 35 +- doc/rbash.ps | 2 +- lib/readline/bind.c | 11 +- lib/readline/bind.c~ | 1 + subst.c | 9 + tests/new-exp.right | 8 +- tests/new-exp.tests | 11 + 22 files changed, 2157 insertions(+), 1526 deletions(-) create mode 100644 builtins/shopt.def~ diff --git a/CWRU/CWRU.chlog b/CWRU/CWRU.chlog index dd4bf49e6..19a093f7f 100644 --- a/CWRU/CWRU.chlog +++ b/CWRU/CWRU.chlog @@ -10674,3 +10674,25 @@ execute_cmd.c lib/glob/xmbsrtowcs.c - change xmbsrtowcs to handle the one case where malloc can fail (though it should not matter) -- don't try to free a null pointer + + 12/9 + ---- +subst.c + - fix get_var_and_type to handle var[@], where `var' is a scalar + variable, identically to var -- all calling expansions can now + handle var[@] like var. Bug reported by agriffis@gentoo.org + + 12/10 + ----- +lib/readline/bind.c + - make new-style "\M-x" keybindings obey `convert-meta' settings + (bug reported by twaugh@redhat.com) + + 12/14 + ----- +builtins/set.def + - added description of `-' option to help text + +builtins/shopt.def + - fix bug that caused `gnu_errfmt' to not be compiled in unless + READLINE is defined diff --git a/CWRU/CWRU.chlog~ b/CWRU/CWRU.chlog~ index 023f8f79a..94290735a 100644 --- a/CWRU/CWRU.chlog~ +++ b/CWRU/CWRU.chlog~ @@ -2874,7 +2874,7 @@ lib/sh/stringlist.c subst.c - in skip_to_delim(), if we have an unclosed ${, and it's at the end of the string (string[i] == '{', string[i+1] == '{' and - string[i+2] == 0, return si (i +2) immediately without bothering + string[i+2] == 0, return si (i + 2) immediately without bothering to call extract_dollar_brace_string or extract_delimited_string - in skip_to_delim(), if string[i] is 0 after a call to extract_dollar_brace_string or extract_delimited_string (meaning we @@ -10644,3 +10644,46 @@ execute_cmd.c trap.c - change reset_or_restore_signal_handlers so that the RETURN trap is not inherited by command substitution when DEBUGGER is not defined + + 11/30 + ----- +lib/readline/misc.c + - fix memory leaks in _rl_free_history_entry and rl_maybe_replace_line + caused by not freeing `timestamp' member of history entry + - make sure timestamp is initialized to NULL in rl_maybe_save_line + + 12/1 + ---- +execute_cmd.c + - fix execute_function so a function calling `return' will run the + RETURN trap, if one's defined + +doc/{bash.1,bashref.texi} + - fix description of RETURN trap in various places to indicate that it's + only inherited by shell functions if function tracing is on globally + or has been enabled for that function + - fix documentation to indicate that the DEBUG and RETURN traps are + inherited under the same conditions + +execute_cmd.c + - a function does not inherit the RETURN trap if a DEBUG trap is + currently running + + 12/2 + ---- +lib/glob/xmbsrtowcs.c + - change xmbsrtowcs to handle the one case where malloc can fail + (though it should not matter) -- don't try to free a null pointer + + 12/9 + ---- +subst.c + - fix get_var_and_type to handle var[@], where `var' is a scalar + variable, identically to var -- all calling expansions can now + handle var[@] like var. Bug reported by agriffis@gentoo.org + + 12/10 + ----- +lib/readline/bind.c + - make new-style "\M-x" keybindings obey `convert-meta' settings + (bug reported by twaugh@redhat.com) diff --git a/builtins/set.def b/builtins/set.def index a6046d979..87a58d778 100644 --- a/builtins/set.def +++ b/builtins/set.def @@ -133,6 +133,8 @@ $SHORT_DOC set [--abefhkmnptuvxBCHP] [-o option] [arg ...] -P If set, do not follow symbolic links when executing commands such as cd which change the current directory. -T If set, the DEBUG trap is inherited by shell functions. + - Assign any remaining arguments to the positional parameters. + The -x and -v options are turned off. Using + rather than - causes these flags to be turned off. The flags can also be used upon invocation of the shell. The current diff --git a/builtins/set.def~ b/builtins/set.def~ index d4e94ed97..a6046d979 100644 --- a/builtins/set.def~ +++ b/builtins/set.def~ @@ -1,7 +1,7 @@ This file is set.def, from which is created set.c. It implements the "set" and "unset" builtins in Bash. -Copyright (C) 1987-2002 Free Software Foundation, Inc. +Copyright (C) 1987-2004 Free Software Foundation, Inc. This file is part of GNU Bash, the Bourne Again SHell. diff --git a/builtins/shopt.def b/builtins/shopt.def index ad432e0c5..c314c0254 100644 --- a/builtins/shopt.def +++ b/builtins/shopt.def @@ -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 diff --git a/builtins/shopt.def~ b/builtins/shopt.def~ new file mode 100644 index 000000000..ad432e0c5 --- /dev/null +++ b/builtins/shopt.def~ @@ -0,0 +1,539 @@ +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. + +This file is part of GNU Bash, the Bourne Again SHell. + +Bash is free software; you can redistribute it and/or modify it under +the terms of the GNU General Public License as published by the Free +Software Foundation; either version 2, or (at your option) any later +version. + +Bash is distributed in the hope that it will be useful, but WITHOUT ANY +WARRANTY; without even the implied warranty of MERCHANTABILITY or +FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +for more details. + +You should have received a copy of the GNU General Public License along +with Bash; see the file COPYING. If not, write to the Free Software +Foundation, 59 Temple Place, Suite 330, Boston, MA 02111 USA. + +$PRODUCES shopt.c + +$BUILTIN shopt +$FUNCTION shopt_builtin +$SHORT_DOC shopt [-pqsu] [-o long-option] optname [optname...] +Toggle the values of variables controlling optional behavior. +The -s flag means to enable (set) each OPTNAME; the -u flag +unsets each OPTNAME. The -q flag suppresses output; the exit +status indicates whether each OPTNAME is set or unset. The -o +option restricts the OPTNAMEs to those defined for use with +`set -o'. With no options, or with the -p option, a list of all +settable options is displayed, with an indication of whether or +not each is set. +$END + +#include + +#if defined (HAVE_UNISTD_H) +# ifdef _MINIX +# include +# endif +# include +#endif + +#include + +#include "../bashintl.h" + +#include "../shell.h" +#include "../flags.h" +#include "common.h" +#include "bashgetopt.h" + +#define UNSETOPT 0 +#define SETOPT 1 + +#define OPTFMT "%-15s\t%s\n" + +extern int allow_null_glob_expansion, fail_glob_expansion, glob_dot_filenames; +extern int cdable_vars, mail_warning, source_uses_path; +extern int no_exit_on_failed_exec, print_shift_error; +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 hup_on_exit; +extern int xpg_echo; +extern int gnu_error_format; + +#if defined (EXTENDED_GLOB) +extern int extended_glob; +#endif + +#if defined (HISTORY) +extern int literal_history, command_oriented_history; +extern int force_append_history; +#endif + +#if defined (READLINE) +extern int hist_verify, history_reediting, perform_hostname_completion; +extern int no_empty_command_completion; +extern int force_fignore; +extern int enable_hostname_completion __P((int)); +#endif + +#if defined (PROGRAMMABLE_COMPLETION) +extern int prog_completion_enabled; +#endif + +#if defined (RESTRICTED_SHELL) +extern char *shell_name; +#endif + +#if defined (DEBUGGER) +extern int debugging_mode; +#endif + +static void shopt_error __P((char *)); + +static int set_shellopts_after_change __P((int)); + +#if defined (RESTRICTED_SHELL) +static int set_restricted_shell __P((int)); +#endif + +static int shopt_login_shell; + +typedef int shopt_set_func_t __P((int)); + +static struct { + char *name; + int *value; + shopt_set_func_t *set_func; +} shopt_vars[] = { + { "cdable_vars", &cdable_vars, (shopt_set_func_t *)NULL }, + { "cdspell", &cdspelling, (shopt_set_func_t *)NULL }, + { "checkhash", &check_hashed_filenames, (shopt_set_func_t *)NULL }, + { "checkwinsize", &check_window_size, (shopt_set_func_t *)NULL }, +#if defined (HISTORY) + { "cmdhist", &command_oriented_history, (shopt_set_func_t *)NULL }, +#endif + { "dotglob", &glob_dot_filenames, (shopt_set_func_t *)NULL }, + { "execfail", &no_exit_on_failed_exec, (shopt_set_func_t *)NULL }, + { "expand_aliases", &expand_aliases, (shopt_set_func_t *)NULL }, +#if defined (DEBUGGER) + { "extdebug", &debugging_mode, (shopt_set_func_t *)NULL }, +#endif +#if defined (EXTENDED_GLOB) + { "extglob", &extended_glob, (shopt_set_func_t *)NULL }, +#endif + { "extquote", &extended_quote, (shopt_set_func_t *)NULL }, + { "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 +#if defined (HISTORY) + { "histappend", &force_append_history, (shopt_set_func_t *)NULL }, +#endif +#if defined (READLINE) + { "histverify", &hist_verify, (shopt_set_func_t *)NULL }, + { "hostcomplete", &perform_hostname_completion, enable_hostname_completion }, +#endif + { "huponexit", &hup_on_exit, (shopt_set_func_t *)NULL }, + { "interactive_comments", &interactive_comments, set_shellopts_after_change }, +#if defined (HISTORY) + { "lithist", &literal_history, (shopt_set_func_t *)NULL }, +#endif + { "login_shell", &shopt_login_shell, set_login_shell }, + { "mailwarn", &mail_warning, (shopt_set_func_t *)NULL }, +#if defined (READLINE) + { "no_empty_cmd_completion", &no_empty_command_completion, (shopt_set_func_t *)NULL }, +#endif + { "nocaseglob", &glob_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 }, +#endif + { "promptvars", &promptvars, (shopt_set_func_t *)NULL }, +#if defined (RESTRICTED_SHELL) + { "restricted_shell", &restricted_shell, set_restricted_shell }, +#endif + { "shift_verbose", &print_shift_error, (shopt_set_func_t *)NULL }, + { "sourcepath", &source_uses_path, (shopt_set_func_t *)NULL }, + { "xpg_echo", &xpg_echo, (shopt_set_func_t *)NULL }, + { (char *)0, (int *)0, (shopt_set_func_t *)NULL } +}; + +static char *on = "on"; +static char *off = "off"; + +static int find_shopt __P((char *)); +static int toggle_shopts __P((int, WORD_LIST *, int)); +static void print_shopt __P((char *, int, int)); +static int list_shopts __P((WORD_LIST *, int)); +static int list_some_shopts __P((int, int)); +static int list_shopt_o_options __P((WORD_LIST *, int)); +static int list_some_o_options __P((int, int)); +static int set_shopt_o_options __P((int, WORD_LIST *, int)); + +#define SFLAG 0x01 +#define UFLAG 0x02 +#define QFLAG 0x04 +#define OFLAG 0x08 +#define PFLAG 0x10 + +int +shopt_builtin (list) + WORD_LIST *list; +{ + int opt, flags, rval; + + flags = 0; + reset_internal_getopt (); + while ((opt = internal_getopt (list, "psuoq")) != -1) + { + switch (opt) + { + case 's': + flags |= SFLAG; + break; + case 'u': + flags |= UFLAG; + break; + case 'q': + flags |= QFLAG; + break; + case 'o': + flags |= OFLAG; + break; + case 'p': + flags |= PFLAG; + break; + default: + builtin_usage (); + return (EX_USAGE); + } + } + list = loptend; + + if ((flags & (SFLAG|UFLAG)) == (SFLAG|UFLAG)) + { + builtin_error (_("cannot set and unset shell options simultaneously")); + return (EXECUTION_FAILURE); + } + + rval = EXECUTION_SUCCESS; + if ((flags & OFLAG) && ((flags & (SFLAG|UFLAG)) == 0)) /* shopt -o */ + rval = list_shopt_o_options (list, flags); + else if (list && (flags & OFLAG)) /* shopt -so args */ + rval = set_shopt_o_options ((flags & SFLAG) ? FLAG_ON : FLAG_OFF, list, flags & QFLAG); + else if (flags & OFLAG) /* shopt -so */ + rval = list_some_o_options ((flags & SFLAG) ? 1 : 0, flags); + else if (list && (flags & (SFLAG|UFLAG))) /* shopt -su args */ + rval = toggle_shopts ((flags & SFLAG) ? SETOPT : UNSETOPT, list, flags & QFLAG); + else if ((flags & (SFLAG|UFLAG)) == 0) /* shopt [args] */ + rval = list_shopts (list, flags); + else /* shopt -su */ + rval = list_some_shopts ((flags & SFLAG) ? SETOPT : UNSETOPT, flags); + return (rval); +} + +/* Reset the options managed by `shopt' to the values they would have at + shell startup. */ +void +reset_shopt_options () +{ + allow_null_glob_expansion = glob_dot_filenames = 0; + cdable_vars = mail_warning = 0; + no_exit_on_failed_exec = print_shift_error = 0; + check_hashed_filenames = cdspelling = expand_aliases = check_window_size = 0; + + source_uses_path = promptvars = 1; + +#if defined (EXTENDED_GLOB) + extended_glob = 0; +#endif + +#if defined (HISTORY) + literal_history = force_append_history = 0; + command_oriented_history = 1; +#endif + +#if defined (READLINE) + hist_verify = history_reediting = 0; + perform_hostname_completion = 1; +#endif + + shopt_login_shell = login_shell; +} + +static int +find_shopt (name) + char *name; +{ + int i; + + for (i = 0; shopt_vars[i].name; i++) + if (STREQ (name, shopt_vars[i].name)) + return i; + return -1; +} + +static void +shopt_error (s) + char *s; +{ + builtin_error (_("%s: invalid shell option name"), s); +} + +static int +toggle_shopts (mode, list, quiet) + int mode; + WORD_LIST *list; + int quiet; +{ + WORD_LIST *l; + int ind, rval; + + for (l = list, rval = EXECUTION_SUCCESS; l; l = l->next) + { + ind = find_shopt (l->word->word); + if (ind < 0) + { + shopt_error (l->word->word); + rval = EXECUTION_FAILURE; + } + else + { + *shopt_vars[ind].value = mode; /* 1 for set, 0 for unset */ + if (shopt_vars[ind].set_func) + (*shopt_vars[ind].set_func) (mode); + } + } + return (rval); +} + +static void +print_shopt (name, val, flags) + char *name; + int val, flags; +{ + if (flags & PFLAG) + printf ("shopt %s %s\n", val ? "-s" : "-u", name); + else + printf (OPTFMT, name, val ? on : off); +} + +/* List the values of all or any of the `shopt' options. Returns 0 if + all were listed or all variables queried were on; 1 otherwise. */ +static int +list_shopts (list, flags) + WORD_LIST *list; + int flags; +{ + WORD_LIST *l; + int i, val, rval; + + if (list == 0) + { + for (i = 0; shopt_vars[i].name; i++) + { + val = *shopt_vars[i].value; + if ((flags & QFLAG) == 0) + print_shopt (shopt_vars[i].name, val, flags); + } + return (EXECUTION_SUCCESS); + } + + for (l = list, rval = EXECUTION_SUCCESS; l; l = l->next) + { + i = find_shopt (l->word->word); + if (i < 0) + { + shopt_error (l->word->word); + rval = EXECUTION_FAILURE; + continue; + } + val = *shopt_vars[i].value; + if (val == 0) + rval = EXECUTION_FAILURE; + if ((flags & QFLAG) == 0) + print_shopt (l->word->word, val, flags); + } + + return (rval); +} + +static int +list_some_shopts (mode, flags) + int mode, flags; +{ + int val, i; + + for (i = 0; shopt_vars[i].name; i++) + { + val = *shopt_vars[i].value; + if (((flags & QFLAG) == 0) && mode == val) + print_shopt (shopt_vars[i].name, val, flags); + } + return (EXECUTION_SUCCESS); +} + +static int +list_shopt_o_options (list, flags) + WORD_LIST *list; + int flags; +{ + WORD_LIST *l; + int val, rval; + + if (list == 0) + { + if ((flags & QFLAG) == 0) + list_minus_o_opts (-1, (flags & PFLAG)); + return (EXECUTION_SUCCESS); + } + + for (l = list, rval = EXECUTION_SUCCESS; l; l = l->next) + { + val = minus_o_option_value (l->word->word); + if (val == -1) + { + sh_invalidoptname (l->word->word); + rval = EXECUTION_FAILURE; + continue; + } + if (val == 0) + rval = EXECUTION_FAILURE; + if ((flags & QFLAG) == 0) + { + if (flags & PFLAG) + printf ("set %co %s\n", val ? '-' : '+', l->word->word); + else + printf (OPTFMT, l->word->word, val ? on : off); + } + } + return (rval); +} + +static int +list_some_o_options (mode, flags) + int mode, flags; +{ + if ((flags & QFLAG) == 0) + list_minus_o_opts (mode, (flags & PFLAG)); + return (EXECUTION_SUCCESS); +} + +static int +set_shopt_o_options (mode, list, quiet) + int mode; + WORD_LIST *list; + int quiet; +{ + WORD_LIST *l; + int rval; + + for (l = list, rval = EXECUTION_SUCCESS; l; l = l->next) + { + if (set_minus_o_option (mode, l->word->word) == EXECUTION_FAILURE) + rval = EXECUTION_FAILURE; + } + set_shellopts (); + return rval; +} + +/* If we set or unset interactive_comments with shopt, make sure the + change is reflected in $SHELLOPTS. */ +static int +set_shellopts_after_change (mode) + int mode; +{ + set_shellopts (); + return (0); +} + +#if defined (RESTRICTED_SHELL) +/* Don't allow the value of restricted_shell to be modified. */ + +static int +set_restricted_shell (mode) + int mode; +{ + static int save_restricted = -1; + + if (save_restricted == -1) + save_restricted = shell_is_restricted (shell_name); + + restricted_shell = save_restricted; + return (0); +} +#endif /* RESTRICTED_SHELL */ + +/* Not static so shell.c can call it to initialize shopt_login_shell */ +int +set_login_shell (mode) + int mode; +{ + shopt_login_shell = login_shell != 0; + return (0); +} + +char ** +get_shopt_options () +{ + char **ret; + int n, i; + + n = sizeof (shopt_vars) / sizeof (shopt_vars[0]); + ret = strvec_create (n + 1); + for (i = 0; shopt_vars[i].name; i++) + ret[i] = savestring (shopt_vars[i].name); + ret[i] = (char *)NULL; + return ret; +} + +/* + * External interface for other parts of the shell. NAME is a string option; + * MODE is 0 if we want to unset an option; 1 if we want to set an option. + * REUSABLE is 1 if we want to print output in a form that may be reused. + */ +int +shopt_setopt (name, mode) + char *name; + int mode; +{ + WORD_LIST *wl; + int r; + + wl = add_string_to_list (name, (WORD_LIST *)NULL); + r = toggle_shopts (mode, wl, 0); + dispose_words (wl); + return r; +} + +int +shopt_listopt (name, reusable) + char *name; + int reusable; +{ + int i; + + if (name == 0) + return (list_shopts ((WORD_LIST *)NULL, reusable ? PFLAG : 0)); + + i = find_shopt (name); + if (i < 0) + { + shopt_error (name); + return (EXECUTION_FAILURE); + } + + print_shopt (name, *shopt_vars[i].value, reusable ? PFLAG : 0); + return (EXECUTION_SUCCESS); +} diff --git a/doc/bash.0 b/doc/bash.0 index 91becc46b..26c74ef25 100644 --- a/doc/bash.0 +++ b/doc/bash.0 @@ -1812,12 +1812,12 @@ FFUUNNCCTTIIOONNSS first element of the FFUUNNCCNNAAMMEE variable is set to the name of the func- tion while the function is executing. All other aspects of the shell execution environment are identical between a function and its caller - with the exception that the DDEEBBUUGG trap (see the description of the ttrraapp - builtin under SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below) is not inherited unless the - function has been given the ttrraaccee attribute (see the description of the - ddeeccllaarree builtin below) or the --oo ffuunnccttrraaccee shell option has been - enabled with the sseett builtin (in which case all functions inherit the - DDEEBBUUGG trap). + with the exception that the DDEEBBUUGG and RREETTUURRNN traps (see the description + of the ttrraapp builtin under SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below) are not inher- + ited unless the function has been given the ttrraaccee attribute (see the + description of the ddeeccllaarree builtin below) or the --oo ffuunnccttrraaccee shell + option has been enabled with the sseett builtin (in which case all func- + tions inherit the DDEEBBUUGG and RREETTUURRNN traps). Variables local to the function may be declared with the llooccaall builtin command. Ordinarily, variables and their values are shared between the @@ -3655,70 +3655,71 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS --rr Make _n_a_m_es readonly. These names cannot then be assigned values by subsequent assignment statements or unset. --tt Give each _n_a_m_e the _t_r_a_c_e attribute. Traced functions - inherit the DDEEBBUUGG trap from the calling shell. The trace - attribute has no special meaning for variables. - --xx Mark _n_a_m_es for export to subsequent commands via the + inherit the DDEEBBUUGG and RREETTUURRNN traps from the calling + shell. The trace attribute has no special meaning for + variables. + --xx Mark _n_a_m_es for export to subsequent commands via the environment. - Using `+' instead of `-' turns off the attribute instead, with - the exception that ++aa may not be used to destroy an array vari- - able. When used in a function, makes each _n_a_m_e local, as with - the llooccaall command. If a variable name is followed by =_v_a_l_u_e, - the value of the variable is set to _v_a_l_u_e. The return value is + Using `+' instead of `-' turns off the attribute instead, with + the exception that ++aa may not be used to destroy an array vari- + able. When used in a function, makes each _n_a_m_e local, as with + the llooccaall command. If a variable name is followed by =_v_a_l_u_e, + the value of the variable is set to _v_a_l_u_e. The return value is 0 unless an invalid option is encountered, an attempt is made to - define a function using ``-f foo=bar'', an attempt is made to - assign a value to a readonly variable, an attempt is made to - assign a value to an array variable without using the compound - assignment syntax (see AArrrraayyss above), one of the _n_a_m_e_s is not a - valid shell variable name, an attempt is made to turn off read- - only status for a readonly variable, an attempt is made to turn + define a function using ``-f foo=bar'', an attempt is made to + assign a value to a readonly variable, an attempt is made to + assign a value to an array variable without using the compound + assignment syntax (see AArrrraayyss above), one of the _n_a_m_e_s is not a + valid shell variable name, an attempt is made to turn off read- + only status for a readonly variable, an attempt is made to turn off array status for an array variable, or an attempt is made to display a non-existent function with --ff. ddiirrss [[--ccllppvv]] [[++_n]] [[--_n]] - Without options, displays the list of currently remembered - directories. The default display is on a single line with - directory names separated by spaces. Directories are added to - the list with the ppuusshhdd command; the ppooppdd command removes + Without options, displays the list of currently remembered + directories. The default display is on a single line with + directory names separated by spaces. Directories are added to + the list with the ppuusshhdd command; the ppooppdd command removes entries from the list. ++_n Displays the _nth entry counting from the left of the list shown by ddiirrss when invoked without options, starting with zero. - --_n Displays the _nth entry counting from the right of the + --_n Displays the _nth entry counting from the right of the list shown by ddiirrss when invoked without options, starting with zero. --cc Clears the directory stack by deleting all of the entries. - --ll Produces a longer listing; the default listing format + --ll Produces a longer listing; the default listing format uses a tilde to denote the home directory. --pp Print the directory stack with one entry per line. - --vv Print the directory stack with one entry per line, pre- + --vv Print the directory stack with one entry per line, pre- fixing each entry with its index in the stack. - The return value is 0 unless an invalid option is supplied or _n + The return value is 0 unless an invalid option is supplied or _n indexes beyond the end of the directory stack. ddiissoowwnn [--aarr] [--hh] [_j_o_b_s_p_e_c ...] - Without options, each _j_o_b_s_p_e_c is removed from the table of - active jobs. If the --hh option is given, each _j_o_b_s_p_e_c is not + Without options, each _j_o_b_s_p_e_c is removed from the table of + active jobs. If the --hh option is given, each _j_o_b_s_p_e_c is not removed from the table, but is marked so that SSIIGGHHUUPP is not sent - to the job if the shell receives a SSIIGGHHUUPP. If no _j_o_b_s_p_e_c is - present, and neither the --aa nor the --rr option is supplied, the - _c_u_r_r_e_n_t _j_o_b is used. If no _j_o_b_s_p_e_c is supplied, the --aa option - means to remove or mark all jobs; the --rr option without a _j_o_b_- - _s_p_e_c argument restricts operation to running jobs. The return + to the job if the shell receives a SSIIGGHHUUPP. If no _j_o_b_s_p_e_c is + present, and neither the --aa nor the --rr option is supplied, the + _c_u_r_r_e_n_t _j_o_b is used. If no _j_o_b_s_p_e_c is supplied, the --aa option + means to remove or mark all jobs; the --rr option without a _j_o_b_- + _s_p_e_c argument restricts operation to running jobs. The return value is 0 unless a _j_o_b_s_p_e_c does not specify a valid job. eecchhoo [--nneeEE] [_a_r_g ...] - Output the _a_r_gs, separated by spaces, followed by a newline. + Output the _a_r_gs, separated by spaces, followed by a newline. The return status is always 0. If --nn is specified, the trailing - newline is suppressed. If the --ee option is given, interpreta- - tion of the following backslash-escaped characters is enabled. - The --EE option disables the interpretation of these escape char- - acters, even on systems where they are interpreted by default. - The xxppgg__eecchhoo shell option may be used to dynamically determine - whether or not eecchhoo expands these escape characters by default. - eecchhoo does not interpret ---- to mean the end of options. eecchhoo + newline is suppressed. If the --ee option is given, interpreta- + tion of the following backslash-escaped characters is enabled. + The --EE option disables the interpretation of these escape char- + acters, even on systems where they are interpreted by default. + The xxppgg__eecchhoo shell option may be used to dynamically determine + whether or not eecchhoo expands these escape characters by default. + eecchhoo does not interpret ---- to mean the end of options. eecchhoo interprets the following escape sequences: \\aa alert (bell) \\bb backspace @@ -3730,188 +3731,188 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS \\tt horizontal tab \\vv vertical tab \\\\ backslash - \\00_n_n_n the eight-bit character whose value is the octal value + \\00_n_n_n the eight-bit character whose value is the octal value _n_n_n (zero to three octal digits) - \\_n_n_n the eight-bit character whose value is the octal value + \\_n_n_n the eight-bit character whose value is the octal value _n_n_n (one to three octal digits) - \\xx_H_H the eight-bit character whose value is the hexadecimal + \\xx_H_H the eight-bit character whose value is the hexadecimal value _H_H (one or two hex digits) eennaabbllee [--aaddnnppss] [--ff _f_i_l_e_n_a_m_e] [_n_a_m_e ...] - Enable and disable builtin shell commands. Disabling a builtin + Enable and disable builtin shell commands. Disabling a builtin allows a disk command which has the same name as a shell builtin - to be executed without specifying a full pathname, even though - the shell normally searches for builtins before disk commands. - If --nn is used, each _n_a_m_e is disabled; otherwise, _n_a_m_e_s are + to be executed without specifying a full pathname, even though + the shell normally searches for builtins before disk commands. + If --nn is used, each _n_a_m_e is disabled; otherwise, _n_a_m_e_s are enabled. For example, to use the tteesstt binary found via the PPAATTHH - instead of the shell builtin version, run ``enable -n test''. - The --ff option means to load the new builtin command _n_a_m_e from + instead of the shell builtin version, run ``enable -n test''. + The --ff option means to load the new builtin command _n_a_m_e from shared object _f_i_l_e_n_a_m_e, on systems that support dynamic loading. - The --dd option will delete a builtin previously loaded with --ff. + The --dd option will delete a builtin previously loaded with --ff. If no _n_a_m_e arguments are given, or if the --pp option is supplied, a list of shell builtins is printed. With no other option argu- - ments, the list consists of all enabled shell builtins. If --nn - is supplied, only disabled builtins are printed. If --aa is sup- - plied, the list printed includes all builtins, with an indica- - tion of whether or not each is enabled. If --ss is supplied, the - output is restricted to the POSIX _s_p_e_c_i_a_l builtins. The return - value is 0 unless a _n_a_m_e is not a shell builtin or there is an + ments, the list consists of all enabled shell builtins. If --nn + is supplied, only disabled builtins are printed. If --aa is sup- + plied, the list printed includes all builtins, with an indica- + tion of whether or not each is enabled. If --ss is supplied, the + output is restricted to the POSIX _s_p_e_c_i_a_l builtins. The return + value is 0 unless a _n_a_m_e is not a shell builtin or there is an error loading a new builtin from a shared object. eevvaall [_a_r_g ...] - The _a_r_gs are read and concatenated together into a single com- - mand. This command is then read and executed by the shell, and - its exit status is returned as the value of eevvaall. If there are + The _a_r_gs are read and concatenated together into a single com- + mand. This command is then read and executed by the shell, and + its exit status is returned as the value of eevvaall. If there are no _a_r_g_s, or only null arguments, eevvaall returns 0. eexxeecc [--ccll] [--aa _n_a_m_e] [_c_o_m_m_a_n_d [_a_r_g_u_m_e_n_t_s]] - If _c_o_m_m_a_n_d is specified, it replaces the shell. No new process - is created. The _a_r_g_u_m_e_n_t_s become the arguments to _c_o_m_m_a_n_d. If + If _c_o_m_m_a_n_d is specified, it replaces the shell. No new process + is created. The _a_r_g_u_m_e_n_t_s become the arguments to _c_o_m_m_a_n_d. If the --ll option is supplied, the shell places a dash at the begin- ning of the zeroth arg passed to _c_o_m_m_a_n_d. This is what _l_o_g_i_n(1) does. The --cc option causes _c_o_m_m_a_n_d to be executed with an empty - environment. If --aa is supplied, the shell passes _n_a_m_e as the - zeroth argument to the executed command. If _c_o_m_m_a_n_d cannot be - executed for some reason, a non-interactive shell exits, unless - the shell option eexxeeccffaaiill is enabled, in which case it returns - failure. An interactive shell returns failure if the file can- - not be executed. If _c_o_m_m_a_n_d is not specified, any redirections - take effect in the current shell, and the return status is 0. + environment. If --aa is supplied, the shell passes _n_a_m_e as the + zeroth argument to the executed command. If _c_o_m_m_a_n_d cannot be + executed for some reason, a non-interactive shell exits, unless + the shell option eexxeeccffaaiill is enabled, in which case it returns + failure. An interactive shell returns failure if the file can- + not be executed. If _c_o_m_m_a_n_d is not specified, any redirections + take effect in the current shell, and the return status is 0. If there is a redirection error, the return status is 1. eexxiitt [_n] - Cause the shell to exit with a status of _n. If _n is omitted, + Cause the shell to exit with a status of _n. If _n is omitted, the exit status is that of the last command executed. A trap on EEXXIITT is executed before the shell terminates. eexxppoorrtt [--ffnn] [_n_a_m_e[=_w_o_r_d]] ... eexxppoorrtt --pp - The supplied _n_a_m_e_s are marked for automatic export to the envi- - ronment of subsequently executed commands. If the --ff option is - given, the _n_a_m_e_s refer to functions. If no _n_a_m_e_s are given, or - if the --pp option is supplied, a list of all names that are - exported in this shell is printed. The --nn option causes the - export property to be removed from each _n_a_m_e. If a variable - name is followed by =_w_o_r_d, the value of the variable is set to - _w_o_r_d. eexxppoorrtt returns an exit status of 0 unless an invalid - option is encountered, one of the _n_a_m_e_s is not a valid shell + The supplied _n_a_m_e_s are marked for automatic export to the envi- + ronment of subsequently executed commands. If the --ff option is + given, the _n_a_m_e_s refer to functions. If no _n_a_m_e_s are given, or + if the --pp option is supplied, a list of all names that are + exported in this shell is printed. The --nn option causes the + export property to be removed from each _n_a_m_e. If a variable + name is followed by =_w_o_r_d, the value of the variable is set to + _w_o_r_d. eexxppoorrtt returns an exit status of 0 unless an invalid + option is encountered, one of the _n_a_m_e_s is not a valid shell variable name, or --ff is supplied with a _n_a_m_e that is not a func- tion. ffcc [--ee _e_n_a_m_e] [--nnllrr] [_f_i_r_s_t] [_l_a_s_t] ffcc --ss [_p_a_t=_r_e_p] [_c_m_d] - Fix Command. In the first form, a range of commands from _f_i_r_s_t - to _l_a_s_t is selected from the history list. _F_i_r_s_t and _l_a_s_t may - be specified as a string (to locate the last command beginning - with that string) or as a number (an index into the history + Fix Command. In the first form, a range of commands from _f_i_r_s_t + to _l_a_s_t is selected from the history list. _F_i_r_s_t and _l_a_s_t may + be specified as a string (to locate the last command beginning + with that string) or as a number (an index into the history list, where a negative number is used as an offset from the cur- rent command number). If _l_a_s_t is not specified it is set to the - current command for listing (so that ``fc -l -10'' prints the + current command for listing (so that ``fc -l -10'' prints the last 10 commands) and to _f_i_r_s_t otherwise. If _f_i_r_s_t is not spec- - ified it is set to the previous command for editing and -16 for + ified it is set to the previous command for editing and -16 for listing. - The --nn option suppresses the command numbers when listing. The - --rr option reverses the order of the commands. If the --ll option - is given, the commands are listed on standard output. Other- - wise, the editor given by _e_n_a_m_e is invoked on a file containing - those commands. If _e_n_a_m_e is not given, the value of the FFCCEEDDIITT - variable is used, and the value of EEDDIITTOORR if FFCCEEDDIITT is not set. - If neither variable is set, _v_i is used. When editing is com- + The --nn option suppresses the command numbers when listing. The + --rr option reverses the order of the commands. If the --ll option + is given, the commands are listed on standard output. Other- + wise, the editor given by _e_n_a_m_e is invoked on a file containing + those commands. If _e_n_a_m_e is not given, the value of the FFCCEEDDIITT + variable is used, and the value of EEDDIITTOORR if FFCCEEDDIITT is not set. + If neither variable is set, _v_i is used. When editing is com- plete, the edited commands are echoed and executed. - In the second form, _c_o_m_m_a_n_d is re-executed after each instance - of _p_a_t is replaced by _r_e_p. A useful alias to use with this is - ``r="fc -s"'', so that typing ``r cc'' runs the last command + In the second form, _c_o_m_m_a_n_d is re-executed after each instance + of _p_a_t is replaced by _r_e_p. A useful alias to use with this is + ``r="fc -s"'', so that typing ``r cc'' runs the last command beginning with ``cc'' and typing ``r'' re-executes the last com- mand. - If the first form is used, the return value is 0 unless an - invalid option is encountered or _f_i_r_s_t or _l_a_s_t specify history - lines out of range. If the --ee option is supplied, the return + If the first form is used, the return value is 0 unless an + invalid option is encountered or _f_i_r_s_t or _l_a_s_t specify history + lines out of range. If the --ee option is supplied, the return value is the value of the last command executed or failure if an error occurs with the temporary file of commands. If the second - form is used, the return status is that of the command re-exe- - cuted, unless _c_m_d does not specify a valid history line, in + form is used, the return status is that of the command re-exe- + cuted, unless _c_m_d does not specify a valid history line, in which case ffcc returns failure. ffgg [_j_o_b_s_p_e_c] - Resume _j_o_b_s_p_e_c in the foreground, and make it the current job. + Resume _j_o_b_s_p_e_c in the foreground, and make it the current job. If _j_o_b_s_p_e_c is not present, the shell's notion of the _c_u_r_r_e_n_t _j_o_b - is used. The return value is that of the command placed into - the foreground, or failure if run when job control is disabled + is used. The return value is that of the command placed into + the foreground, or failure if run when job control is disabled or, when run with job control enabled, if _j_o_b_s_p_e_c does not spec- - ify a valid job or _j_o_b_s_p_e_c specifies a job that was started + ify a valid job or _j_o_b_s_p_e_c specifies a job that was started without job control. ggeettooppttss _o_p_t_s_t_r_i_n_g _n_a_m_e [_a_r_g_s] - ggeettooppttss is used by shell procedures to parse positional parame- - ters. _o_p_t_s_t_r_i_n_g contains the option characters to be recog- - nized; if a character is followed by a colon, the option is - expected to have an argument, which should be separated from it - by white space. The colon and question mark characters may not - be used as option characters. Each time it is invoked, ggeettooppttss - places the next option in the shell variable _n_a_m_e, initializing + ggeettooppttss is used by shell procedures to parse positional parame- + ters. _o_p_t_s_t_r_i_n_g contains the option characters to be recog- + nized; if a character is followed by a colon, the option is + expected to have an argument, which should be separated from it + by white space. The colon and question mark characters may not + be used as option characters. Each time it is invoked, ggeettooppttss + places the next option in the shell variable _n_a_m_e, initializing _n_a_m_e if it does not exist, and the index of the next argument to be processed into the variable OOPPTTIINNDD. OOPPTTIINNDD is initialized to - 1 each time the shell or a shell script is invoked. When an - option requires an argument, ggeettooppttss places that argument into - the variable OOPPTTAARRGG. The shell does not reset OOPPTTIINNDD automati- - cally; it must be manually reset between multiple calls to + 1 each time the shell or a shell script is invoked. When an + option requires an argument, ggeettooppttss places that argument into + the variable OOPPTTAARRGG. The shell does not reset OOPPTTIINNDD automati- + cally; it must be manually reset between multiple calls to ggeettooppttss within the same shell invocation if a new set of parame- ters is to be used. - When the end of options is encountered, ggeettooppttss exits with a - return value greater than zero. OOPPTTIINNDD is set to the index of + When the end of options is encountered, ggeettooppttss exits with a + return value greater than zero. OOPPTTIINNDD is set to the index of the first non-option argument, and nnaammee is set to ?. - ggeettooppttss normally parses the positional parameters, but if more + ggeettooppttss normally parses the positional parameters, but if more arguments are given in _a_r_g_s, ggeettooppttss parses those instead. - ggeettooppttss can report errors in two ways. If the first character - of _o_p_t_s_t_r_i_n_g is a colon, _s_i_l_e_n_t error reporting is used. In - normal operation diagnostic messages are printed when invalid - options or missing option arguments are encountered. If the - variable OOPPTTEERRRR is set to 0, no error messages will be dis- + ggeettooppttss can report errors in two ways. If the first character + of _o_p_t_s_t_r_i_n_g is a colon, _s_i_l_e_n_t error reporting is used. In + normal operation diagnostic messages are printed when invalid + options or missing option arguments are encountered. If the + variable OOPPTTEERRRR is set to 0, no error messages will be dis- played, even if the first character of _o_p_t_s_t_r_i_n_g is not a colon. If an invalid option is seen, ggeettooppttss places ? into _n_a_m_e and, if - not silent, prints an error message and unsets OOPPTTAARRGG. If - ggeettooppttss is silent, the option character found is placed in + not silent, prints an error message and unsets OOPPTTAARRGG. If + ggeettooppttss is silent, the option character found is placed in OOPPTTAARRGG and no diagnostic message is printed. - If a required argument is not found, and ggeettooppttss is not silent, - a question mark (??) is placed in _n_a_m_e, OOPPTTAARRGG is unset, and a - diagnostic message is printed. If ggeettooppttss is silent, then a - colon (::) is placed in _n_a_m_e and OOPPTTAARRGG is set to the option + If a required argument is not found, and ggeettooppttss is not silent, + a question mark (??) is placed in _n_a_m_e, OOPPTTAARRGG is unset, and a + diagnostic message is printed. If ggeettooppttss is silent, then a + colon (::) is placed in _n_a_m_e and OOPPTTAARRGG is set to the option character found. - ggeettooppttss returns true if an option, specified or unspecified, is + ggeettooppttss returns true if an option, specified or unspecified, is found. It returns false if the end of options is encountered or an error occurs. hhaasshh [--llrr] [--pp _f_i_l_e_n_a_m_e] [--ddtt] [_n_a_m_e] - For each _n_a_m_e, the full file name of the command is determined + For each _n_a_m_e, the full file name of the command is determined by searching the directories in $$PPAATTHH and remembered. If the --pp option is supplied, no path search is performed, and _f_i_l_e_n_a_m_e is used as the full file name of the command. The --rr option causes - the shell to forget all remembered locations. The --dd option + the shell to forget all remembered locations. The --dd option causes the shell to forget the remembered location of each _n_a_m_e. - If the --tt option is supplied, the full pathname to which each - _n_a_m_e corresponds is printed. If multiple _n_a_m_e arguments are - supplied with --tt, the _n_a_m_e is printed before the hashed full + If the --tt option is supplied, the full pathname to which each + _n_a_m_e corresponds is printed. If multiple _n_a_m_e arguments are + supplied with --tt, the _n_a_m_e is printed before the hashed full pathname. The --ll option causes output to be displayed in a for- - mat that may be reused as input. If no arguments are given, or + mat that may be reused as input. If no arguments are given, or if only --ll is supplied, information about remembered commands is - printed. The return status is true unless a _n_a_m_e is not found + printed. The return status is true unless a _n_a_m_e is not found or an invalid option is supplied. hheellpp [--ss] [_p_a_t_t_e_r_n] - Display helpful information about builtin commands. If _p_a_t_t_e_r_n - is specified, hheellpp gives detailed help on all commands matching - _p_a_t_t_e_r_n; otherwise help for all the builtins and shell control - structures is printed. The --ss option restricts the information - displayed to a short usage synopsis. The return status is 0 + Display helpful information about builtin commands. If _p_a_t_t_e_r_n + is specified, hheellpp gives detailed help on all commands matching + _p_a_t_t_e_r_n; otherwise help for all the builtins and shell control + structures is printed. The --ss option restricts the information + displayed to a short usage synopsis. The return status is 0 unless no command matches _p_a_t_t_e_r_n. hhiissttoorryy [[_n]] @@ -3922,41 +3923,41 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS hhiissttoorryy --ss _a_r_g [_a_r_g _._._.] With no options, display the command history list with line num- bers. Lines listed with a ** have been modified. An argument of - _n lists only the last _n lines. If the shell variable HHIISSTTTTIIMMEE-- - FFOORRMMAATT is set and not null, it is used as a format string for - _s_t_r_f_t_i_m_e(3) to display the time stamp associated with each dis- - played history entry. No intervening blank is printed between - the formatted time stamp and the history line. If _f_i_l_e_n_a_m_e is - supplied, it is used as the name of the history file; if not, - the value of HHIISSTTFFIILLEE is used. Options, if supplied, have the + _n lists only the last _n lines. If the shell variable HHIISSTTTTIIMMEE-- + FFOORRMMAATT is set and not null, it is used as a format string for + _s_t_r_f_t_i_m_e(3) to display the time stamp associated with each dis- + played history entry. No intervening blank is printed between + the formatted time stamp and the history line. If _f_i_l_e_n_a_m_e is + supplied, it is used as the name of the history file; if not, + the value of HHIISSTTFFIILLEE is used. Options, if supplied, have the following meanings: --cc Clear the history list by deleting all the entries. --dd _o_f_f_s_e_t Delete the history entry at position _o_f_f_s_e_t. - --aa Append the ``new'' history lines (history lines entered - since the beginning of the current bbaasshh session) to the + --aa Append the ``new'' history lines (history lines entered + since the beginning of the current bbaasshh session) to the history file. - --nn Read the history lines not already read from the history - file into the current history list. These are lines - appended to the history file since the beginning of the + --nn Read the history lines not already read from the history + file into the current history list. These are lines + appended to the history file since the beginning of the current bbaasshh session. --rr Read the contents of the history file and use them as the current history. - --ww Write the current history to the history file, overwrit- + --ww Write the current history to the history file, overwrit- ing the history file's contents. - --pp Perform history substitution on the following _a_r_g_s and - display the result on the standard output. Does not - store the results in the history list. Each _a_r_g must be + --pp Perform history substitution on the following _a_r_g_s and + display the result on the standard output. Does not + store the results in the history list. Each _a_r_g must be quoted to disable normal history expansion. - --ss Store the _a_r_g_s in the history list as a single entry. - The last command in the history list is removed before + --ss Store the _a_r_g_s in the history list as a single entry. + The last command in the history list is removed before the _a_r_g_s are added. If the HHIISSTTTTIIMMEEFFOORRMMAATT is set, the time stamp information associ- - ated with each history entry is written to the history file. - The return value is 0 unless an invalid option is encountered, - an error occurs while reading or writing the history file, an - invalid _o_f_f_s_e_t is supplied as an argument to --dd, or the history + ated with each history entry is written to the history file. + The return value is 0 unless an invalid option is encountered, + an error occurs while reading or writing the history file, an + invalid _o_f_f_s_e_t is supplied as an argument to --dd, or the history expansion supplied as an argument to --pp fails. jjoobbss [--llnnpprrss] [ _j_o_b_s_p_e_c ... ] @@ -3964,144 +3965,144 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS The first form lists the active jobs. The options have the fol- lowing meanings: --ll List process IDs in addition to the normal information. - --pp List only the process ID of the job's process group + --pp List only the process ID of the job's process group leader. - --nn Display information only about jobs that have changed - status since the user was last notified of their status. + --nn Display information only about jobs that have changed + status since the user was last notified of their status. --rr Restrict output to running jobs. --ss Restrict output to stopped jobs. - If _j_o_b_s_p_e_c is given, output is restricted to information about - that job. The return status is 0 unless an invalid option is + If _j_o_b_s_p_e_c is given, output is restricted to information about + that job. The return status is 0 unless an invalid option is encountered or an invalid _j_o_b_s_p_e_c is supplied. If the --xx option is supplied, jjoobbss replaces any _j_o_b_s_p_e_c found in - _c_o_m_m_a_n_d or _a_r_g_s with the corresponding process group ID, and + _c_o_m_m_a_n_d or _a_r_g_s with the corresponding process group ID, and executes _c_o_m_m_a_n_d passing it _a_r_g_s, returning its exit status. kkiillll [--ss _s_i_g_s_p_e_c | --nn _s_i_g_n_u_m | --_s_i_g_s_p_e_c] [_p_i_d | _j_o_b_s_p_e_c] ... kkiillll --ll [_s_i_g_s_p_e_c | _e_x_i_t___s_t_a_t_u_s] - Send the signal named by _s_i_g_s_p_e_c or _s_i_g_n_u_m to the processes - named by _p_i_d or _j_o_b_s_p_e_c. _s_i_g_s_p_e_c is either a case-insensitive - signal name such as SSIIGGKKIILLLL (with or without the SSIIGG prefix) or - a signal number; _s_i_g_n_u_m is a signal number. If _s_i_g_s_p_e_c is not - present, then SSIIGGTTEERRMM is assumed. An argument of --ll lists the - signal names. If any arguments are supplied when --ll is given, - the names of the signals corresponding to the arguments are + Send the signal named by _s_i_g_s_p_e_c or _s_i_g_n_u_m to the processes + named by _p_i_d or _j_o_b_s_p_e_c. _s_i_g_s_p_e_c is either a case-insensitive + signal name such as SSIIGGKKIILLLL (with or without the SSIIGG prefix) or + a signal number; _s_i_g_n_u_m is a signal number. If _s_i_g_s_p_e_c is not + present, then SSIIGGTTEERRMM is assumed. An argument of --ll lists the + signal names. If any arguments are supplied when --ll is given, + the names of the signals corresponding to the arguments are listed, and the return status is 0. The _e_x_i_t___s_t_a_t_u_s argument to - --ll is a number specifying either a signal number or the exit - status of a process terminated by a signal. kkiillll returns true - if at least one signal was successfully sent, or false if an + --ll is a number specifying either a signal number or the exit + status of a process terminated by a signal. kkiillll returns true + if at least one signal was successfully sent, or false if an error occurs or an invalid option is encountered. lleett _a_r_g [_a_r_g ...] Each _a_r_g is an arithmetic expression to be evaluated (see AARRIITTHH-- - MMEETTIICC EEVVAALLUUAATTIIOONN). If the last _a_r_g evaluates to 0, lleett returns + MMEETTIICC EEVVAALLUUAATTIIOONN). If the last _a_r_g evaluates to 0, lleett returns 1; 0 is returned otherwise. llooccaall [_o_p_t_i_o_n] [_n_a_m_e[=_v_a_l_u_e] ...] - For each argument, a local variable named _n_a_m_e is created, and - assigned _v_a_l_u_e. The _o_p_t_i_o_n can be any of the options accepted + For each argument, a local variable named _n_a_m_e is created, and + assigned _v_a_l_u_e. The _o_p_t_i_o_n can be any of the options accepted by ddeeccllaarree. When llooccaall is used within a function, it causes the - variable _n_a_m_e to have a visible scope restricted to that func- + variable _n_a_m_e to have a visible scope restricted to that func- tion and its children. With no operands, llooccaall writes a list of - local variables to the standard output. It is an error to use + local variables to the standard output. It is an error to use llooccaall when not within a function. The return status is 0 unless - llooccaall is used outside a function, an invalid _n_a_m_e is supplied, + llooccaall is used outside a function, an invalid _n_a_m_e is supplied, or _n_a_m_e is a readonly variable. llooggoouutt Exit a login shell. ppooppdd [-nn] [+_n] [-_n] - Removes entries from the directory stack. With no arguments, - removes the top directory from the stack, and performs a ccdd to + Removes entries from the directory stack. With no arguments, + removes the top directory from the stack, and performs a ccdd to the new top directory. Arguments, if supplied, have the follow- ing meanings: - ++_n Removes the _nth entry counting from the left of the list - shown by ddiirrss, starting with zero. For example: ``popd + ++_n Removes the _nth entry counting from the left of the list + shown by ddiirrss, starting with zero. For example: ``popd +0'' removes the first directory, ``popd +1'' the second. --_n Removes the _nth entry counting from the right of the list - shown by ddiirrss, starting with zero. For example: ``popd - -0'' removes the last directory, ``popd -1'' the next to + shown by ddiirrss, starting with zero. For example: ``popd + -0'' removes the last directory, ``popd -1'' the next to last. - --nn Suppresses the normal change of directory when removing - directories from the stack, so that only the stack is + --nn Suppresses the normal change of directory when removing + directories from the stack, so that only the stack is manipulated. - If the ppooppdd command is successful, a ddiirrss is performed as well, - and the return status is 0. ppooppdd returns false if an invalid + If the ppooppdd command is successful, a ddiirrss is performed as well, + and the return status is 0. ppooppdd returns false if an invalid option is encountered, the directory stack is empty, a non-exis- tent directory stack entry is specified, or the directory change fails. pprriinnttff _f_o_r_m_a_t [_a_r_g_u_m_e_n_t_s] - Write the formatted _a_r_g_u_m_e_n_t_s to the standard output under the - control of the _f_o_r_m_a_t. The _f_o_r_m_a_t is a character string which - contains three types of objects: plain characters, which are - simply copied to standard output, character escape sequences, - which are converted and copied to the standard output, and for- - mat specifications, each of which causes printing of the next + Write the formatted _a_r_g_u_m_e_n_t_s to the standard output under the + control of the _f_o_r_m_a_t. The _f_o_r_m_a_t is a character string which + contains three types of objects: plain characters, which are + simply copied to standard output, character escape sequences, + which are converted and copied to the standard output, and for- + mat specifications, each of which causes printing of the next successive _a_r_g_u_m_e_n_t. In addition to the standard _p_r_i_n_t_f(1) for- - mats, %%bb causes pprriinnttff to expand backslash escape sequences in - the corresponding _a_r_g_u_m_e_n_t (except that \\cc terminates output, + mats, %%bb causes pprriinnttff to expand backslash escape sequences in + the corresponding _a_r_g_u_m_e_n_t (except that \\cc terminates output, backslashes in \\'', \\"", and \\?? are not removed, and octal escapes - beginning with \\00 may contain up to four digits), and %%qq causes + beginning with \\00 may contain up to four digits), and %%qq causes pprriinnttff to output the corresponding _a_r_g_u_m_e_n_t in a format that can be reused as shell input. - The _f_o_r_m_a_t is reused as necessary to consume all of the _a_r_g_u_- + The _f_o_r_m_a_t is reused as necessary to consume all of the _a_r_g_u_- _m_e_n_t_s. If the _f_o_r_m_a_t requires more _a_r_g_u_m_e_n_t_s than are supplied, - the extra format specifications behave as if a zero value or - null string, as appropriate, had been supplied. The return + the extra format specifications behave as if a zero value or + null string, as appropriate, had been supplied. The return value is zero on success, non-zero on failure. ppuusshhdd [--nn] [_d_i_r] ppuusshhdd [--nn] [+_n] [-_n] - Adds a directory to the top of the directory stack, or rotates - the stack, making the new top of the stack the current working + Adds a directory to the top of the directory stack, or rotates + the stack, making the new top of the stack the current working directory. With no arguments, exchanges the top two directories - and returns 0, unless the directory stack is empty. Arguments, + and returns 0, unless the directory stack is empty. Arguments, if supplied, have the following meanings: - ++_n Rotates the stack so that the _nth directory (counting - from the left of the list shown by ddiirrss, starting with + ++_n Rotates the stack so that the _nth directory (counting + from the left of the list shown by ddiirrss, starting with zero) is at the top. - --_n Rotates the stack so that the _nth directory (counting - from the right of the list shown by ddiirrss, starting with + --_n Rotates the stack so that the _nth directory (counting + from the right of the list shown by ddiirrss, starting with zero) is at the top. - --nn Suppresses the normal change of directory when adding - directories to the stack, so that only the stack is + --nn Suppresses the normal change of directory when adding + directories to the stack, so that only the stack is manipulated. _d_i_r Adds _d_i_r to the directory stack at the top, making it the new current working directory. If the ppuusshhdd command is successful, a ddiirrss is performed as well. - If the first form is used, ppuusshhdd returns 0 unless the cd to _d_i_r - fails. With the second form, ppuusshhdd returns 0 unless the direc- - tory stack is empty, a non-existent directory stack element is - specified, or the directory change to the specified new current + If the first form is used, ppuusshhdd returns 0 unless the cd to _d_i_r + fails. With the second form, ppuusshhdd returns 0 unless the direc- + tory stack is empty, a non-existent directory stack element is + specified, or the directory change to the specified new current directory fails. ppwwdd [--LLPP] - Print the absolute pathname of the current working directory. + Print the absolute pathname of the current working directory. The pathname printed contains no symbolic links if the --PP option is supplied or the --oo pphhyyssiiccaall option to the sseett builtin command - is enabled. If the --LL option is used, the pathname printed may - contain symbolic links. The return status is 0 unless an error - occurs while reading the name of the current directory or an + is enabled. If the --LL option is used, the pathname printed may + contain symbolic links. The return status is 0 unless an error + occurs while reading the name of the current directory or an invalid option is supplied. rreeaadd [--eerrss] [--uu _f_d] [--tt _t_i_m_e_o_u_t] [--aa _a_n_a_m_e] [--pp _p_r_o_m_p_t] [--nn _n_c_h_a_r_s] [--dd _d_e_l_i_m] [_n_a_m_e ...] - One line is read from the standard input, or from the file - descriptor _f_d supplied as an argument to the --uu option, and the + One line is read from the standard input, or from the file + descriptor _f_d supplied as an argument to the --uu option, and the first word is assigned to the first _n_a_m_e, the second word to the - second _n_a_m_e, and so on, with leftover words and their interven- - ing separators assigned to the last _n_a_m_e. If there are fewer + second _n_a_m_e, and so on, with leftover words and their interven- + ing separators assigned to the last _n_a_m_e. If there are fewer words read from the input stream than names, the remaining names - are assigned empty values. The characters in IIFFSS are used to - split the line into words. The backslash character (\\) may be - used to remove any special meaning for the next character read - and for line continuation. Options, if supplied, have the fol- + are assigned empty values. The characters in IIFFSS are used to + split the line into words. The backslash character (\\) may be + used to remove any special meaning for the next character read + and for line continuation. Options, if supplied, have the fol- lowing meanings: --aa _a_n_a_m_e The words are assigned to sequential indices of the array @@ -4109,100 +4110,100 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS new values are assigned. Other _n_a_m_e arguments are ignored. --dd _d_e_l_i_m - The first character of _d_e_l_i_m is used to terminate the + The first character of _d_e_l_i_m is used to terminate the input line, rather than newline. --ee If the standard input is coming from a terminal, rreeaaddlliinnee (see RREEAADDLLIINNEE above) is used to obtain the line. --nn _n_c_h_a_r_s - rreeaadd returns after reading _n_c_h_a_r_s characters rather than + rreeaadd returns after reading _n_c_h_a_r_s characters rather than waiting for a complete line of input. --pp _p_r_o_m_p_t Display _p_r_o_m_p_t on standard error, without a trailing new- line, before attempting to read any input. The prompt is displayed only if input is coming from a terminal. --rr Backslash does not act as an escape character. The back- - slash is considered to be part of the line. In particu- - lar, a backslash-newline pair may not be used as a line + slash is considered to be part of the line. In particu- + lar, a backslash-newline pair may not be used as a line continuation. --ss Silent mode. If input is coming from a terminal, charac- ters are not echoed. --tt _t_i_m_e_o_u_t - Cause rreeaadd to time out and return failure if a complete - line of input is not read within _t_i_m_e_o_u_t seconds. This - option has no effect if rreeaadd is not reading input from + Cause rreeaadd to time out and return failure if a complete + line of input is not read within _t_i_m_e_o_u_t seconds. This + option has no effect if rreeaadd is not reading input from the terminal or a pipe. --uu _f_d Read input from file descriptor _f_d. If no _n_a_m_e_s are supplied, the line read is assigned to the vari- - able RREEPPLLYY. The return code is zero, unless end-of-file is - encountered, rreeaadd times out, or an invalid file descriptor is + able RREEPPLLYY. The return code is zero, unless end-of-file is + encountered, rreeaadd times out, or an invalid file descriptor is supplied as the argument to --uu. rreeaaddoonnllyy [--aappff] [_n_a_m_e[=_w_o_r_d] ...] - The given _n_a_m_e_s are marked readonly; the values of these _n_a_m_e_s - may not be changed by subsequent assignment. If the --ff option - is supplied, the functions corresponding to the _n_a_m_e_s are so + The given _n_a_m_e_s are marked readonly; the values of these _n_a_m_e_s + may not be changed by subsequent assignment. If the --ff option + is supplied, the functions corresponding to the _n_a_m_e_s are so marked. The --aa option restricts the variables to arrays. If no - _n_a_m_e arguments are given, or if the --pp option is supplied, a - list of all readonly names is printed. The --pp option causes - output to be displayed in a format that may be reused as input. - If a variable name is followed by =_w_o_r_d, the value of the vari- - able is set to _w_o_r_d. The return status is 0 unless an invalid - option is encountered, one of the _n_a_m_e_s is not a valid shell + _n_a_m_e arguments are given, or if the --pp option is supplied, a + list of all readonly names is printed. The --pp option causes + output to be displayed in a format that may be reused as input. + If a variable name is followed by =_w_o_r_d, the value of the vari- + able is set to _w_o_r_d. The return status is 0 unless an invalid + option is encountered, one of the _n_a_m_e_s is not a valid shell variable name, or --ff is supplied with a _n_a_m_e that is not a func- tion. rreettuurrnn [_n] - Causes a function to exit with the return value specified by _n. - If _n is omitted, the return status is that of the last command - executed in the function body. If used outside a function, but - during execution of a script by the .. (ssoouurrccee) command, it + Causes a function to exit with the return value specified by _n. + If _n is omitted, the return status is that of the last command + executed in the function body. If used outside a function, but + during execution of a script by the .. (ssoouurrccee) command, it causes the shell to stop executing that script and return either - _n or the exit status of the last command executed within the - script as the exit status of the script. If used outside a - function and not during execution of a script by .., the return + _n or the exit status of the last command executed within the + script as the exit status of the script. If used outside a + function and not during execution of a script by .., the return status is false. Any command associated with the RREETTUURRNN trap is - executed before execution resumes after the function or script. + executed before execution resumes after the function or script. sseett [----aabbeeffhhkkmmnnppttuuvvxxBBCCHHPP] [--oo _o_p_t_i_o_n] [_a_r_g ...] - Without options, the name and value of each shell variable are + Without options, the name and value of each shell variable are displayed in a format that can be reused as input for setting or resetting the currently-set variables. Read-only variables can- - not be reset. In _p_o_s_i_x _m_o_d_e, only shell variables are listed. - The output is sorted according to the current locale. When - options are specified, they set or unset shell attributes. Any - arguments remaining after the options are processed are treated - as values for the positional parameters and are assigned, in + not be reset. In _p_o_s_i_x _m_o_d_e, only shell variables are listed. + The output is sorted according to the current locale. When + options are specified, they set or unset shell attributes. Any + arguments remaining after the options are processed are treated + as values for the positional parameters and are assigned, in order, to $$11, $$22, ...... $$_n. Options, if specified, have the fol- lowing meanings: - --aa Automatically mark variables and functions which are - modified or created for export to the environment of + --aa Automatically mark variables and functions which are + modified or created for export to the environment of subsequent commands. - --bb Report the status of terminated background jobs immedi- + --bb Report the status of terminated background jobs immedi- ately, rather than before the next primary prompt. This is effective only when job control is enabled. - --ee Exit immediately if a _s_i_m_p_l_e _c_o_m_m_a_n_d (see SSHHEELLLL GGRRAAMMMMAARR + --ee Exit immediately if a _s_i_m_p_l_e _c_o_m_m_a_n_d (see SSHHEELLLL GGRRAAMMMMAARR above) exits with a non-zero status. The shell does not - exit if the command that fails is part of the command - list immediately following a wwhhiillee or uunnttiill keyword, - part of the test in an _i_f statement, part of a &&&& or |||| + exit if the command that fails is part of the command + list immediately following a wwhhiillee or uunnttiill keyword, + part of the test in an _i_f statement, part of a &&&& or |||| list, or if the command's return value is being inverted - via !!. A trap on EERRRR, if set, is executed before the + via !!. A trap on EERRRR, if set, is executed before the shell exits. --ff Disable pathname expansion. - --hh Remember the location of commands as they are looked up + --hh Remember the location of commands as they are looked up for execution. This is enabled by default. - --kk All arguments in the form of assignment statements are - placed in the environment for a command, not just those + --kk All arguments in the form of assignment statements are + placed in the environment for a command, not just those that precede the command name. - --mm Monitor mode. Job control is enabled. This option is - on by default for interactive shells on systems that - support it (see JJOOBB CCOONNTTRROOLL above). Background pro- - cesses run in a separate process group and a line con- - taining their exit status is printed upon their comple- + --mm Monitor mode. Job control is enabled. This option is + on by default for interactive shells on systems that + support it (see JJOOBB CCOONNTTRROOLL above). Background pro- + cesses run in a separate process group and a line con- + taining their exit status is printed upon their comple- tion. --nn Read commands but do not execute them. This may be used - to check a shell script for syntax errors. This is + to check a shell script for syntax errors. This is ignored by interactive shells. --oo _o_p_t_i_o_n_-_n_a_m_e The _o_p_t_i_o_n_-_n_a_m_e can be one of the following: @@ -4210,7 +4211,7 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS Same as --aa. bbrraacceeeexxppaanndd Same as --BB. - eemmaaccss Use an emacs-style command line editing inter- + eemmaaccss Use an emacs-style command line editing inter- face. This is enabled by default when the shell is interactive, unless the shell is started with the ----nnooeeddiittiinngg option. @@ -4223,11 +4224,11 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS hhiisstteexxppaanndd Same as --HH. hhiissttoorryy Enable command history, as described above under - HHIISSTTOORRYY. This option is on by default in inter- - active shells. + HHIISSTTOORRYY. This option is on by default in + interactive shells. iiggnnoorreeeeooff - The effect is as if the shell command - ``IGNOREEOF=10'' had been executed (see SShheellll + The effect is as if the shell command + ``IGNOREEOF=10'' had been executed (see SShheellll VVaarriiaabblleess above). kkeeyywwoorrdd Same as --kk. mmoonniittoorr Same as --mm. @@ -4241,12 +4242,12 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS pphhyyssiiccaall Same as --PP. ppiippeeffaaiill - If set, the return value of a pipeline is the - value of the last (rightmost) command to exit - with a non-zero status, or zero if all commands - in the pipeline exit successfully. This option + If set, the return value of a pipeline is the + value of the last (rightmost) command to exit + with a non-zero status, or zero if all commands + in the pipeline exit successfully. This option is disabled by default. - ppoossiixx Change the behavior of bbaasshh where the default + ppoossiixx Change the behavior of bbaasshh where the default operation differs from the POSIX 1003.2 standard to match the standard (_p_o_s_i_x _m_o_d_e). pprriivviilleeggeedd @@ -4255,224 +4256,224 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS vvii Use a vi-style command line editing interface. xxttrraaccee Same as --xx. If --oo is supplied with no _o_p_t_i_o_n_-_n_a_m_e, the values of the - current options are printed. If ++oo is supplied with no - _o_p_t_i_o_n_-_n_a_m_e, a series of sseett commands to recreate the - current option settings is displayed on the standard + current options are printed. If ++oo is supplied with no + _o_p_t_i_o_n_-_n_a_m_e, a series of sseett commands to recreate the + current option settings is displayed on the standard output. - --pp Turn on _p_r_i_v_i_l_e_g_e_d mode. In this mode, the $$EENNVV and - $$BBAASSHH__EENNVV files are not processed, shell functions are - not inherited from the environment, and the SSHHEELLLLOOPPTTSS - variable, if it appears in the environment, is ignored. - If the shell is started with the effective user (group) - id not equal to the real user (group) id, and the --pp - option is not supplied, these actions are taken and the + --pp Turn on _p_r_i_v_i_l_e_g_e_d mode. In this mode, the $$EENNVV and + $$BBAASSHH__EENNVV files are not processed, shell functions are + not inherited from the environment, and the SSHHEELLLLOOPPTTSS + variable, if it appears in the environment, is ignored. + If the shell is started with the effective user (group) + id not equal to the real user (group) id, and the --pp + option is not supplied, these actions are taken and the effective user id is set to the real user id. If the --pp - option is supplied at startup, the effective user id is + option is supplied at startup, the effective user id is not reset. Turning this option off causes the effective - user and group ids to be set to the real user and group + user and group ids to be set to the real user and group ids. --tt Exit after reading and executing one command. --uu Treat unset variables as an error when performing param- - eter expansion. If expansion is attempted on an unset + eter expansion. If expansion is attempted on an unset variable, the shell prints an error message, and, if not interactive, exits with a non-zero status. --vv Print shell input lines as they are read. - --xx After expanding each _s_i_m_p_l_e _c_o_m_m_a_n_d, ffoorr command, ccaassee + --xx After expanding each _s_i_m_p_l_e _c_o_m_m_a_n_d, ffoorr command, ccaassee command, sseelleecctt command, or arithmetic ffoorr command, dis- - play the expanded value of PPSS44, followed by the command + play the expanded value of PPSS44, followed by the command and its expanded arguments or associated word list. - --BB The shell performs brace expansion (see BBrraaccee EExxppaannssiioonn + --BB The shell performs brace expansion (see BBrraaccee EExxppaannssiioonn above). This is on by default. - --CC If set, bbaasshh does not overwrite an existing file with - the >>, >>&&, and <<>> redirection operators. This may be + --CC If set, bbaasshh does not overwrite an existing file with + the >>, >>&&, and <<>> redirection operators. This may be overridden when creating output files by using the redi- rection operator >>|| instead of >>. --EE If set, any trap on EERRRR is inherited by shell functions, - command substitutions, and commands executed in a sub- - shell environment. The EERRRR trap is normally not inher- + command substitutions, and commands executed in a sub- + shell environment. The EERRRR trap is normally not inher- ited in such cases. --HH Enable !! style history substitution. This option is on by default when the shell is interactive. - --PP If set, the shell does not follow symbolic links when - executing commands such as ccdd that change the current + --PP If set, the shell does not follow symbolic links when + executing commands such as ccdd that change the current working directory. It uses the physical directory structure instead. By default, bbaasshh follows the logical - chain of directories when performing commands which + chain of directories when performing commands which change the current directory. - --TT If set, any trap on DDEEBBUUGG is inherited by shell func- - tions, command substitutions, and commands executed in a - subshell environment. The DDEEBBUUGG trap is normally not - inherited in such cases. - ---- If no arguments follow this option, then the positional + --TT If set, any traps on DDEEBBUUGG and RREETTUURRNN are inherited by + shell functions, command substitutions, and commands + executed in a subshell environment. The DDEEBBUUGG and + RREETTUURRNN traps are normally not inherited in such cases. + ---- If no arguments follow this option, then the positional parameters are unset. Otherwise, the positional parame- - ters are set to the _a_r_gs, even if some of them begin + ters are set to the _a_r_gs, even if some of them begin with a --. - -- Signal the end of options, cause all remaining _a_r_gs to + -- 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. - The options are off by default unless otherwise noted. Using + - rather than - causes these options to be turned off. The - options can also be specified as arguments to an invocation of - the shell. The current set of options may be found in $$--. The + The options are off by default unless otherwise noted. Using + + rather than - causes these options to be turned off. The + options can also be specified as arguments to an invocation of + the shell. The current set of options may be found in $$--. The return status is always true unless an invalid option is encoun- tered. sshhiifftt [_n] - The positional parameters from _n+1 ... are renamed to $$11 ........ - Parameters represented by the numbers $$## down to $$##-_n+1 are - unset. _n must be a non-negative number less than or equal to - $$##. If _n is 0, no parameters are changed. If _n is not given, - it is assumed to be 1. If _n is greater than $$##, the positional - parameters are not changed. The return status is greater than + The positional parameters from _n+1 ... are renamed to $$11 ........ + Parameters represented by the numbers $$## down to $$##-_n+1 are + unset. _n must be a non-negative number less than or equal to + $$##. If _n is 0, no parameters are changed. If _n is not given, + it is assumed to be 1. If _n is greater than $$##, the positional + parameters are not changed. The return status is greater than zero if _n is greater than $$## or less than zero; otherwise 0. sshhoopptt [--ppqqssuu] [--oo] [_o_p_t_n_a_m_e ...] Toggle the values of variables controlling optional shell behav- ior. With no options, or with the --pp option, a list of all set- table options is displayed, with an indication of whether or not - each is set. The --pp option causes output to be displayed in a - form that may be reused as input. Other options have the fol- + each is set. The --pp option causes output to be displayed in a + form that may be reused as input. Other options have the fol- lowing meanings: --ss Enable (set) each _o_p_t_n_a_m_e. --uu Disable (unset) each _o_p_t_n_a_m_e. - --qq Suppresses normal output (quiet mode); the return status + --qq Suppresses normal output (quiet mode); the return status indicates whether the _o_p_t_n_a_m_e is set or unset. If multi- - ple _o_p_t_n_a_m_e arguments are given with --qq, the return sta- - tus is zero if all _o_p_t_n_a_m_e_s are enabled; non-zero other- + ple _o_p_t_n_a_m_e arguments are given with --qq, the return sta- + tus is zero if all _o_p_t_n_a_m_e_s are enabled; non-zero other- wise. - --oo Restricts the values of _o_p_t_n_a_m_e to be those defined for + --oo Restricts the values of _o_p_t_n_a_m_e to be those defined for the --oo option to the sseett builtin. - If either --ss or --uu is used with no _o_p_t_n_a_m_e arguments, the dis- + If either --ss or --uu is used with no _o_p_t_n_a_m_e arguments, the dis- play is limited to those options which are set or unset, respec- - tively. Unless otherwise noted, the sshhoopptt options are disabled + tively. Unless otherwise noted, the sshhoopptt options are disabled (unset) by default. - The return status when listing options is zero if all _o_p_t_n_a_m_e_s - are enabled, non-zero otherwise. When setting or unsetting - options, the return status is zero unless an _o_p_t_n_a_m_e is not a + The return status when listing options is zero if all _o_p_t_n_a_m_e_s + are enabled, non-zero otherwise. When setting or unsetting + options, the return status is zero unless an _o_p_t_n_a_m_e is not a valid shell option. The list of sshhoopptt options is: ccddaabbllee__vvaarrss - If set, an argument to the ccdd builtin command that is - not a directory is assumed to be the name of a variable + If set, an argument to the ccdd builtin command that is + not a directory is assumed to be the name of a variable 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 + ponent in a ccdd command will be corrected. The errors 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 + 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 - command no longer exists, a normal path search is per- + ble exists before trying to execute it. If a hashed + command no longer exists, a normal path search is per- formed. cchheecckkwwiinnssiizzee - If set, bbaasshh checks the window size after each command - and, if necessary, updates the values of LLIINNEESS and + If set, bbaasshh checks the window size after each command + and, if necessary, updates the values of LLIINNEESS and CCOOLLUUMMNNSS. - ccmmddhhiisstt If set, bbaasshh attempts to save all lines of a multiple- - line command in the same history entry. This allows + ccmmddhhiisstt If set, bbaasshh attempts to save all lines of a multiple- + line command in the same history entry. This allows easy re-editing of multi-line commands. - ddoottgglloobb If set, bbaasshh includes filenames beginning with a `.' in + ddoottgglloobb If set, bbaasshh includes filenames beginning with a `.' in the results of pathname expansion. eexxeeccffaaiill If set, a non-interactive shell will not exit if it can- - not execute the file specified as an argument to the - eexxeecc builtin command. An interactive shell does not + not execute the file specified as an argument to the + eexxeecc builtin command. An interactive shell does not exit if eexxeecc fails. eexxppaanndd__aalliiaasseess - If set, aliases are expanded as described above under + If set, aliases are expanded as described above under AALLIIAASSEESS. This option is enabled by default for interac- tive shells. eexxttddeebbuugg - If set, behavior intended for use by debuggers is + If set, behavior intended for use by debuggers is enabled: 11.. The --FF option to the ddeeccllaarree builtin displays the source file name and line number corresponding to each function name supplied as an argument. - 22.. If the command run by the DDEEBBUUGG trap returns a - non-zero value, the next command is skipped and + 22.. If the command run by the DDEEBBUUGG trap returns a + non-zero value, the next command is skipped and not executed. - 33.. If the command run by the DDEEBBUUGG trap returns a - value of 2, and the shell is executing in a sub- - routine (a shell function or a shell script exe- - cuted by the .. or ssoouurrccee builtins), a call to + 33.. If the command run by the DDEEBBUUGG trap returns a + value of 2, and the shell is executing in a sub- + routine (a shell function or a shell script exe- + cuted by the .. or ssoouurrccee builtins), a call to rreettuurrnn is simulated. eexxttgglloobb If set, the extended pattern matching features described above under PPaatthhnnaammee EExxppaannssiioonn are enabled. eexxttqquuoottee - If set, $$'_s_t_r_i_n_g' and $$"_s_t_r_i_n_g" quoting is performed - within $${{_p_a_r_a_m_e_t_e_r}} expansions enclosed in double + If set, $$'_s_t_r_i_n_g' and $$"_s_t_r_i_n_g" quoting is performed + within $${{_p_a_r_a_m_e_t_e_r}} expansions enclosed in double quotes. This option is enabled by default. ffaaiillgglloobb - If set, patterns which fail to match filenames during + If set, patterns which fail to match filenames during pathname expansion result in an expansion error. ffoorrccee__ffiiggnnoorree - If set, the suffixes specified by the FFIIGGNNOORREE shell - variable cause words to be ignored when performing word + If set, the suffixes specified by the FFIIGGNNOORREE shell + variable cause words to be ignored when performing word completion even if the ignored words are the only possi- ble completions. See SSHHEELLLL VVAARRIIAABBLLEESS above for a - description of FFIIGGNNOORREE. This option is enabled by + description of FFIIGGNNOORREE. This option is enabled by default. ggnnuu__eerrrrffmmtt If set, shell error messages are written in the standard GNU error message format. hhiissttaappppeenndd - If set, the history list is appended to the file named - by the value of the HHIISSTTFFIILLEE variable when the shell + If set, the history list is appended to the file named + by the value of the HHIISSTTFFIILLEE variable when the shell exits, rather than overwriting the file. hhiissttrreeeeddiitt - If set, and rreeaaddlliinnee is being used, a user is given the + If set, and rreeaaddlliinnee is being used, a user is given the opportunity to re-edit a failed history substitution. hhiissttvveerriiffyy - If set, and rreeaaddlliinnee is being used, the results of his- - tory substitution are not immediately passed to the - shell parser. Instead, the resulting line is loaded + If set, and rreeaaddlliinnee is being used, the results of his- + tory substitution are not immediately passed to the + shell parser. Instead, the resulting line is loaded into the rreeaaddlliinnee editing buffer, allowing further modi- fication. hhoossttccoommpplleettee If set, and rreeaaddlliinnee is being used, bbaasshh will attempt to - perform hostname completion when a word containing a @@ - is being completed (see CCoommpplleettiinngg under RREEAADDLLIINNEE + perform hostname completion when a word containing a @@ + is being completed (see CCoommpplleettiinngg under RREEAADDLLIINNEE above). This is enabled by default. hhuuppoonneexxiitt If set, bbaasshh will send SSIIGGHHUUPP to all jobs when an inter- active login shell exits. iinntteerraaccttiivvee__ccoommmmeennttss If set, allow a word beginning with ## to cause that word - and all remaining characters on that line to be ignored - in an interactive shell (see CCOOMMMMEENNTTSS above). This + and all remaining characters on that line to be ignored + in an interactive shell (see CCOOMMMMEENNTTSS above). This option is enabled by default. - lliitthhiisstt If set, and the ccmmddhhiisstt option is enabled, multi-line + lliitthhiisstt If set, and the ccmmddhhiisstt option is enabled, multi-line commands are saved to the history with embedded newlines rather than using semicolon separators where possible. llooggiinn__sshheellll - The shell sets this option if it is started as a login - shell (see IINNVVOOCCAATTIIOONN above). The value may not be + The shell sets this option if it is started as a login + shell (see IINNVVOOCCAATTIIOONN above). The value may not be changed. mmaaiillwwaarrnn - If set, and a file that bbaasshh is checking for mail has - been accessed since the last time it was checked, the - message ``The mail in _m_a_i_l_f_i_l_e has been read'' is dis- + If set, and a file that bbaasshh is checking for mail has + been accessed since the last time it was checked, the + message ``The mail in _m_a_i_l_f_i_l_e has been read'' is dis- played. nnoo__eemmppttyy__ccmmdd__ccoommpplleettiioonn - If set, and rreeaaddlliinnee is being used, bbaasshh will not + If set, and rreeaaddlliinnee is being used, bbaasshh will not attempt to search the PPAATTHH for possible completions when completion is attempted on an empty line. nnooccaasseegglloobb - If set, bbaasshh matches filenames in a case-insensitive + If set, bbaasshh matches filenames in a case-insensitive fashion when performing pathname expansion (see PPaatthhnnaammee EExxppaannssiioonn above). nnuullllgglloobb - If set, bbaasshh allows patterns which match no files (see - PPaatthhnnaammee EExxppaannssiioonn above) to expand to a null string, + If set, bbaasshh allows patterns which match no files (see + PPaatthhnnaammee EExxppaannssiioonn above) to expand to a null string, rather than themselves. pprrooggccoommpp If set, the programmable completion facilities (see PPrroo-- @@ -4480,44 +4481,44 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS enabled by default. pprroommppttvvaarrss If set, prompt strings undergo parameter expansion, com- - mand substitution, arithmetic expansion, and quote - removal after being expanded as described in PPRROOMMPPTTIINNGG + mand substitution, arithmetic expansion, and quote + removal after being expanded as described in PPRROOMMPPTTIINNGG above. This option is enabled by default. rreessttrriicctteedd__sshheellll - The shell sets this option if it is started in + The shell sets this option if it is started in restricted mode (see RREESSTTRRIICCTTEEDD SSHHEELLLL below). The value - may not be changed. This is not reset when the startup - files are executed, allowing the startup files to dis- + may not be changed. This is not reset when the startup + files are executed, allowing the startup files to dis- cover whether or not a shell is restricted. sshhiifftt__vveerrbboossee - If set, the sshhiifftt builtin prints an error message when + If set, the sshhiifftt builtin prints an error message when the shift count exceeds the number of positional parame- ters. ssoouurrcceeppaatthh If set, the ssoouurrccee (..) builtin uses the value of PPAATTHH to - find the directory containing the file supplied as an + find the directory containing the file supplied as an argument. This option is enabled by default. xxppgg__eecchhoo - If set, the eecchhoo builtin expands backslash-escape + If set, the eecchhoo builtin expands backslash-escape sequences by default. ssuussppeenndd [--ff] - Suspend the execution of this shell until it receives a SSIIGGCCOONNTT - signal. The --ff option says not to complain if this is a login - shell; just suspend anyway. The return status is 0 unless the + Suspend the execution of this shell until it receives a SSIIGGCCOONNTT + signal. The --ff option says not to complain if this is a login + shell; just suspend anyway. The return status is 0 unless the shell is a login shell and --ff is not supplied, or if job control is not enabled. tteesstt _e_x_p_r [[ _e_x_p_r ]] - Return a status of 0 or 1 depending on the evaluation of the - conditional expression _e_x_p_r. Each operator and operand must be - a separate argument. Expressions are composed of the primaries + Return a status of 0 or 1 depending on the evaluation of the + conditional expression _e_x_p_r. Each operator and operand must be + a separate argument. Expressions are composed of the primaries described above under CCOONNDDIITTIIOONNAALL EEXXPPRREESSSSIIOONNSS. - Expressions may be combined using the following operators, + Expressions may be combined using the following operators, listed in decreasing order of precedence. !! _e_x_p_r True if _e_x_p_r is false. (( _e_x_p_r )) - Returns the value of _e_x_p_r. This may be used to override + Returns the value of _e_x_p_r. This may be used to override the normal precedence of operators. _e_x_p_r_1 -aa _e_x_p_r_2 True if both _e_x_p_r_1 and _e_x_p_r_2 are true. @@ -4534,109 +4535,109 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS null. 2 arguments If the first argument is !!, the expression is true if and - only if the second argument is null. If the first argu- - ment is one of the unary conditional operators listed - above under CCOONNDDIITTIIOONNAALL EEXXPPRREESSSSIIOONNSS, the expression is + only if the second argument is null. If the first argu- + ment is one of the unary conditional operators listed + above under CCOONNDDIITTIIOONNAALL EEXXPPRREESSSSIIOONNSS, the expression is true if the unary test is true. If the first argument is not a valid unary conditional operator, the expression is false. 3 arguments - If the second argument is one of the binary conditional + If the second argument is one of the binary conditional operators listed above under CCOONNDDIITTIIOONNAALL EEXXPPRREESSSSIIOONNSS, the result of the expression is the result of the binary test - using the first and third arguments as operands. If the - first argument is !!, the value is the negation of the - two-argument test using the second and third arguments. + using the first and third arguments as operands. If the + first argument is !!, the value is the negation of the + two-argument test using the second and third arguments. If the first argument is exactly (( and the third argument - is exactly )), the result is the one-argument test of the - second argument. Otherwise, the expression is false. - The --aa and --oo operators are considered binary operators + is exactly )), the result is the one-argument test of the + second argument. Otherwise, the expression is false. + The --aa and --oo operators are considered binary operators in this case. 4 arguments If the first argument is !!, the result is the negation of - the three-argument expression composed of the remaining + the three-argument expression composed of the remaining arguments. Otherwise, the expression is parsed and eval- - uated according to precedence using the rules listed + uated according to precedence using the rules listed above. 5 or more arguments - The expression is parsed and evaluated according to + The expression is parsed and evaluated according to precedence using the rules listed above. - ttiimmeess Print the accumulated user and system times for the shell and + ttiimmeess Print the accumulated user and system times for the shell and for processes run from the shell. The return status is 0. ttrraapp [--llpp] [[_a_r_g] _s_i_g_s_p_e_c ...] - The command _a_r_g is to be read and executed when the shell - receives signal(s) _s_i_g_s_p_e_c. If _a_r_g is absent (and there is a - single _s_i_g_s_p_e_c) or --, each specified signal is reset to its - original disposition (the value it had upon entrance to the - shell). If _a_r_g is the null string the signal specified by each - _s_i_g_s_p_e_c is ignored by the shell and by the commands it invokes. - If _a_r_g is not present and --pp has been supplied, then the trap - commands associated with each _s_i_g_s_p_e_c are displayed. If no - arguments are supplied or if only --pp is given, ttrraapp prints the - list of commands associated with each signal. The --ll option - causes the shell to print a list of signal names and their cor- - responding numbers. Each _s_i_g_s_p_e_c is either a signal name - defined in <_s_i_g_n_a_l_._h>, or a signal number. Signal names are - case insensitive and the SIG prefix is optional. If a _s_i_g_s_p_e_c - is EEXXIITT (0) the command _a_r_g is executed on exit from the shell. - If a _s_i_g_s_p_e_c is DDEEBBUUGG, the command _a_r_g is executed before every + The command _a_r_g is to be read and executed when the shell + receives signal(s) _s_i_g_s_p_e_c. If _a_r_g is absent (and there is a + single _s_i_g_s_p_e_c) or --, each specified signal is reset to its + original disposition (the value it had upon entrance to the + shell). If _a_r_g is the null string the signal specified by each + _s_i_g_s_p_e_c is ignored by the shell and by the commands it invokes. + If _a_r_g is not present and --pp has been supplied, then the trap + commands associated with each _s_i_g_s_p_e_c are displayed. If no + arguments are supplied or if only --pp is given, ttrraapp prints the + list of commands associated with each signal. The --ll option + causes the shell to print a list of signal names and their cor- + responding numbers. Each _s_i_g_s_p_e_c is either a signal name + defined in <_s_i_g_n_a_l_._h>, or a signal number. Signal names are + case insensitive and the SIG prefix is optional. If a _s_i_g_s_p_e_c + is EEXXIITT (0) the command _a_r_g is executed on exit from the shell. + If a _s_i_g_s_p_e_c is DDEEBBUUGG, the command _a_r_g is executed before every _s_i_m_p_l_e _c_o_m_m_a_n_d, _f_o_r command, _c_a_s_e command, _s_e_l_e_c_t command, every arithmetic _f_o_r command, and before the first command executes in - a shell function (see SSHHEELLLL GGRRAAMMMMAARR above). Refer to the - description of the eexxttddeebbuugg option to the sshhoopptt builtin for - details of its effect on the DDEEBBUUGG trap. If a _s_i_g_s_p_e_c is EERRRR, - the command _a_r_g is executed whenever a simple command has a - non-zero exit status, subject to the following conditions. The - EERRRR trap is not executed if the failed command is part of the - command list immediately following a wwhhiillee or uunnttiill keyword, + a shell function (see SSHHEELLLL GGRRAAMMMMAARR above). Refer to the + description of the eexxttddeebbuugg option to the sshhoopptt builtin for + details of its effect on the DDEEBBUUGG trap. If a _s_i_g_s_p_e_c is EERRRR, + the command _a_r_g is executed whenever a simple command has a + non-zero exit status, subject to the following conditions. The + EERRRR trap is not executed if the failed command is part of the + command list immediately following a wwhhiillee or uunnttiill keyword, part of the test in an _i_f statement, part of a &&&& or |||| list, or - if the command's return value is being inverted via !!. These - are the same conditions obeyed by the eerrrreexxiitt option. If a + if the command's return value is being inverted via !!. These + are the same conditions obeyed by the eerrrreexxiitt option. If a _s_i_g_s_p_e_c is RREETTUURRNN, the command _a_r_g is executed each time a shell function or a script executed with the .. or ssoouurrccee builtins fin- ishes executing. Signals ignored upon entry to the shell cannot - be trapped or reset. Trapped signals are reset to their origi- - nal values in a child process when it is created. The return - status is false if any _s_i_g_s_p_e_c is invalid; otherwise ttrraapp + be trapped or reset. Trapped signals are reset to their origi- + nal values in a child process when it is created. The return + status is false if any _s_i_g_s_p_e_c is invalid; otherwise ttrraapp returns true. ttyyppee [--aaffttppPP] _n_a_m_e [_n_a_m_e ...] - With no options, indicate how each _n_a_m_e would be interpreted if + With no options, indicate how each _n_a_m_e would be interpreted if used as a command name. If the --tt option is used, ttyyppee prints a - string which is one of _a_l_i_a_s, _k_e_y_w_o_r_d, _f_u_n_c_t_i_o_n, _b_u_i_l_t_i_n, or - _f_i_l_e if _n_a_m_e is an alias, shell reserved word, function, - builtin, or disk file, respectively. If the _n_a_m_e is not found, - then nothing is printed, and an exit status of false is - returned. If the --pp option is used, ttyyppee either returns the + string which is one of _a_l_i_a_s, _k_e_y_w_o_r_d, _f_u_n_c_t_i_o_n, _b_u_i_l_t_i_n, or + _f_i_l_e if _n_a_m_e is an alias, shell reserved word, function, + builtin, or disk file, respectively. If the _n_a_m_e is not found, + then nothing is printed, and an exit status of false is + returned. If the --pp option is used, ttyyppee either returns the name of the disk file that would be executed if _n_a_m_e were speci- fied as a command name, or nothing if ``type -t name'' would not - return _f_i_l_e. The --PP option forces a PPAATTHH search for each _n_a_m_e, + return _f_i_l_e. The --PP option forces a PPAATTHH search for each _n_a_m_e, even if ``type -t name'' would not return _f_i_l_e. If a command is - hashed, --pp and --PP print the hashed value, not necessarily the + hashed, --pp and --PP print the hashed value, not necessarily the file that appears first in PPAATTHH. If the --aa option is used, ttyyppee - prints all of the places that contain an executable named _n_a_m_e. - This includes aliases and functions, if and only if the --pp - option is not also used. The table of hashed commands is not - consulted when using --aa. The --ff option suppresses shell func- - tion lookup, as with the ccoommmmaanndd builtin. ttyyppee returns true if + prints all of the places that contain an executable named _n_a_m_e. + This includes aliases and functions, if and only if the --pp + option is not also used. The table of hashed commands is not + consulted when using --aa. The --ff option suppresses shell func- + tion lookup, as with the ccoommmmaanndd builtin. ttyyppee returns true if any of the arguments are found, false if none are found. uulliimmiitt [--SSHHaaccddffllmmnnppssttuuvv [_l_i_m_i_t]] - Provides control over the resources available to the shell and - to processes started by it, on systems that allow such control. + Provides control over the resources available to the shell and + to processes started by it, on systems that allow such control. The --HH and --SS options specify that the hard or soft limit is set - for the given resource. A hard limit cannot be increased once - it is set; a soft limit may be increased up to the value of the - hard limit. If neither --HH nor --SS is specified, both the soft - and hard limits are set. The value of _l_i_m_i_t can be a number in + for the given resource. A hard limit cannot be increased once + it is set; a soft limit may be increased up to the value of the + hard limit. If neither --HH nor --SS is specified, both the soft + and hard limits are set. The value of _l_i_m_i_t can be a number in the unit specified for the resource or one of the special values - hhaarrdd, ssoofftt, or uunnlliimmiitteedd, which stand for the current hard - limit, the current soft limit, and no limit, respectively. If - _l_i_m_i_t is omitted, the current value of the soft limit of the - resource is printed, unless the --HH option is given. When more - than one resource is specified, the limit name and unit are + hhaarrdd, ssoofftt, or uunnlliimmiitteedd, which stand for the current hard + limit, the current soft limit, and no limit, respectively. If + _l_i_m_i_t is omitted, the current value of the soft limit of the + resource is printed, unless the --HH option is given. When more + than one resource is specified, the limit name and unit are printed before the value. Other options are interpreted as fol- lows: --aa All current limits are reported @@ -4650,63 +4651,63 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS --pp The pipe size in 512-byte blocks (this may not be set) --ss The maximum stack size --tt The maximum amount of cpu time in seconds - --uu The maximum number of processes available to a single + --uu The maximum number of processes available to a single user - --vv The maximum amount of virtual memory available to the + --vv The maximum amount of virtual memory available to the shell If _l_i_m_i_t is given, it is the new value of the specified resource (the --aa option is display only). If no option is given, then --ff - is assumed. Values are in 1024-byte increments, except for --tt, - which is in seconds, --pp, which is in units of 512-byte blocks, - and --nn and --uu, which are unscaled values. The return status is - 0 unless an invalid option or argument is supplied, or an error + is assumed. Values are in 1024-byte increments, except for --tt, + which is in seconds, --pp, which is in units of 512-byte blocks, + and --nn and --uu, which are unscaled values. The return status is + 0 unless an invalid option or argument is supplied, or an error occurs while setting a new limit. uummaasskk [--pp] [--SS] [_m_o_d_e] The user file-creation mask is set to _m_o_d_e. If _m_o_d_e begins with - a digit, it is interpreted as an octal number; otherwise it is - interpreted as a symbolic mode mask similar to that accepted by - _c_h_m_o_d(1). If _m_o_d_e is omitted, the current value of the mask is - printed. The --SS option causes the mask to be printed in sym- - bolic form; the default output is an octal number. If the --pp + a digit, it is interpreted as an octal number; otherwise it is + interpreted as a symbolic mode mask similar to that accepted by + _c_h_m_o_d(1). If _m_o_d_e is omitted, the current value of the mask is + printed. The --SS option causes the mask to be printed in sym- + bolic form; the default output is an octal number. If the --pp option is supplied, and _m_o_d_e is omitted, the output is in a form that may be reused as input. The return status is 0 if the mode - was successfully changed or if no _m_o_d_e argument was supplied, + was successfully changed or if no _m_o_d_e argument was supplied, and false otherwise. uunnaalliiaass [-aa] [_n_a_m_e ...] - Remove each _n_a_m_e from the list of defined aliases. If --aa is - supplied, all alias definitions are removed. The return value + Remove each _n_a_m_e from the list of defined aliases. If --aa is + supplied, all alias definitions are removed. The return value is true unless a supplied _n_a_m_e is not a defined alias. uunnsseett [-ffvv] [_n_a_m_e ...] - For each _n_a_m_e, remove the corresponding variable or function. + For each _n_a_m_e, remove the corresponding variable or function. If no options are supplied, or the --vv option is given, each _n_a_m_e - refers to a shell variable. Read-only variables may not be - unset. If --ff is specified, each _n_a_m_e refers to a shell func- - tion, and the function definition is removed. Each unset vari- - able or function is removed from the environment passed to sub- - sequent commands. If any of RRAANNDDOOMM, SSEECCOONNDDSS, LLIINNEENNOO, HHIISSTTCCMMDD, + refers to a shell variable. Read-only variables may not be + unset. If --ff is specified, each _n_a_m_e refers to a shell func- + tion, and the function definition is removed. Each unset vari- + able or function is removed from the environment passed to sub- + sequent commands. If any of RRAANNDDOOMM, SSEECCOONNDDSS, LLIINNEENNOO, HHIISSTTCCMMDD, FFUUNNCCNNAAMMEE, GGRROOUUPPSS, or DDIIRRSSTTAACCKK are unset, they lose their special - properties, even if they are subsequently reset. The exit sta- + properties, even if they are subsequently reset. The exit sta- tus is true unless a _n_a_m_e is readonly. wwaaiitt [_n _._._.] - Wait for each specified process and return its termination sta- - tus. Each _n may be a process ID or a job specification; if a - job spec is given, all processes in that job's pipeline are - waited for. If _n is not given, all currently active child pro- - cesses are waited for, and the return status is zero. If _n - specifies a non-existent process or job, the return status is - 127. Otherwise, the return status is the exit status of the + Wait for each specified process and return its termination sta- + tus. Each _n may be a process ID or a job specification; if a + job spec is given, all processes in that job's pipeline are + waited for. If _n is not given, all currently active child pro- + cesses are waited for, and the return status is zero. If _n + specifies a non-existent process or job, the return status is + 127. Otherwise, the return status is the exit status of the last process or job waited for. RREESSTTRRIICCTTEEDD SSHHEELLLL If bbaasshh is started with the name rrbbaasshh, or the --rr option is supplied at - invocation, the shell becomes restricted. A restricted shell is used - to set up an environment more controlled than the standard shell. It - behaves identically to bbaasshh with the exception that the following are + invocation, the shell becomes restricted. A restricted shell is used + to set up an environment more controlled than the standard shell. It + behaves identically to bbaasshh with the exception that the following are disallowed or not performed: +o changing directories with ccdd @@ -4715,28 +4716,28 @@ RREESSTTRRIICCTTEEDD SSHHEELLLL +o specifying command names containing // - +o specifying a file name containing a // as an argument to the .. + +o specifying a file name containing a // as an argument to the .. builtin command - +o Specifying a filename containing a slash as an argument to the + +o Specifying a filename containing a slash as an argument to the --pp option to the hhaasshh builtin command - +o importing function definitions from the shell environment at + +o importing function definitions from the shell environment at startup - +o parsing the value of SSHHEELLLLOOPPTTSS from the shell environment at + +o parsing the value of SSHHEELLLLOOPPTTSS from the shell environment at startup - +o redirecting output using the >, >|, <>, >&, &>, and >> redirec- + +o redirecting output using the >, >|, <>, >&, &>, and >> redirec- tion operators +o using the eexxeecc builtin command to replace the shell with another command - +o adding or deleting builtin commands with the --ff and --dd options + +o adding or deleting builtin commands with the --ff and --dd options to the eennaabbllee builtin command - +o Using the eennaabbllee builtin command to enable disabled shell + +o Using the eennaabbllee builtin command to enable disabled shell builtins +o specifying the --pp option to the ccoommmmaanndd builtin command @@ -4746,14 +4747,14 @@ RREESSTTRRIICCTTEEDD SSHHEELLLL These restrictions are enforced after any startup files are read. When a command that is found to be a shell script is executed (see CCOOMM-- - MMAANNDD EEXXEECCUUTTIIOONN above), rrbbaasshh turns off any restrictions in the shell + MMAANNDD EEXXEECCUUTTIIOONN above), rrbbaasshh turns off any restrictions in the shell spawned to execute the script. SSEEEE AALLSSOO _B_a_s_h _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, Brian Fox and Chet Ramey _T_h_e _G_n_u _R_e_a_d_l_i_n_e _L_i_b_r_a_r_y, Brian Fox and Chet Ramey _T_h_e _G_n_u _H_i_s_t_o_r_y _L_i_b_r_a_r_y, Brian Fox and Chet Ramey - _P_o_r_t_a_b_l_e _O_p_e_r_a_t_i_n_g _S_y_s_t_e_m _I_n_t_e_r_f_a_c_e _(_P_O_S_I_X_) _P_a_r_t _2_: _S_h_e_l_l _a_n_d _U_t_i_l_i_- + _P_o_r_t_a_b_l_e _O_p_e_r_a_t_i_n_g _S_y_s_t_e_m _I_n_t_e_r_f_a_c_e _(_P_O_S_I_X_) _P_a_r_t _2_: _S_h_e_l_l _a_n_d _U_t_i_l_i_- _t_i_e_s, IEEE _s_h(1), _k_s_h(1), _c_s_h(1) _e_m_a_c_s(1), _v_i(1) @@ -4769,7 +4770,7 @@ FFIILLEESS _~_/_._b_a_s_h_r_c The individual per-interactive-shell startup file _~_/_._b_a_s_h___l_o_g_o_u_t - The individual login shell cleanup file, executed when a login + The individual login shell cleanup file, executed when a login shell exits _~_/_._i_n_p_u_t_r_c Individual _r_e_a_d_l_i_n_e initialization file @@ -4783,14 +4784,14 @@ AAUUTTHHOORRSS BBUUGG RREEPPOORRTTSS If you find a bug in bbaasshh,, you should report it. But first, you should - make sure that it really is a bug, and that it appears in the latest - version of bbaasshh. The latest version is always available from + make sure that it really is a bug, and that it appears in the latest + version of bbaasshh. The latest version is always available from _f_t_p_:_/_/_f_t_p_._g_n_u_._o_r_g_/_p_u_b_/_b_a_s_h_/. - Once you have determined that a bug actually exists, use the _b_a_s_h_b_u_g - command to submit a bug report. If you have a fix, you are encouraged - to mail that as well! Suggestions and `philosophical' bug reports may - be mailed to _b_u_g_-_b_a_s_h_@_g_n_u_._o_r_g or posted to the Usenet newsgroup + Once you have determined that a bug actually exists, use the _b_a_s_h_b_u_g + command to submit a bug report. If you have a fix, you are encouraged + to mail that as well! Suggestions and `philosophical' bug reports may + be mailed to _b_u_g_-_b_a_s_h_@_g_n_u_._o_r_g or posted to the Usenet newsgroup ggnnuu..bbaasshh..bbuugg. ALL bug reports should include: @@ -4801,7 +4802,7 @@ BBUUGG RREEPPOORRTTSS A description of the bug behaviour A short script or `recipe' which exercises the bug - _b_a_s_h_b_u_g inserts the first three items automatically into the template + _b_a_s_h_b_u_g inserts the first three items automatically into the template it provides for filing a bug report. Comments and bug reports concerning this manual page should be directed @@ -4818,19 +4819,19 @@ BBUUGGSS Shell builtin commands and functions are not stoppable/restartable. Compound commands and command sequences of the form `a ; b ; c' are not - handled gracefully when process suspension is attempted. When a pro- + handled gracefully when process suspension is attempted. When a pro- cess is stopped, the shell immediately executes the next command in the sequence. It suffices to place the sequence of commands between paren- theses to force it into a subshell, which may be stopped as a unit. - Commands inside of $$((...)) command substitution are not parsed until - substitution is attempted. This will delay error reporting until some + Commands inside of $$((...)) command substitution are not parsed until + substitution is attempted. This will delay error reporting until some time after the command is entered. For example, unmatched parentheses, - even inside shell comments, will result in error messages while the + even inside shell comments, will result in error messages while the construct is being read. Array variables may not (yet) be exported. -GNU Bash-3.1-devel 2004 Nov 22 BASH(1) +GNU Bash-3.1-devel 2004 Dec 1 BASH(1) diff --git a/doc/bash.html b/doc/bash.html index a6f18045e..0be514fe3 100644 --- a/doc/bash.html +++ b/doc/bash.html @@ -2,7 +2,7 @@ BASH(1) Manual Page -
BASH(1)2004 Nov 22BASH(1) +BASH(1)2004 Dec 1BASH(1)

Index
@@ -4313,14 +4313,17 @@ with the exception that the DEBUG -trap (see the description of the +and +RETURN + +traps (see the description of the trap builtin under SHELL BUILTIN COMMANDS -below) is not inherited unless the function has been given the +below) are not inherited unless the function has been given the trace attribute (see the description of the declare @@ -4328,7 +4331,7 @@ below) is not inherited unless the function has been given the builtin below) or the -o functrace shell option has been enabled with the set builtin -(in which case all functions inherit the DEBUG trap). +(in which case all functions inherit the DEBUG and RETURN traps).

Variables local to the function may be declared with the @@ -8309,7 +8312,8 @@ by subsequent assignment statements or unset.

Give each name the trace attribute. -Traced functions inherit the DEBUG trap from the calling shell. +Traced functions inherit the DEBUG and RETURN traps from +the calling shell. The trace attribute has no special meaning for variables.
-x @@ -10005,9 +10009,11 @@ which change the current directory.
-T
-If set, any trap on DEBUG is inherited by shell functions, command -substitutions, and commands executed in a subshell environment. -The DEBUG trap is normally not inherited in such cases. +If set, any traps on DEBUG and RETURN are inherited by shell +functions, command substitutions, and commands executed in a +subshell environment. +The DEBUG and RETURN traps are normally not inherited +in such cases.
--
@@ -11409,6 +11415,6 @@ Array variables may not (yet) be exported.
This document was created by man2html from bash.1.
-Time: 24 November 2004 15:49:41 EST +Time: 07 December 2004 10:58:07 EST diff --git a/doc/bash.ps b/doc/bash.ps index 1c0be93ab..4be6cab70 100644 --- a/doc/bash.ps +++ b/doc/bash.ps @@ -1,6 +1,6 @@ %!PS-Adobe-3.0 %%Creator: groff version 1.18.1 -%%CreationDate: Wed Nov 24 15:49:23 2004 +%%CreationDate: Tue Dec 7 10:57:57 2004 %%DocumentNeededResources: font Times-Roman %%+ font Times-Bold %%+ font Times-Italic @@ -321,8 +321,8 @@ 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.385(l2).15 G(004 No) --123.385 E 2.5(v2)-.15 G 202.965(21)-2.5 G 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1) +-126.37 E(1)205.95 E 0 Cg EP %%Page: 2 2 %%BeginPageSetup BP @@ -444,8 +444,8 @@ 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.385(l2).15 G(004 No) --123.385 E 2.5(v2)-.15 G 202.965(22)-2.5 G 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1) +-126.37 E(2)205.95 E 0 Cg EP %%Page: 3 3 %%BeginPageSetup BP @@ -570,8 +570,8 @@ 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.385(l2).15 G(004 No) --123.385 E 2.5(v2)-.15 G 202.965(23)-2.5 G 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1) +-126.37 E(3)205.95 E 0 Cg EP %%Page: 4 4 %%BeginPageSetup BP @@ -691,8 +691,8 @@ 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.385(l2).15 -G(004 No)-123.385 E 2.5(v2)-.15 G 202.965(24)-2.5 G 0 Cg EP +F3([[)3.632 E F0(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2).15 G +(004 Dec 1)-126.37 E(4)205.95 E 0 Cg EP %%Page: 5 5 %%BeginPageSetup BP @@ -831,8 +831,8 @@ 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.385(l2) -.15 G(004 No)-123.385 E 2.5(v2)-.15 G 202.965(25)-2.5 G 0 Cg EP +(cuted after).15 F(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2).15 +G(004 Dec 1)-126.37 E(5)205.95 E 0 Cg EP %%Page: 6 6 %%BeginPageSetup BP @@ -967,8 +967,8 @@ E(xpansion.)-.15 E(There are three quoting mechanisms: the)108 708 Q F2 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.385(l2).15 G(004 No) --123.385 E 2.5(v2)-.15 G 202.965(26)-2.5 G 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1) +-126.37 E(6)205.95 E 0 Cg EP %%Page: 7 7 %%BeginPageSetup BP @@ -1090,8 +1090,7 @@ E F0(,)A F1(export)3.648 E F0(,)A F1 -.18(re)108 688.8 S(adonly).18 E F0 (ute has been set,)-.2 F F3(value)2.872 E F0 .372(is e)2.872 F -.25(va) -.25 G .372(luated as an arithmetic e).25 F .373 (xpression and added to the)-.15 F(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 -G 123.385(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G 202.965(27)-2.5 G 0 -Cg EP +G 126.37(l2).15 G(004 Dec 1)-126.37 E(7)205.95 E 0 Cg EP %%Page: 8 8 %%BeginPageSetup BP @@ -1216,8 +1215,7 @@ F1 -.3(BA)2.5 G(SH_ARGC).3 E F0(.)A F1 -.3(BA)108 696 S(SH_ARGV).3 E F0 -.15(xe)-.15 G 1.091(cution call stack.).15 F(The)6.091 E .275(\214nal \ parameter of the last subroutine call is at the top of the stack; the \ \214rst parameter of the initial)144 720 R(GNU Bash-3.1-de)72 768 Q -.15 -(ve)-.25 G 123.385(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G 202.965(28) --2.5 G 0 Cg EP +(ve)-.25 G 126.37(l2).15 G(004 Dec 1)-126.37 E(8)205.95 E 0 Cg EP %%Page: 9 9 %%BeginPageSetup BP @@ -1313,8 +1311,7 @@ F(in)144 661.2 Q -.2(vo)-.4 G -.1(ke).2 G 2.5(db).1 G 2.5(yt)-2.5 G -.09 E F0 .626(is unset, it loses its special properties, e)2.875 F -.15 (ve)-.25 G 3.126(ni).15 G 3.126(fi)-3.126 G 3.126(ti)-3.126 G 3.126(ss) -3.126 G(ubse-)-3.126 E(quently reset.)144 714 Q(GNU Bash-3.1-de)72 768 -Q -.15(ve)-.25 G 123.385(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G -202.965(29)-2.5 G 0 Cg EP +Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1)-126.37 E(9)205.95 E 0 Cg EP %%Page: 10 10 %%BeginPageSetup BP @@ -1406,8 +1403,8 @@ F1(getopts)4.127 E F0 -.2(bu)4.127 G 1.626(iltin command \(see).2 F F2 (xt ar)-.15 F 1.652(gument to be processed by the)-.18 F F1(getopts) 4.152 E F0 -.2(bu)4.152 G 1.652(iltin command \(see).2 F F2(SHELL)4.152 E -.09(BU)144 693.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.385(l2).15 G(004 No) --123.385 E 2.5(v2)-.15 G 197.965(21)-2.5 G(0)-197.965 E 0 Cg EP +-.25 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2).15 G +(004 Dec 1)-126.37 E(10)200.95 E 0 Cg EP %%Page: 11 11 %%BeginPageSetup BP @@ -1502,8 +1499,7 @@ Q(CS)-.55 E F0(If)144 688.8 Q F1(bash)2.535 E F0 .035(\214nds this v) F0 2.536(,i)C 2.536(ta)-2.536 G .036(ssumes that the)-2.536 F (shell is running in an emacs shell b)144 700.8 Q(uf)-.2 E (fer and disables line editing.)-.25 E(GNU Bash-3.1-de)72 768 Q -.15(ve) --.25 G 123.385(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G 197.965(21)-2.5 -G(1)-197.965 E 0 Cg EP +-.25 G 126.37(l2).15 G(004 Dec 1)-126.37 E(11)200.95 E 0 Cg EP %%Page: 12 12 %%BeginPageSetup BP @@ -1620,8 +1616,8 @@ R F1(history)3.173 E F0 -.2(bu)3.172 G 3.172(iltin. If).2 F .672(this v) 696 Q F0 2.236(attempts to read)4.736 F F5(/etc/hosts)6.401 E F0 2.235 (to obtain the list of possible hostname completions.)6.401 F(When)7.235 E F2(HOSTFILE)144 708 Q F0(is unset, the hostname list is cleared.)2.25 -E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.385(l2).15 G(004 No) --123.385 E 2.5(v2)-.15 G 197.965(21)-2.5 G(2)-197.965 E 0 Cg EP +E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1) +-126.37 E(12)200.95 E 0 Cg EP %%Page: 13 13 %%BeginPageSetup BP @@ -1723,8 +1719,8 @@ F F3 .359(SHELL B)144 612 R(UIL)-.09 E .359(TIN COMMANDS)-.828 F F0 -.1 F 26.329(administrator who installs)144 684 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 696 -Q F0(.)A(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.385(l2).15 G -(004 No)-123.385 E 2.5(v2)-.15 G 197.965(21)-2.5 G(3)-197.965 E 0 Cg EP +Q F0(.)A(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2).15 G +(004 Dec 1)-126.37 E(13)200.95 E 0 Cg EP %%Page: 14 14 %%BeginPageSetup BP @@ -1841,8 +1837,8 @@ 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.385(l2).15 G(004 No) --123.385 E 2.5(v2)-.15 G 197.965(21)-2.5 G(4)-197.965 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1) +-126.37 E(14)200.95 E 0 Cg EP %%Page: 15 15 %%BeginPageSetup BP @@ -1985,8 +1981,8 @@ 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.385(l2).15 G(004 No) --123.385 E 2.5(v2)-.15 G 197.965(21)-2.5 G(5)-197.965 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1) +-126.37 E(15)200.95 E 0 Cg EP %%Page: 16 16 %%BeginPageSetup BP @@ -2117,9 +2113,8 @@ 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.385 -(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G 197.965(21)-2.5 G(6)-197.965 E -0 Cg EP +(ord is unchanged.)-.1 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37 +(l2).15 G(004 Dec 1)-126.37 E(16)200.95 E 0 Cg EP %%Page: 17 17 %%BeginPageSetup BP @@ -2250,9 +2245,8 @@ 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.385(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G 197.965(21)-2.5 G(7) --197.965 E 0 Cg EP +(xing starts at 1.)-.15 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37 +(l2).15 G(004 Dec 1)-126.37 E(17)200.95 E 0 Cg EP %%Page: 18 18 %%BeginPageSetup BP @@ -2371,8 +2365,7 @@ 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.385(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G -197.965(21)-2.5 G(8)-197.965 E 0 Cg EP +Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1)-126.37 E(18)200.95 E 0 Cg EP %%Page: 19 19 %%BeginPageSetup BP @@ -2500,8 +2493,7 @@ 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.385(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G 197.965 -(21)-2.5 G(9)-197.965 E 0 Cg EP +-.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1)-126.37 E(19)200.95 E 0 Cg EP %%Page: 20 20 %%BeginPageSetup BP @@ -2619,9 +2611,8 @@ 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.385(l2) -.15 G(004 No)-123.385 E 2.5(v2)-.15 G 197.965(22)-2.5 G(0)-197.965 E 0 -Cg EP +.15 G(atterns)-2.5 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2) +.15 G(004 Dec 1)-126.37 E(20)200.95 E 0 Cg EP %%Page: 21 21 %%BeginPageSetup BP @@ -2712,8 +2703,7 @@ 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.385(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G 197.965(22) --2.5 G(1)-197.965 E 0 Cg EP +(ve)-.25 G 126.37(l2).15 G(004 Dec 1)-126.37 E(21)200.95 E 0 Cg EP %%Page: 22 22 %%BeginPageSetup BP @@ -2803,8 +2793,8 @@ 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.385(l2).15 G(004 No) --123.385 E 2.5(v2)-.15 G 197.965(22)-2.5 G(2)-197.965 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1) +-126.37 E(22)200.95 E 0 Cg EP %%Page: 23 23 %%BeginPageSetup BP @@ -2918,8 +2908,8 @@ 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.385(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G -197.965(22)-2.5 G(3)-197.965 E 0 Cg EP +72 768 Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1)-126.37 E(23)200.95 E +0 Cg EP %%Page: 24 24 %%BeginPageSetup BP @@ -2966,24 +2956,25 @@ R F1(#)3.032 E F0 .532(is updated to re\215ect the change.)3.032 F .533 (other aspects of the shell e)108 261.6 R -.15(xe)-.15 G 1.285 (cution en).15 F 1.285 (vironment are identical between a function and its caller with the)-.4 -F -.15(ex)108 273.6 S 1.961(ception that the).15 F F3(DEB)4.461 E(UG) --.09 E F0 1.961(trap \(see the description of the)4.211 F F1(trap)4.46 E -F0 -.2(bu)4.46 G 1.96(iltin under).2 F F3 1.96(SHELL B)4.46 F(UIL)-.09 E -1.96(TIN COM-)-.828 F(MANDS)108 285.6 Q F0(belo)2.342 E .092 -(w\) is not inherited unless the function has been gi)-.25 F -.15(ve) --.25 G 2.592(nt).15 G(he)-2.592 E F1(trace)2.592 E F0(attrib)2.592 E -.092(ute \(see the description of)-.2 F(the)108 297.6 Q F3(declar)3.116 -E(e)-.162 E F0 -.2(bu)2.866 G .616(iltin belo).2 F .616(w\) or the)-.25 -F F1 .616(\255o functrace)3.116 F F0 .616 -(shell option has been enabled with the)3.116 F F1(set)3.115 E F0 -.2 -(bu)3.115 G .615(iltin \(in which).2 F(case all functions inherit the) -108 309.6 Q F1(DEB)2.5 E(UG)-.1 E F0(trap\).)2.5 E -1.11(Va)108 326.4 S -.655(riables local to the function may be declared with the)1.11 F F1 -(local)3.155 E F0 -.2(bu)3.156 G .656(iltin command.).2 F(Ordinarily) -5.656 E 3.156(,v)-.65 G .656(ariables and)-3.406 F(their v)108 338.4 Q -(alues are shared between the function and its caller)-.25 E(.)-.55 E -.044(If the b)108 355.2 R .043(uiltin command)-.2 F F1 -.18(re)2.543 G -(tur).18 E(n)-.15 E F0 .043(is e)2.543 F -.15(xe)-.15 G .043 +F -.15(ex)108 273.6 S 2.03(ception that the).15 F F3(DEB)4.53 E(UG)-.09 +E F0(and)4.28 E F1(RETURN)4.53 E F0 2.029 +(traps \(see the description of the)4.53 F F1(trap)4.529 E F0 -.2(bu) +4.529 G 2.029(iltin under).2 F F3(SHELL)4.529 E -.09(BU)108 285.6 S(IL) +.09 E .478(TIN COMMANDS)-.828 F F0(belo)2.728 E .479 +(w\) are not inherited unless the function has been gi)-.25 F -.15(ve) +-.25 G 2.979(nt).15 G(he)-2.979 E F1(trace)2.979 E F0(attrib)2.979 E +.479(ute \(see)-.2 F .421(the description of the)108 297.6 R F3(declar) +2.92 E(e)-.162 E F0 -.2(bu)2.67 G .42(iltin belo).2 F .42(w\) or the) +-.25 F F1 .42(\255o functrace)2.92 F F0 .42 +(shell option has been enabled with the)2.92 F F1(set)2.92 E F0 -.2(bu) +108 309.6 S(iltin \(in which case all functions inherit the).2 E F1(DEB) +2.5 E(UG)-.1 E F0(and)2.5 E F1(RETURN)2.5 E F0(traps\).)2.5 E -1.11(Va) +108 326.4 S .655(riables local to the function may be declared with the) +1.11 F F1(local)3.155 E F0 -.2(bu)3.156 G .656(iltin command.).2 F +(Ordinarily)5.656 E 3.156(,v)-.65 G .656(ariables and)-3.406 F(their v) +108 338.4 Q(alues are shared between the function and its caller)-.25 E +(.)-.55 E .044(If the b)108 355.2 R .043(uiltin command)-.2 F F1 -.18 +(re)2.543 G(tur).18 E(n)-.15 E F0 .043(is e)2.543 F -.15(xe)-.15 G .043 (cuted in a function, the function completes and e).15 F -.15(xe)-.15 G .043(cution resumes with).15 F 1.011(the ne)108 367.2 R 1.011 (xt command after the function call.)-.15 F(An)6.011 E 3.511(yc)-.15 G @@ -3040,9 +3031,8 @@ 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.385 -(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G 197.965(22)-2.5 G(4)-197.965 E -0 Cg EP +(comparison)144 710.4 Q(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37 +(l2).15 G(004 Dec 1)-126.37 E(24)200.95 E 0 Cg EP %%Page: 25 25 %%BeginPageSetup BP @@ -3147,8 +3137,7 @@ 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.385(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G 197.965(22) --2.5 G(5)-197.965 E 0 Cg EP +(ve)-.25 G 126.37(l2).15 G(004 Dec 1)-126.37 E(25)200.95 E 0 Cg EP %%Page: 26 26 %%BeginPageSetup BP @@ -3249,8 +3238,7 @@ 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.385(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G 197.965(22)-2.5 -G(6)-197.965 E 0 Cg EP +-.25 G 126.37(l2).15 G(004 Dec 1)-126.37 E(26)200.95 E 0 Cg EP %%Page: 27 27 %%BeginPageSetup BP @@ -3361,9 +3349,8 @@ 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.385 -(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G 197.965(22)-2.5 G(7)-197.965 E -0 Cg EP +(the shell.)108 710.4 Q(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37 +(l2).15 G(004 Dec 1)-126.37 E(27)200.95 E 0 Cg EP %%Page: 28 28 %%BeginPageSetup BP @@ -3480,8 +3467,8 @@ 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.385(l2).15 G(004 No) --123.385 E 2.5(v2)-.15 G 197.965(22)-2.5 G(8)-197.965 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1) +-126.37 E(28)200.95 E 0 Cg EP %%Page: 29 29 %%BeginPageSetup BP @@ -3618,8 +3605,8 @@ 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.385(l2).15 G(004 No) --123.385 E 2.5(v2)-.15 G 197.965(22)-2.5 G(9)-197.965 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1) +-126.37 E(29)200.95 E 0 Cg EP %%Page: 30 30 %%BeginPageSetup BP @@ -3723,8 +3710,8 @@ 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.385(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G -197.965(23)-2.5 G(0)-197.965 E 0 Cg EP +72 768 Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1)-126.37 E(30)200.95 E +0 Cg EP %%Page: 31 31 %%BeginPageSetup BP @@ -3854,8 +3841,8 @@ 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.385(l2).15 G(004 No) --123.385 E 2.5(v2)-.15 G 197.965(23)-2.5 G(1)-197.965 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1) +-126.37 E(31)200.95 E 0 Cg EP %%Page: 32 32 %%BeginPageSetup BP @@ -3943,8 +3930,8 @@ 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.385(l2).15 G -(004 No)-123.385 E 2.5(v2)-.15 G 197.965(23)-2.5 G(2)-197.965 E 0 Cg EP +(ell.)-2.5 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2).15 G +(004 Dec 1)-126.37 E(32)200.95 E 0 Cg EP %%Page: 33 33 %%BeginPageSetup BP @@ -4042,8 +4029,8 @@ 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.385(l2).15 G -(004 No)-123.385 E 2.5(v2)-.15 G 197.965(23)-2.5 G(3)-197.965 E 0 Cg EP +(*)A F0(\).)A(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2).15 G +(004 Dec 1)-126.37 E(33)200.95 E 0 Cg EP %%Page: 34 34 %%BeginPageSetup BP @@ -4142,8 +4129,8 @@ 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.385(l2).15 G(004 No) --123.385 E 2.5(v2)-.15 G 197.965(23)-2.5 G(4)-197.965 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1) +-126.37 E(34)200.95 E 0 Cg EP %%Page: 35 35 %%BeginPageSetup BP @@ -4234,8 +4221,7 @@ 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.385(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G 197.965 -(23)-2.5 G(5)-197.965 E 0 Cg EP +-.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1)-126.37 E(35)200.95 E 0 Cg EP %%Page: 36 36 %%BeginPageSetup BP @@ -4332,8 +4318,8 @@ 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.385(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G -197.965(23)-2.5 G(6)-197.965 E 0 Cg EP +72 768 Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1)-126.37 E(36)200.95 E +0 Cg EP %%Page: 37 37 %%BeginPageSetup BP @@ -4436,8 +4422,8 @@ 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.385(l2).15 G(004 No) --123.385 E 2.5(v2)-.15 G 197.965(23)-2.5 G(7)-197.965 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1) +-126.37 E(37)200.95 E 0 Cg EP %%Page: 38 38 %%BeginPageSetup BP @@ -4521,9 +4507,8 @@ 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.385(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G 197.965(23)-2.5 G(8) --197.965 E 0 Cg EP +(Completing)87 698.4 Q F0(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37 +(l2).15 G(004 Dec 1)-126.37 E(38)200.95 E 0 Cg EP %%Page: 39 39 %%BeginPageSetup BP @@ -4615,9 +4600,8 @@ 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.385(l2) -.15 G(004 No)-123.385 E 2.5(v2)-.15 G 197.965(23)-2.5 G(9)-197.965 E 0 -Cg EP +(board macro.).15 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2) +.15 G(004 Dec 1)-126.37 E(39)200.95 E 0 Cg EP %%Page: 40 40 %%BeginPageSetup BP @@ -4716,8 +4700,7 @@ 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.385(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G 197.965(24)-2.5 G(0) --197.965 E 0 Cg EP +126.37(l2).15 G(004 Dec 1)-126.37 E(40)200.95 E 0 Cg EP %%Page: 41 41 %%BeginPageSetup BP @@ -4841,8 +4824,7 @@ 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.385(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G 197.965(24) --2.5 G(1)-197.965 E 0 Cg EP +(ve)-.25 G 126.37(l2).15 G(004 Dec 1)-126.37 E(41)200.95 E 0 Cg EP %%Page: 42 42 %%BeginPageSetup BP @@ -4987,9 +4969,8 @@ 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.385 -(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G 197.965(24)-2.5 G(2)-197.965 E -0 Cg EP +(TIN COMMANDS)-.828 F F0(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37 +(l2).15 G(004 Dec 1)-126.37 E(42)200.95 E 0 Cg EP %%Page: 43 43 %%BeginPageSetup BP @@ -5108,8 +5089,8 @@ 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.385(l2).15 G(004 No) --123.385 E 2.5(v2)-.15 G 197.965(24)-2.5 G(3)-197.965 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1) +-126.37 E(43)200.95 E 0 Cg EP %%Page: 44 44 %%BeginPageSetup BP @@ -5235,8 +5216,7 @@ 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.385(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G 197.965(24) --2.5 G(4)-197.965 E 0 Cg EP +(ve)-.25 G 126.37(l2).15 G(004 Dec 1)-126.37 E(44)200.95 E 0 Cg EP %%Page: 45 45 %%BeginPageSetup BP @@ -5350,8 +5330,8 @@ 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.385(l2).15 G(004 No) --123.385 E 2.5(v2)-.15 G 197.965(24)-2.5 G(5)-197.965 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1) +-126.37 E(45)200.95 E 0 Cg EP %%Page: 46 46 %%BeginPageSetup BP @@ -5482,8 +5462,8 @@ 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.385(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G -197.965(24)-2.5 G(6)-197.965 E 0 Cg EP +768 Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1)-126.37 E(46)200.95 E 0 +Cg EP %%Page: 47 47 %%BeginPageSetup BP @@ -5554,8 +5534,8 @@ 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.385(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G -197.965(24)-2.5 G(7)-197.965 E 0 Cg EP +768 Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1)-126.37 E(47)200.95 E 0 +Cg EP %%Page: 48 48 %%BeginPageSetup BP @@ -5655,15 +5635,16 @@ n is de\214ned are displayed as well.)144 542.4 R(The)6.308 E F1 25.86 E(e)-.1 E F2(name)5.046 E F0 5.046(sr)C(eadonly)-5.046 E 7.546(.T) -.65 G 2.546(hese names cannot then be assigned v)-7.546 F 2.547 (alues by subsequent)-.25 F(assignment statements or unset.)180 638.4 Q -F1144 650.4 Q F0(Gi)26.97 E 1.231 -.15(ve e)-.25 H(ach).15 E F2 -(name)3.431 E F0(the)3.431 E F2(tr)3.431 E(ace)-.15 E F0(attrib)3.431 E -3.431(ute. T)-.2 F .931(raced functions inherit the)-.35 F F1(DEB)3.431 -E(UG)-.1 E F0 .93(trap from the)3.43 F(calling shell.)180 662.4 Q -(The trace attrib)5 E(ute has no special meaning for v)-.2 E(ariables.) --.25 E F1144 674.4 Q F0(Mark)25.3 E F2(name)2.5 E F0 2.5(sf)C -(or e)-2.5 E(xport to subsequent commands via the en)-.15 E(vironment.) --.4 E .336(Using `+' instead of `\255' turns of)144 691.2 R 2.837(ft) --.25 G .337(he attrib)-2.837 F .337(ute instead, with the e)-.2 F .337 +F1144 650.4 Q F0(Gi)26.97 E .73 -.15(ve e)-.25 H(ach).15 E F2 +(name)2.93 E F0(the)2.929 E F2(tr)2.929 E(ace)-.15 E F0(attrib)2.929 E +2.929(ute. T)-.2 F .429(raced functions inherit the)-.35 F F1(DEB)2.929 +E(UG)-.1 E F0(and)2.929 E F1(RETURN)2.929 E F0 +(traps from the calling shell.)180 662.4 Q(The trace attrib)5 E +(ute has no special meaning for v)-.2 E(ariables.)-.25 E F1144 +674.4 Q F0(Mark)25.3 E F2(name)2.5 E F0 2.5(sf)C(or e)-2.5 E +(xport to subsequent commands via the en)-.15 E(vironment.)-.4 E .336 +(Using `+' instead of `\255' turns of)144 691.2 R 2.837(ft)-.25 G .337 +(he attrib)-2.837 F .337(ute instead, with the e)-.2 F .337 (xception that)-.15 F F1(+a)2.837 E F0 .337(may not be used)2.837 F .793 (to destro)144 703.2 R 3.293(ya)-.1 G 3.293(na)-3.293 G .793(rray v) -3.293 F 3.293(ariable. When)-.25 F .793(used in a function, mak)3.293 F @@ -5675,8 +5656,8 @@ E(UG)-.1 E F0 .93(trap from the)3.43 F(calling shell.)180 662.4 Q .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.385(l2).15 G(004 No) --123.385 E 2.5(v2)-.15 G 197.965(24)-2.5 G(8)-197.965 E 0 Cg EP +.25 F(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1) +-126.37 E(48)200.95 E 0 Cg EP %%Page: 49 49 %%BeginPageSetup BP @@ -5787,9 +5768,8 @@ 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.385 -(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G 197.965(24)-2.5 G(9)-197.965 E -0 Cg EP +(nt).15 G(hough)-3.333 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37 +(l2).15 G(004 Dec 1)-126.37 E(49)200.95 E 0 Cg EP %%Page: 50 50 %%BeginPageSetup BP @@ -5932,8 +5912,7 @@ 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.385(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G 197.965(25)-2.5 G(0) --197.965 E 0 Cg EP +126.37(l2).15 G(004 Dec 1)-126.37 E(50)200.95 E 0 Cg EP %%Page: 51 51 %%BeginPageSetup BP @@ -6061,8 +6040,8 @@ 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.385(l2).15 G(004 No) --123.385 E 2.5(v2)-.15 G 197.965(25)-2.5 G(1)-197.965 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1) +-126.37 E(51)200.95 E 0 Cg EP %%Page: 52 52 %%BeginPageSetup BP @@ -6172,9 +6151,8 @@ 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.385 -(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G 197.965(25)-2.5 G(2)-197.965 E -0 Cg EP +2.066(with the)4.836 F(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37 +(l2).15 G(004 Dec 1)-126.37 E(52)200.95 E 0 Cg EP %%Page: 53 53 %%BeginPageSetup BP @@ -6301,8 +6279,8 @@ 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.385(l2).15 G(004 No) --123.385 E 2.5(v2)-.15 G 197.965(25)-2.5 G(3)-197.965 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1) +-126.37 E(53)200.95 E 0 Cg EP %%Page: 54 54 %%BeginPageSetup BP @@ -6419,9 +6397,8 @@ 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.385(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G 197.965(25)-2.5 G(4) --197.965 E 0 Cg EP +.336(eturn code)-.18 F F0(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37 +(l2).15 G(004 Dec 1)-126.37 E(54)200.95 E 0 Cg EP %%Page: 55 55 %%BeginPageSetup BP @@ -6535,8 +6512,8 @@ 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.385(l2).15 G(004 No) --123.385 E 2.5(v2)-.15 G 197.965(25)-2.5 G(5)-197.965 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1) +-126.37 E(55)200.95 E 0 Cg EP %%Page: 56 56 %%BeginPageSetup BP @@ -6610,8 +6587,8 @@ 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.385(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G -197.965(25)-2.5 G(6)-197.965 E 0 Cg EP +72 768 Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1)-126.37 E(56)200.95 E +0 Cg EP %%Page: 57 57 %%BeginPageSetup BP @@ -6660,13 +6637,13 @@ E F1 1.069(that change the curr)3.569 F 1.069(ent working dir)-.18 F 2.912(ei)-.18 G 2.912(nstead. By)-2.912 F(default,)2.912 E F2(bash)2.912 E F1 .412(follows the logical chain of dir)2.912 F .411(ectories when) -.18 F(performing commands which change the curr)184 348 Q(ent dir)-.18 -E(ectory)-.18 E(.)-1.11 E F2144 360 Q F1 1.25(If set, any trap on) -27.27 F F2(DEBUG)3.751 E F1 1.251 -(is inherited by shell functions, command substitu-)3.751 F .712 -(tions, and commands executed in a subshell envir)184 372 R 3.212 -(onment. The)-.18 F F2(DEBUG)3.212 E F1 .711(trap is)3.211 F -(normally not inherited in such cases.)184 384 Q F2144 396 Q F1 -1.781(If no ar)27.88 F 1.782 +E(ectory)-.18 E(.)-1.11 E F2144 360 Q F1 .22(If set, any traps on) +27.27 F F2(DEBUG)2.72 E F1(and)2.72 E F2(RETURN)2.72 E F1(ar)2.72 E 2.72 +(ei)-.18 G .22(nherited by shell functions, com-)-2.72 F 1.573 +(mand substitutions, and commands executed in a subshell envir)184 372 R +4.073(onment. The)-.18 F F2(DEBUG)184 384 Q F1(and)2.5 E F2(RETURN)2.5 E +F1(traps ar)2.5 E 2.5(en)-.18 G(ormally not inherited in such cases.) +-2.5 E F2144 396 Q F1 1.781(If no ar)27.88 F 1.782 (guments follow this option, then the positional parameters ar)-.18 F 4.282(eu)-.18 G(nset.)-4.282 E 1.303 (Otherwise, the positional parameters ar)184 408 R 3.803(es)-.18 G 1.303 @@ -6727,8 +6704,7 @@ 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.385(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G 197.965(25)-2.5 -G(7)-197.965 E 0 Cg EP +-.25 G 126.37(l2).15 G(004 Dec 1)-126.37 E(57)200.95 E 0 Cg EP %%Page: 58 58 %%BeginPageSetup BP @@ -6816,8 +6792,7 @@ 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.385(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G 197.965(25) --2.5 G(8)-197.965 E 0 Cg EP +(ve)-.25 G 126.37(l2).15 G(004 Dec 1)-126.37 E(58)200.95 E 0 Cg EP %%Page: 59 59 %%BeginPageSetup BP @@ -6896,8 +6871,8 @@ 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.385(l2).15 G(004 No) --123.385 E 2.5(v2)-.15 G 197.965(25)-2.5 G(9)-197.965 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1) +-126.37 E(59)200.95 E 0 Cg EP %%Page: 60 60 %%BeginPageSetup BP @@ -6989,8 +6964,7 @@ 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.385(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G 197.965(26)-2.5 G(0) --197.965 E 0 Cg EP +G 126.37(l2).15 G(004 Dec 1)-126.37 E(60)200.95 E 0 Cg EP %%Page: 61 61 %%BeginPageSetup BP @@ -7128,8 +7102,8 @@ 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.385(l2).15 G(004 No) --123.385 E 2.5(v2)-.15 G 197.965(26)-2.5 G(1)-197.965 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1) +-126.37 E(61)200.95 E 0 Cg EP %%Page: 62 62 %%BeginPageSetup BP @@ -7250,8 +7224,7 @@ 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.385(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G 197.965(26)-2.5 G(2) --197.965 E 0 Cg EP +126.37(l2).15 G(004 Dec 1)-126.37 E(62)200.95 E 0 Cg EP %%Page: 63 63 %%BeginPageSetup BP @@ -7330,8 +7303,7 @@ 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.385(l2).15 G(004 No)-123.385 E 2.5(v2)-.15 G 197.965(26)-2.5 G(3) --197.965 E 0 Cg EP +126.37(l2).15 G(004 Dec 1)-126.37 E(63)200.95 E 0 Cg EP %%Page: 64 64 %%BeginPageSetup BP @@ -7395,8 +7367,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.385(l2).15 G(004 No) --123.385 E 2.5(v2)-.15 G 197.965(26)-2.5 G(4)-197.965 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 126.37(l2).15 G(004 Dec 1) +-126.37 E(64)200.95 E 0 Cg EP %%Trailer end %%EOF diff --git a/doc/bashref.dvi b/doc/bashref.dvi index 32f7ff1b5eac306c23c9d60b6cdd49afa61142b0..819a2e3fbb263c233a273ad6ce2e78883c9c5928 100644 GIT binary patch delta 2738 zc-n1NZBSEZ7UsP7BO%F60gyaIzBp?Z>YgOFo zs#^;Z@5qg!Wo;E_MchJa58739yMAk>JKFk%*a|x8j8&?3N4KzVa%o9tnqT)m&vVXu za?W|5r2EUbqnG1qWA&+~FD(keD29Y`4uNWm|1-Td7k@Go>V2#ma51v7$Y}!@WoBW|v#4D65@y!)kVmRw)oD zI=qDx5zD32^gi?bx9_@~%nna=gD6qO)dawI@6*r`T3W+blZknE$*KNI=CFQIa1_g51Objp#HN+C^&} zyQ^xM&0V4#KFvlONXuy~N@TMf7Muoru(fib|@0P)EV=o8=q_V0x@0eXHE$K!WxaNhv$ zW7jFTqJ!fB0y{3j0WCD(y078$P_PfGYwts-7AE4hryyyeYLKuIQYb(Ko->f62H99c zA_JwIj3EtraAC2DoY286zkUK1Pb4dJRQq)f`B(=h74SkndDQ@KqtQyt26(D~O)iqA zh56XEnxq)uI8tzu4!+0P+sIiBr29qVF?Tn)qFuxM?))#UK~Z_BBQQaW*>1NvizQcy zXt$d@?6JA|6jjD=cDu`Mg%xhGrm=c+$X|SkC1zJ0(^%vzm0bSYC0cA|yW|kfPJagf z>?%F|)@kN)n}1VWCOSKLdkd*2yF+k7D_O3AM5VNQ|0FR2G@|AVc_cue0;XRk)3xvr zSKcCj&_SsJ>K~F#8aRXRKO?VcV6y^7a?EEMxQN#c%xN8TDBz73m@Xc+;gL9Iqt@T) z3HawEMg>e{>mqzFnaLzfc<*UEk;=?~H59A%y!lO5V!p>Tr=j!pqB=Gui|#UA;k*ZC zC$*9l{vMP`)Lwq^GSO=!*_)_|1#bjV zUz9Tc*25vJTg@a2a6rj*Z6i~ygIj3xGSl_2L6IA-Fe9|q13WC!V^TvnJBYKfNyZ|PBx!|zsfEDV>9qcBRe$$Zs7P&*;F0OQ^1`k*(L$r#aWlwcMQ~* z0-(BwJ*S07c&V)~AS$PZ>(G%J6Gqi@so|u4e1JpB zSp=|S_aQDzLq27KBIY0GW`vUCQ}Bb&x%=FYLvPgZ3HZfD?vfswanCL8fB+|gn7=*Z zGW673zv|~uqnPV3q|BEp*e|aN=dG|^QAa27BXQ^uejZ&8z|vS=7NACvQ|hFaB#pv5 zS-eR{Ch`hw%Heyp#+;1cwMJQ6$%bMN8CsW)gcO8rswaDWvTfF1@S1 M3#xl>k}mrBKc{T}lK=n! delta 2448 zc-mc+dsGzn70125-^}c?JF|;mO@a?3Sdj#9A4Fw+B-*Z+)LIctqQ{84>>yj0MPNbW z=?Ui4Xpg$eW>N+pk$Q{~O?|*(uHpmRG*RoT=_x7dQB+V*ptZizqBR!2LOz>6o_~F?Ewld<1&ON$Vf``$+o&J>sd!jiP z+G8LsYQOfK1fr&U?uO0eE{Wdic_6|`brK;i93euX1jjJ^0(>b!kq*Nt@Ov|4s4ge0 zpm8G#@e3z38dLb5P?0C3goKe4n6x-m@t3Qc$HT}M zYh^j8Ebvz{%KosJwOhiGxc=FfSV)0f!ODluUqtTMol^cLIQ&};=6H_QUg0&{eDt^f{8kdJC9yeh$4I_zHs*Davp4`HBI z*xw7s;h2x%yktETuDjE(Usx;rqQjxueZ+<{K7*wa{8je}2cX+(S^bnxg{j1jwiB>X zght(F_y!_oScB`Yz?m4Bt;4O|5Mzdsxa;4bn4uUM{8$3Ob}Kn*g*v^u^NFO+0`qZc z2Kh<^7fu>S8bxNhmra^PXj0ia3$Nyp*Q^%*lT|p?$U)AI9v?}zLWgcUQcj#^tNSV2 z*xsg`=&T~QEWOqC`rcVfs0f|t*+5R3AV~$DW?|tr(q^7ZnojF8QCL<|tQ~%VClK%l z7bxXLav+cq;li`>7}bVA@q|KUes4ucR*F33O0YyJ?|pdW0>3A)_S5i({XU4M7t5X? z3$LM{7OM3PWH0&TpE#$HEHQzo?<*cALnZhCU;Z<>Ex|<{zS&0HW;lzRI>;Omrt8pl zi>x)l4s5wkCYhiV8GK-ZC_c2(6C&*C?QJYR8cf>-co*A~>1s1XbhvdCH2_UWZN*(S zI)>2r-OKTYgH8npW8uipuDa6mA{jY#7hf-|q0Q6S*rr8ji`x@q?}m33?L62t>d%aN zWfUDQGPR(jxY!e9bFU7t(R^MPD{a(?xvx->YMXe+(j0&x*px*-<6s7<#@%{&y@g5;%`_+_6t^jsx?T`3~OTa^w+`?Fh!;vew>ufBv<72`)32N~3 zEnFTC6EySQUHo92xSewkfDdu`LCzt9xliai#_g71BCc=cmRn(1pOABnJ8On*m~@-F zV21iW!S;|FX@=!E+sM~R#BlllipmrY?F0E(ljZ#Q}|^( zo1N+D{8E9WwLT+5Ccni9Ik6a4$^UmVj z0Dr(l7IySWzgWzhOt2Z}yw5)p$+9bbin5mfi%7y(QQpWq;>d=7Xot$ADhY<6?I7~)#LW_m$zkr>`g<)~zSeuR~Ul4q; zI16G)racq1ah!$RA1;HLLDwM%QKG&T7NTY_e`MI@=88KOuil!TLeQ>!V4+Caj)m mjJ`l}mZLjh+&+yg%)*=djq~jUui}g@ - +