diff --git a/CWRU/CWRU.chlog b/CWRU/CWRU.chlog index a17de847..c1f8dc96 100644 --- a/CWRU/CWRU.chlog +++ b/CWRU/CWRU.chlog @@ -4613,3 +4613,44 @@ lib/glob/sm_loop.c lib/glob/{glob,gmisc}.c - PATSCAN: change all callers to add extra flags arg of 0 + +doc/{bash.1,bashref.texi} + - trap description: replace ARG with ACTION + - clarify the language describing what trap without arguments and + trap -p without arguments display + - clarify that trap in non-interactive shells does not allow signals + that were ignored at shell start to be trapped; interactive shells + allow this + - trap: add missing command types to the description of when the + DEBUG trap is executed + +builtins/trap.def + - LONG_DOC: replace ARG with ACTION + - make it clear that trap and trap -p without arguments display a + information about specified signals, but in a form that may be + reused as shell input + + 12/5 + ---- +pcomplete.c + - compgen_compspec: new flag saying whether or not we're running via + the compgen builtin or via programmable completion: set to 0 + every time gen_progcomp_completions runs, set to 1 in + gen_compspec_completions if this_shell_builtin == compgen_builtin + - gen_shell_function_completions: call rl_clear_signals and + rl_set_signals so the shell's signal handlers are active when + running shell functions to generate completions. We try to do it + only when programmable completion, not the compgen builtin, is active. + Idea from Koichi Murase , fixes bug + reported in 9/22 + +sig.c + - sigint_sighandler, termsig_sighandler: since these can now be called + during programmable completion, we need to set the readline signal + event hook if the readline state includes RL_STATE_DISPATCHING or + RL_STATE_COMPLETING, since we can't rely on RL_STATE_SIGHANDLER + being set and we want to call throw_to_top_level here + - throw_to_top_level: if the shell is interactive, before calling + bashline_reset (which zeroes rl_signal_event_hook), call + rl_cleanup_after_signal if we think readline hasn't called it + already diff --git a/POSIX b/POSIX index 4e78dbb7..148347c6 100644 --- a/POSIX +++ b/POSIX @@ -169,8 +169,9 @@ The following list is what's changed when 'POSIX mode' is in effect: handler for a given signal to the original disposition, they should use '-' as the first argument. - 42. 'trap -p' displays signals whose dispositions are set to SIG_DFL - and those that were ignored when the shell started. + 42. 'trap -p' without arguments displays signals whose dispositions + are set to SIG_DFL and those that were ignored when the shell + started, not just trapped signals. 43. The '.' and 'source' builtins do not search the current directory for the filename argument if it is not found by searching 'PATH'. diff --git a/builtins/trap.def b/builtins/trap.def index 94229433..38d407cb 100644 --- a/builtins/trap.def +++ b/builtins/trap.def @@ -22,31 +22,35 @@ $PRODUCES trap.c $BUILTIN trap $FUNCTION trap_builtin -$SHORT_DOC trap [-lp] [[arg] signal_spec ...] +$SHORT_DOC trap [-lp] [[action] signal_spec ...] Trap signals and other events. Defines and activates handlers to be run when the shell receives signals or other conditions. -ARG is a command to be read and executed when the shell receives the -signal(s) SIGNAL_SPEC. If ARG is absent (and a single SIGNAL_SPEC +ACTION is a command to be read and executed when the shell receives the +signal(s) SIGNAL_SPEC. If ACTION is absent (and a single SIGNAL_SPEC is supplied) or `-', each specified signal is reset to its original -value. If ARG is the null string each SIGNAL_SPEC is ignored by the +value. If ACTION is the null string each SIGNAL_SPEC is ignored by the shell and by the commands it invokes. -If a SIGNAL_SPEC is EXIT (0) ARG is executed on exit from the shell. If -a SIGNAL_SPEC is DEBUG, ARG is executed before every simple command. If -a SIGNAL_SPEC is RETURN, ARG is executed each time a shell function or a -script run by the . or source builtins finishes executing. A SIGNAL_SPEC -of ERR means to execute ARG each time a command's failure would cause the -shell to exit when the -e option is enabled. +If a SIGNAL_SPEC is EXIT (0) ACTION is executed on exit from the shell. +If a SIGNAL_SPEC is DEBUG, ACTION is executed before every simple command +and selected other commands. If a SIGNAL_SPEC is RETURN, ACTION is +executed each time a shell function or a script run by the . or source +builtins finishes executing. A SIGNAL_SPEC of ERR means to execute ACTION +each time a command's failure would cause the shell to exit when the -e +option is enabled. If no arguments are supplied, trap prints the list of commands associated -with each signal. +with each trapped signal in a form that may be reused as shell input to +restore the same signal dispositions. Options: -l print a list of signal names and their corresponding numbers - -p display the trap commands associated with each SIGNAL_SPEC + -p display the trap commands associated with each SIGNAL_SPEC in a + form that may be reused as shell input; or for all trapped + signals if no arguments are supplied Each SIGNAL_SPEC is either a signal name in or a signal number. Signal names are case insensitive and the SIG prefix is optional. A diff --git a/doc/bash.0 b/doc/bash.0 index 1580b77a..9ab95c78 100644 --- a/doc/bash.0 +++ b/doc/bash.0 @@ -683,7 +683,7 @@ QQUUOOTTIINNGG fault, whether or not it is translated and replaced. If the nnooeexx-- ppaanndd__ttrraannssllaattiioonn option is enabled using the sshhoopptt builtin, translated strings are single-quoted instead of double-quoted. See the descrip- - tion of sshhoopptt below under SSHHEELLLLBUILTINCCOOMMMMAANNDDSS. + tion of sshhoopptt below under SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS. PPAARRAAMMEETTEERRSS A _p_a_r_a_m_e_t_e_r is an entity that stores values. It can be a _n_a_m_e, a num- @@ -2154,7 +2154,7 @@ EEXXPPAANNSSIIOONN !!((_p_a_t_t_e_r_n_-_l_i_s_t)) Matches anything except one of the given patterns - Theeexxttgglloobb option changes the behavior of the parser, since the paren- + The eexxttgglloobb option changes the behavior of the parser, since the paren- theses are normally treated as operators with syntactic meaning. To ensure that extended matching patterns are parsed correctly, make sure that eexxttgglloobb is enabled before parsing constructs containing the pat- @@ -6204,34 +6204,42 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS 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 re- - ceives signal(s) _s_i_g_s_p_e_c. If _a_r_g is absent (and there is a sin- - gle _s_i_g_s_p_e_c) or --, each specified signal is reset to its origi- - nal 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 com- - mands associated with each signal. The --ll option causes the - shell to print a list of signal names and their corresponding - 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 SSIIGG prefix is optional. + ttrraapp [--llpp] [[_a_c_t_i_o_n] _s_i_g_s_p_e_c ...] + The _a_c_t_i_o_n is a command that is read and executed when the shell + receives signal(s) _s_i_g_s_p_e_c. If _a_c_t_i_o_n 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_c_t_i_o_n 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 in- + vokes. - 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 exe- - cuted 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 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. + If no arguments are supplied, ttrraapp displays the actions associ- + ated with each trapped signal as a set of ttrraapp commands that can + be reused as shell input to restore the current signal disposi- + tions. If --pp is given, and _a_c_t_i_o_n is not present, then ttrraapp + displays the actions associated with each _s_i_g_s_p_e_c or, if none + are supplied, for all trapped signals, as a set of ttrraapp commands + that can be reused as shell input to restore the current signal + dispositions. - If a _s_i_g_s_p_e_c is EERRRR, the command _a_r_g is executed whenever a + The --ll option causes ttrraapp to print a list of signal names and + their corresponding 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 SSIIGG prefix is optional. + + If a _s_i_g_s_p_e_c is EEXXIITT (0) the command _a_c_t_i_o_n is executed on exit + from the shell. If a _s_i_g_s_p_e_c is DDEEBBUUGG, the command _a_c_t_i_o_n 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, (( arithmetic command, [[ conditional command, + arithmetic _f_o_r command, and before the first command executes in + a shell function (see SSHHEELLLL GGRRAAMMMMAARR above). Refer to the de- + scription of the eexxttddeebbuugg option to the sshhoopptt builtin for de- + tails of its effect on the DDEEBBUUGG trap. If a _s_i_g_s_p_e_c is RREETTUURRNN, + the command _a_c_t_i_o_n is executed each time a shell function or a + script executed with the .. or ssoouurrccee builtins finishes execut- + ing. + + If a _s_i_g_s_p_e_c is EERRRR, the command _a_c_t_i_o_n is executed whenever a pipeline (which may consist of a single simple command), a list, or a compound command returns a non-zero exit status, subject to the following conditions. The EERRRR trap is not executed if the @@ -6243,61 +6251,62 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS !!. These are the same conditions obeyed by the eerrrreexxiitt (--ee) op- tion. - Signals ignored upon entry to the shell cannot be trapped or re- - set. Trapped signals that are not being ignored are reset to - their original values in a subshell or subshell environment when - one is created. The return status is false if any _s_i_g_s_p_e_c is - invalid; otherwise ttrraapp returns true. + When the shell is not interactive, signals ignored upon entry to + the shell cannot be trapped or reset. Interactive shells permit + trapping signals ignored on entry. Trapped signals that are not + being ignored are reset to their original values in a subshell + or subshell environment when one 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 re- - turned. 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 specified - as a command name, or nothing if ``type -t name'' would not re- - turn _f_i_l_e. The --PP option forces a PPAATTHH search for each _n_a_m_e, + 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 re- + turned. 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 specified + as a command name, or nothing if ``type -t name'' would not re- + turn _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, which is not necessar- - ily the file that appears first in PPAATTHH. If the --aa option is - used, ttyyppee prints all of the places that contain an executable + ily 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 + not consulted when using --aa. The --ff option suppresses shell function lookup, as with the ccoommmmaanndd builtin. ttyyppee returns true if all of the arguments are found, false if any are not found. uulliimmiitt [--HHSS] --aa uulliimmiitt [--HHSS] [--bbccddeeffiikkllmmnnppqqrrssttuuvvxxPPRRTT [_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 by a - non-root user once it is set; a soft limit may be increased up - to the value of the hard limit. If neither --HH nor --SS is speci- + for the given resource. A hard limit cannot be increased by a + non-root user once it is set; a soft limit may be increased up + to the value of the hard limit. If neither --HH nor --SS is speci- fied, 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, re- - spectively. If _l_i_m_i_t is omitted, the current value of the soft + current hard limit, the current soft limit, and no limit, re- + spectively. 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, if appropriate, are printed before the value. Other op- + When more than one resource is specified, the limit name and + unit, if appropriate, are printed before the value. Other op- tions are interpreted as follows: --aa All current limits are reported; no limits are set --bb The maximum socket buffer size --cc The maximum size of core files created --dd The maximum size of a process's data segment --ee The maximum scheduling priority ("nice") - --ff The maximum size of files written by the shell and its + --ff The maximum size of files written by the shell and its children --ii The maximum number of pending signals --kk The maximum number of kqueues that may be allocated --ll The maximum size that may be locked into memory - --mm The maximum resident set size (many systems do not honor + --mm The maximum resident set size (many systems do not honor this limit) --nn The maximum number of open file descriptors (most systems do not allow this value to be set) @@ -6306,134 +6315,134 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS --rr The maximum real-time scheduling priority --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 and, on some systems, to its children --xx The maximum number of file locks --PP The maximum number of pseudoterminals - --RR The maximum time a real-time process can run before + --RR The maximum time a real-time process can run before blocking, in microseconds --TT The maximum number of threads - If _l_i_m_i_t is given, and the --aa option is not used, _l_i_m_i_t is the - new value of the specified resource. If no option is given, - then --ff is assumed. Values are in 1024-byte increments, except - for --tt, which is in seconds; --RR, which is in microseconds; --pp, - which is in units of 512-byte blocks; --PP, --TT, --bb, --kk, --nn, and - --uu, which are unscaled values; and, when in posix mode, --cc and - --ff, which are in 512-byte increments. The return status is 0 - unless an invalid option or argument is supplied, or an error + If _l_i_m_i_t is given, and the --aa option is not used, _l_i_m_i_t is the + new value of the specified resource. If no option is given, + then --ff is assumed. Values are in 1024-byte increments, except + for --tt, which is in seconds; --RR, which is in microseconds; --pp, + which is in units of 512-byte blocks; --PP, --TT, --bb, --kk, --nn, and + --uu, which are unscaled values; and, when in posix mode, --cc and + --ff, which are in 512-byte increments. 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] [-nn] [_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 the --vv option is given, each _n_a_m_e refers to a shell variable, - and that variable is removed. 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. If the --nn option - is supplied, and _n_a_m_e is a variable with the _n_a_m_e_r_e_f attribute, - _n_a_m_e will be unset rather than the variable it references. --nn - has no effect if the --ff option is supplied. If no options are - supplied, each _n_a_m_e refers to a variable; if there is no vari- - able by that name, a function with that name, if any, is unset. - Each unset variable or function is removed from the environment - passed to subsequent commands. If any of BBAASSHH__AALLIIAASSEESS, + and that variable is removed. 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. If the --nn option + is supplied, and _n_a_m_e is a variable with the _n_a_m_e_r_e_f attribute, + _n_a_m_e will be unset rather than the variable it references. --nn + has no effect if the --ff option is supplied. If no options are + supplied, each _n_a_m_e refers to a variable; if there is no vari- + able by that name, a function with that name, if any, is unset. + Each unset variable or function is removed from the environment + passed to subsequent commands. If any of BBAASSHH__AALLIIAASSEESS, BBAASSHH__AARRGGVV00, BBAASSHH__CCMMDDSS, BBAASSHH__CCOOMMMMAANNDD, BBAASSHH__SSUUBBSSHHEELLLL, BBAASSHHPPIIDD, - CCOOMMPP__WWOORRDDBBRREEAAKKSS, DDIIRRSSTTAACCKK, EEPPOOCCHHRREEAALLTTIIMMEE, EEPPOOCCHHSSEECCOONNDDSS, FFUUNNCC-- - NNAAMMEE, GGRROOUUPPSS, HHIISSTTCCMMDD, LLIINNEENNOO, RRAANNDDOOMM, SSEECCOONNDDSS, or SSRRAANNDDOOMM are + CCOOMMPP__WWOORRDDBBRREEAAKKSS, DDIIRRSSTTAACCKK, EEPPOOCCHHRREEAALLTTIIMMEE, EEPPOOCCHHSSEECCOONNDDSS, FFUUNNCC-- + NNAAMMEE, GGRROOUUPPSS, HHIISSTTCCMMDD, LLIINNEENNOO, RRAANNDDOOMM, SSEECCOONNDDSS, or SSRRAANNDDOOMM are unset, they lose their special properties, even if they are sub- sequently reset. The exit status is true unless a _n_a_m_e is read- only or may not be unset. wwaaiitt [--ffnn] [--pp _v_a_r_n_a_m_e] [_i_d _._._.] Wait for each specified child process and return its termination - status. Each _i_d 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 _i_d is not given, wwaaiitt waits for all running - background jobs and the last-executed process substitution, if + status. Each _i_d 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 _i_d is not given, wwaaiitt waits for all running + background jobs and the last-executed process substitution, if its process id is the same as $$!!, and the return status is zero. - If the --nn option is supplied, wwaaiitt waits for a single job from + If the --nn option is supplied, wwaaiitt waits for a single job from the list of _i_ds or, if no _i_ds are supplied, any job, to complete - and returns its exit status. If none of the supplied arguments + and returns its exit status. If none of the supplied arguments is a child of the shell, or if no arguments are supplied and the - shell has no unwaited-for children, the exit status is 127. If - the --pp option is supplied, the process or job identifier of the - job for which the exit status is returned is assigned to the - variable _v_a_r_n_a_m_e named by the option argument. The variable - will be unset initially, before any assignment. This is useful - only when the --nn option is supplied. Supplying the --ff option, - when job control is enabled, forces wwaaiitt to wait for _i_d to ter- + shell has no unwaited-for children, the exit status is 127. If + the --pp option is supplied, the process or job identifier of the + job for which the exit status is returned is assigned to the + variable _v_a_r_n_a_m_e named by the option argument. The variable + will be unset initially, before any assignment. This is useful + only when the --nn option is supplied. Supplying the --ff option, + when job control is enabled, forces wwaaiitt to wait for _i_d to ter- minate before returning its status, instead of returning when it - changes status. If _i_d specifies a non-existent process or job, - the return status is 127. If wwaaiitt is interrupted by a signal, - the return status will be greater than 128, as described under - SSIIGGNNAALLSS above. Otherwise, the return status is the exit status + changes status. If _i_d specifies a non-existent process or job, + the return status is 127. If wwaaiitt is interrupted by a signal, + the return status will be greater than 128, as described under + SSIIGGNNAALLSS above. Otherwise, the return status is the exit status of the last process or job waited for. SSHHEELLLL CCOOMMPPAATTIIBBIILLIITTYY MMOODDEE - Bash-4.0 introduced the concept of a _s_h_e_l_l _c_o_m_p_a_t_i_b_i_l_i_t_y _l_e_v_e_l, speci- - fied as a set of options to the shopt builtin ( ccoommppaatt3311, ccoommppaatt3322, - ccoommppaatt4400, ccoommppaatt4411, and so on). There is only one current compatibil- - ity level -- each option is mutually exclusive. The compatibility - level is intended to allow users to select behavior from previous ver- - sions that is incompatible with newer versions while they migrate - scripts to use current features and behavior. It's intended to be a + Bash-4.0 introduced the concept of a _s_h_e_l_l _c_o_m_p_a_t_i_b_i_l_i_t_y _l_e_v_e_l, speci- + fied as a set of options to the shopt builtin ( ccoommppaatt3311, ccoommppaatt3322, + ccoommppaatt4400, ccoommppaatt4411, and so on). There is only one current compatibil- + ity level -- each option is mutually exclusive. The compatibility + level is intended to allow users to select behavior from previous ver- + sions that is incompatible with newer versions while they migrate + scripts to use current features and behavior. It's intended to be a temporary solution. - This section does not mention behavior that is standard for a particu- - lar version (e.g., setting ccoommppaatt3322 means that quoting the rhs of the - regexp matching operator quotes special regexp characters in the word, + This section does not mention behavior that is standard for a particu- + lar version (e.g., setting ccoommppaatt3322 means that quoting the rhs of the + regexp matching operator quotes special regexp characters in the word, which is default behavior in bash-3.2 and subsequent versions). - If a user enables, say, ccoommppaatt3322, it may affect the behavior of other - compatibility levels up to and including the current compatibility - level. The idea is that each compatibility level controls behavior - that changed in that version of bbaasshh, but that behavior may have been - present in earlier versions. For instance, the change to use locale- - based comparisons with the [[[[ command came in bash-4.1, and earlier + If a user enables, say, ccoommppaatt3322, it may affect the behavior of other + compatibility levels up to and including the current compatibility + level. The idea is that each compatibility level controls behavior + that changed in that version of bbaasshh, but that behavior may have been + present in earlier versions. For instance, the change to use locale- + based comparisons with the [[[[ command came in bash-4.1, and earlier versions used ASCII-based comparisons, so enabling ccoommppaatt3322 will enable - ASCII-based comparisons as well. That granularity may not be suffi- - cient for all uses, and as a result users should employ compatibility - levels carefully. Read the documentation for a particular feature to + ASCII-based comparisons as well. That granularity may not be suffi- + cient for all uses, and as a result users should employ compatibility + levels carefully. Read the documentation for a particular feature to find out the current behavior. - Bash-4.3 introduced a new shell variable: BBAASSHH__CCOOMMPPAATT. The value as- + Bash-4.3 introduced a new shell variable: BBAASSHH__CCOOMMPPAATT. The value as- signed to this variable (a decimal version number like 4.2, or an inte- - ger corresponding to the ccoommppaatt_N_N option, like 42) determines the com- + ger corresponding to the ccoommppaatt_N_N option, like 42) determines the com- patibility level. - Starting with bash-4.4, Bash has begun deprecating older compatibility - levels. Eventually, the options will be removed in favor of BBAASSHH__CCOOMM-- + Starting with bash-4.4, Bash has begun deprecating older compatibility + levels. Eventually, the options will be removed in favor of BBAASSHH__CCOOMM-- PPAATT. - Bash-5.0 is the final version for which there will be an individual - shopt option for the previous version. Users should use BBAASSHH__CCOOMMPPAATT on + Bash-5.0 is the final version for which there will be an individual + shopt option for the previous version. Users should use BBAASSHH__CCOOMMPPAATT on bash-5.0 and later versions. - The following table describes the behavior changes controlled by each + The following table describes the behavior changes controlled by each compatibility level setting. The ccoommppaatt_N_N tag is used as shorthand for setting the compatibility level to _N_N using one of the following mecha- - nisms. For versions prior to bash-5.0, the compatibility level may be - set using the corresponding ccoommppaatt_N_N shopt option. For bash-4.3 and - later versions, the BBAASSHH__CCOOMMPPAATT variable is preferred, and it is re- + nisms. For versions prior to bash-5.0, the compatibility level may be + set using the corresponding ccoommppaatt_N_N shopt option. For bash-4.3 and + later versions, the BBAASSHH__CCOOMMPPAATT variable is preferred, and it is re- quired for bash-5.1 and later versions. ccoommppaatt3311 @@ -6441,114 +6450,114 @@ SSHHEELLLL CCOOMMPPAATTIIBBIILLIITTYY MMOODDEE ator (=~) has no special effect ccoommppaatt3322 - +o interrupting a command list such as "a ; b ; c" causes - the execution of the next command in the list (in - bash-4.0 and later versions, the shell acts as if it re- - ceived the interrupt, so interrupting one command in a + +o interrupting a command list such as "a ; b ; c" causes + the execution of the next command in the list (in + bash-4.0 and later versions, the shell acts as if it re- + ceived the interrupt, so interrupting one command in a list aborts the execution of the entire list) ccoommppaatt4400 - +o the << and >> operators to the [[[[ command do not consider + +o the << and >> operators to the [[[[ command do not consider the current locale when comparing strings; they use ASCII ordering. Bash versions prior to bash-4.1 use ASCII col- - lation and _s_t_r_c_m_p(3); bash-4.1 and later use the current + lation and _s_t_r_c_m_p(3); bash-4.1 and later use the current locale's collation sequence and _s_t_r_c_o_l_l(3). ccoommppaatt4411 - +o in _p_o_s_i_x mode, ttiimmee may be followed by options and still + +o in _p_o_s_i_x mode, ttiimmee may be followed by options and still be recognized as a reserved word (this is POSIX interpre- tation 267) +o in _p_o_s_i_x mode, the parser requires that an even number of - single quotes occur in the _w_o_r_d portion of a double- - quoted parameter expansion and treats them specially, so - that characters within the single quotes are considered + single quotes occur in the _w_o_r_d portion of a double- + quoted parameter expansion and treats them specially, so + that characters within the single quotes are considered quoted (this is POSIX interpretation 221) ccoommppaatt4422 +o the replacement string in double-quoted pattern substitu- - tion does not undergo quote removal, as it does in ver- + tion does not undergo quote removal, as it does in ver- sions after bash-4.2 - +o in posix mode, single quotes are considered special when - expanding the _w_o_r_d portion of a double-quoted parameter - expansion and can be used to quote a closing brace or - other special character (this is part of POSIX interpre- - tation 221); in later versions, single quotes are not + +o in posix mode, single quotes are considered special when + expanding the _w_o_r_d portion of a double-quoted parameter + expansion and can be used to quote a closing brace or + other special character (this is part of POSIX interpre- + tation 221); in later versions, single quotes are not special within double-quoted word expansions ccoommppaatt4433 - +o the shell does not print a warning message if an attempt - is made to use a quoted compound assignment as an argu- - ment to declare (e.g., declare -a foo='(1 2)'). Later + +o the shell does not print a warning message if an attempt + is made to use a quoted compound assignment as an argu- + ment to declare (e.g., declare -a foo='(1 2)'). Later versions warn that this usage is deprecated - +o word expansion errors are considered non-fatal errors - that cause the current command to fail, even in posix - mode (the default behavior is to make them fatal errors + +o word expansion errors are considered non-fatal errors + that cause the current command to fail, even in posix + mode (the default behavior is to make them fatal errors that cause the shell to exit) - +o when executing a shell function, the loop state + +o when executing a shell function, the loop state (while/until/etc.) is not reset, so bbrreeaakk or ccoonnttiinnuuee in that function will break or continue loops in the calling - context. Bash-4.4 and later reset the loop state to pre- + context. Bash-4.4 and later reset the loop state to pre- vent this ccoommppaatt4444 - +o the shell sets up the values used by BBAASSHH__AARRGGVV and - BBAASSHH__AARRGGCC so they can expand to the shell's positional + +o the shell sets up the values used by BBAASSHH__AARRGGVV and + BBAASSHH__AARRGGCC so they can expand to the shell's positional parameters even if extended debugging mode is not enabled - +o a subshell inherits loops from its parent context, so - bbrreeaakk or ccoonnttiinnuuee will cause the subshell to exit. - Bash-5.0 and later reset the loop state to prevent the + +o a subshell inherits loops from its parent context, so + bbrreeaakk or ccoonnttiinnuuee will cause the subshell to exit. + Bash-5.0 and later reset the loop state to prevent the exit - +o variable assignments preceding builtins like eexxppoorrtt and + +o variable assignments preceding builtins like eexxppoorrtt and rreeaaddoonnllyy that set attributes continue to affect variables with the same name in the calling environment even if the shell is not in posix mode ccoommppaatt5500 - +o Bash-5.1 changed the way $$RRAANNDDOOMM is generated to intro- + +o Bash-5.1 changed the way $$RRAANNDDOOMM is generated to intro- duce slightly more randomness. If the shell compatibility - level is set to 50 or lower, it reverts to the method - from bash-5.0 and previous versions, so seeding the ran- - dom number generator by assigning a value to RRAANNDDOOMM will + level is set to 50 or lower, it reverts to the method + from bash-5.0 and previous versions, so seeding the ran- + dom number generator by assigning a value to RRAANNDDOOMM will produce the same sequence as in bash-5.0 - +o If the command hash table is empty, bash versions prior - to bash-5.1 printed an informational message to that ef- - fect, even when producing output that can be reused as - input. Bash-5.1 suppresses that message when the --ll op- + +o If the command hash table is empty, bash versions prior + to bash-5.1 printed an informational message to that ef- + fect, even when producing output that can be reused as + input. Bash-5.1 suppresses that message when the --ll op- tion is supplied. ccoommppaatt5511 - +o The uunnsseett builtin treats attempts to unset array sub- - scripts @@ and ** differently depending on whether the ar- - ray is indexed or associative, and differently than in + +o The uunnsseett builtin treats attempts to unset array sub- + scripts @@ and ** differently depending on whether the ar- + ray is indexed or associative, and differently than in previous versions. 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 - +o setting or unsetting the values of SSHHEELLLL, PPAATTHH, HHIISSTTFFIILLEE, EENNVV, + +o setting or unsetting the values of SSHHEELLLL, PPAATTHH, HHIISSTTFFIILLEE, EENNVV, or BBAASSHH__EENNVV +o specifying command names containing // - +o specifying a filename containing a // as an argument to the .. + +o specifying a filename 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 hhiissttoorryy 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 >> redirect- @@ -6557,28 +6566,28 @@ RREESSTTRRIICCTTEEDD SSHHEELLLL +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 - +o turning off restricted mode with sseett ++rr or sshhoopptt --uu rree-- + +o turning off restricted mode with sseett ++rr or sshhoopptt --uu rree-- ssttrriicctteedd__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 -- http://pubs.opengroup.org/onlinepubs/9699919799/ http://tiswww.case.edu/~chet/bash/POSIX -- a description of posix mode @@ -6596,10 +6605,10 @@ 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 _~_/_._b_a_s_h___h_i_s_t_o_r_y - The default value of HHIISSTTFFIILLEE, the file in which bash saves the + The default value of HHIISSTTFFIILLEE, the file in which bash saves the command history _~_/_._i_n_p_u_t_r_c Individual _r_e_a_d_l_i_n_e initialization file @@ -6613,15 +6622,15 @@ 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_/_g_n_u_/_b_a_s_h_/ and _h_t_t_p_:_/_/_g_i_t_._s_a_v_a_n_- _n_a_h_._g_n_u_._o_r_g_/_c_g_i_t_/_b_a_s_h_._g_i_t_/_s_n_a_p_s_h_o_t_/_b_a_s_h_-_m_a_s_t_e_r_._t_a_r_._g_z. - 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: @@ -6632,7 +6641,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 @@ -6649,10 +6658,10 @@ 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 - process is stopped, the shell immediately executes the next command in - the sequence. It suffices to place the sequence of commands between - parentheses to force it into a subshell, which may be stopped as a + handled gracefully when process suspension is attempted. When a + process is stopped, the shell immediately executes the next command in + the sequence. It suffices to place the sequence of commands between + parentheses to force it into a subshell, which may be stopped as a unit. Array variables may not (yet) be exported. @@ -6661,4 +6670,4 @@ BBUUGGSS -GNU Bash 5.2 2022 September 19 BASH(1) +GNU Bash 5.2 2022 December 2 BASH(1) diff --git a/doc/bash.1 b/doc/bash.1 index c1389240..76660ace 100644 --- a/doc/bash.1 +++ b/doc/bash.1 @@ -5,12 +5,12 @@ .\" Case Western Reserve University .\" chet.ramey@case.edu .\" -.\" Last Change: Mon Sep 19 11:13:21 EDT 2022 +.\" Last Change: Fri Dec 2 15:53:52 EST 2022 .\" .\" bash_builtins, strip all but Built-Ins section .if \n(zZ=1 .ig zZ .if \n(zY=1 .ig zY -.TH BASH 1 "2022 September 19" "GNU Bash 5.2" +.TH BASH 1 "2022 December 2" "GNU Bash 5.2" .\" .\" There's some problem with having a `@' .\" in a tagged paragraph with the BSD man macros. @@ -10858,39 +10858,49 @@ sort lexicographically using ASCII ordering. Print the accumulated user and system times for the shell and for processes run from the shell. The return status is 0. .TP -\fBtrap\fP [\fB\-lp\fP] [[\fIarg\fP] \fIsigspec\fP ...] -The command -.I arg -is to be read and executed when the shell receives +\fBtrap\fP [\fB\-lp\fP] [[\fIaction\fP] \fIsigspec\fP ...] +The +.I action +is a command that is read and executed when the shell receives signal(s) .IR sigspec . If -.I arg +.I action is absent (and there is a single \fIsigspec\fP) or .BR \- , each specified signal is reset to its original disposition (the value it had upon entrance to the shell). If -.I arg +.I action is the null string the signal specified by each .I sigspec is ignored by the shell and by the commands it invokes. +.if t .sp 0.5 +.if n .sp 1 +If no arguments are supplied, +.B trap +displays the actions associated with each trapped signal +as a set of \fBtrap\fP commands +that can be reused as shell input to +restore the current signal dispositions. If -.I arg -is not present and -.B \-p -has been supplied, then the trap commands associated with each -.I sigspec -are displayed. -If no arguments are supplied or if only .B \-p is given, -.B trap -prints the list of commands associated with each signal. +and +.I action +is not present, +then \fBtrap\fP displays the actions associated with each +.I sigspec +or, if none are supplied, for all trapped signals, +as a set of \fBtrap\fP commands +that can be reused as shell input to +restore the current signal dispositions. +.if t .sp 0.5 +.if n .sp 1 The .B \-l -option causes the shell to print a list of signal names and +option causes \fBtrap\fP to print a list of signal names and their corresponding numbers. Each .I sigspec @@ -10908,7 +10918,7 @@ is .SM .B EXIT (0) the command -.I arg +.I action is executed on exit from the shell. If a .I sigspec @@ -10916,10 +10926,12 @@ is .SM .BR DEBUG , the command -.I arg +.I action is executed before every \fIsimple command\fP, \fIfor\fP command, -\fIcase\fP command, \fIselect\fP command, every arithmetic \fIfor\fP -command, and before the first command executes in a shell function (see +\fIcase\fP command, \fIselect\fP command, (( arithmetic command, +[[ conditional command, +arithmetic \fIfor\fP command, and before the first command executes +in a shell function (see .SM .B SHELL GRAMMAR .ie \n(zZ=1 in \fIbash(1)\fP). @@ -10932,7 +10944,7 @@ is .SM .BR RETURN , the command -.I arg +.I action is executed each time a shell function or a script executed with the \fB.\fP or \fBsource\fP builtins finishes executing. .if t .sp 0.5 @@ -10943,7 +10955,7 @@ is .SM .BR ERR , the command -.I arg +.I action is executed whenever a pipeline (which may consist of a single simple command), a list, or a compound command returns a @@ -10972,7 +10984,9 @@ being inverted using These are the same conditions obeyed by the \fBerrexit\fP (\fB\-e\fP) option. .if t .sp 0.5 .if n .sp 1 -Signals ignored upon entry to the shell cannot be trapped or reset. +When the shell is not interactive, +signals ignored upon entry to the shell cannot be trapped or reset. +Interactive shells permit trapping signals ignored on entry. Trapped signals that are not being ignored are reset to their original values in a subshell or subshell environment when one is created. The return status is false if any diff --git a/doc/bash.html b/doc/bash.html index d8093690..f0bd9343 100644 --- a/doc/bash.html +++ b/doc/bash.html @@ -3,7 +3,7 @@ -
BASH(1)2022 September 19BASH(1) +BASH(1)2022 December 2BASH(1)

Index @@ -1586,7 +1586,7 @@ See the description of shopt below under -SHELLBUILTINCOMMANDS. +SHELL BUILTIN COMMANDS.   @@ -4994,7 +4994,7 @@ Matches anything except one of the given patterns

-Theextglob option changes the behavior of the parser, since the +The extglob option changes the behavior of the parser, since the parentheses are normally treated as operators with syntactic meaning. To ensure that extended matching patterns are parsed correctly, make sure that extglob is enabled before parsing constructs containing the @@ -13632,16 +13632,16 @@ sort lexicographically using ASCII ordering.

Print the accumulated user and system times for the shell and for processes run from the shell. The return status is 0. -
trap [-lp] [[arg] sigspec ...]
-The command -arg +
trap [-lp] [[action] sigspec ...]
+The +action -is to be read and executed when the shell receives +is a command that is read and executed when the shell receives signal(s) sigspec. If -arg +action is absent (and there is a single sigspec) or -, @@ -13650,33 +13650,44 @@ each specified signal is reset to its original disposition (the value it had upon entrance to the shell). If -arg +action is the null string the signal specified by each sigspec is ignored by the shell and by the commands it invokes. +

+ + +If no arguments are supplied, +trap + +displays the actions associated with each trapped signal +as a set of trap commands +that can be reused as shell input to +restore the current signal dispositions. If -arg - -is not present and --p - -has been supplied, then the trap commands associated with each -sigspec - -are displayed. -If no arguments are supplied or if only -p is given, -trap +and +action + +is not present, +then trap displays the actions associated with each +sigspec + +or, if none are supplied, for all trapped signals, +as a set of trap commands +that can be reused as shell input to +restore the current signal dispositions. +

+ -prints the list of commands associated with each signal. The -l -option causes the shell to print a list of signal names and +option causes trap to print a list of signal names and their corresponding numbers. Each sigspec @@ -13699,7 +13710,7 @@ is (0) the command -arg +action is executed on exit from the shell. If a @@ -13710,11 +13721,13 @@ is the command -arg +action is executed before every simple command, for command, -case command, select command, every arithmetic for -command, and before the first command executes in a shell function (see +case command, select command, (( arithmetic command, +[[ conditional command, +arithmetic for command, and before the first command executes +in a shell function (see SHELL GRAMMAR @@ -13730,7 +13743,7 @@ is the command -arg +action is executed each time a shell function or a script executed with the . or source builtins finishes executing. @@ -13745,7 +13758,7 @@ is the command -arg +action is executed whenever a pipeline (which may consist of a single simple @@ -13783,7 +13796,9 @@ These are the same conditions obeyed by the errexit (-e) option.

-Signals ignored upon entry to the shell cannot be trapped or reset. +When the shell is not interactive, +signals ignored upon entry to the shell cannot be trapped or reset. +Interactive shells permit trapping signals ignored on entry. Trapped signals that are not being ignored are reset to their original values in a subshell or subshell environment when one is created. The return status is false if any @@ -14787,7 +14802,7 @@ There may be only one active coprocess at a time.


-
GNU Bash 5.22022 September 19BASH(1) +GNU Bash 5.22022 December 2BASH(1)

@@ -14893,7 +14908,7 @@ There may be only one active coprocess at a time.
BUGS

-This document was created by man2html from /usr/local/src/bash/bash-20220907/doc/bash.1.
-Time: 19 September 2022 12:02:51 EDT +This document was created by man2html from /usr/local/src/bash/bash-20221202/doc/bash.1.
+Time: 02 December 2022 17:01:20 EST diff --git a/doc/bash.info b/doc/bash.info index 6d31de62..720bc6a8 100644 --- a/doc/bash.info +++ b/doc/bash.info @@ -1,9 +1,9 @@ This is bash.info, produced by makeinfo version 6.8 from bashref.texi. This text is a brief description of the features that are present in the -Bash shell (version 5.2, 19 September 2022). +Bash shell (version 5.2, 2 December 2022). - This is Edition 5.2, last updated 19 September 2022, of 'The GNU Bash + This is Edition 5.2, last updated 2 December 2022, of 'The GNU Bash Reference Manual', for 'Bash', Version 5.2. Copyright (C) 1988-2022 Free Software Foundation, Inc. @@ -26,10 +26,10 @@ Bash Features ************* This text is a brief description of the features that are present in the -Bash shell (version 5.2, 19 September 2022). The Bash home page is +Bash shell (version 5.2, 2 December 2022). The Bash home page is . - This is Edition 5.2, last updated 19 September 2022, of 'The GNU Bash + This is Edition 5.2, last updated 2 December 2022, of 'The GNU Bash Reference Manual', for 'Bash', Version 5.2. Bash contains features that appear in other popular shells, and some @@ -1832,7 +1832,7 @@ immediately follow the left brace in order to introduce indirection. In each of the cases below, WORD is subject to tilde expansion, parameter expansion, command substitution, and arithmetic expansion. - When not performing substring expansion, using the form described + When not performing substring expansion, using the forms described below (e.g., ':-'), Bash tests for a parameter that is unset or null. Omitting the colon results in a test only for a parameter that is unset. Put another way, if the colon is included, the operator tests for both @@ -3563,37 +3563,43 @@ standard. children. The return status is zero. 'trap' - trap [-lp] [ARG] [SIGSPEC ...] + trap [-lp] [ACTION] [SIGSPEC ...] - The commands in ARG are to be read and executed when the shell - receives signal SIGSPEC. If ARG is absent (and there is a single - SIGSPEC) or equal to '-', each specified signal's disposition is - reset to the value it had when the shell was started. If ARG is - the null string, then the signal specified by each SIGSPEC is - ignored by the shell and commands it invokes. If ARG is not - present and '-p' has been supplied, the shell displays the trap - commands associated with each SIGSPEC. If no arguments are - supplied, or only '-p' is given, 'trap' prints the list of commands - associated with each signal number in a form that may be reused as - shell input. The '-l' option causes the shell to print a list of - signal names and their corresponding numbers. Each SIGSPEC is - either a signal name or a signal number. Signal names are case - insensitive and the 'SIG' prefix is optional. + The ACTION is a command that is read and executed when the shell + receives signal SIGSPEC. If ACTION is absent (and there is a + single SIGSPEC) or equal to '-', each specified signal's + disposition is reset to the value it had when the shell was + started. If ACTION is the null string, then the signal specified + by each SIGSPEC is ignored by the shell and commands it invokes. - If a SIGSPEC is '0' or 'EXIT', ARG is executed when the shell - exits. If a SIGSPEC is 'DEBUG', the command ARG is executed before - every simple command, 'for' command, 'case' command, 'select' - command, every arithmetic 'for' command, and before the first - command executes in a shell function. Refer to the description of - the 'extdebug' option to the 'shopt' builtin (*note The Shopt - Builtin::) for details of its effect on the 'DEBUG' trap. If a - SIGSPEC is 'RETURN', the command ARG is executed each time a shell - function or a script executed with the '.' or 'source' builtins - finishes executing. + If no arguments are supplied, 'trap' prints the actions associated + with each trapped signal as a set of 'trap' commands that can be + reused as shell input to restore the current signal dispositions. + If ACTION is not present and '-p' has been supplied, 'trap' + displays the trap commands associated with each SIGSPEC, or, if no + SIGSPECs are supplied, for all trapped signals, as a set of 'trap' + commands that can be reused as shell input to restore the current + signal dispositions. - If a SIGSPEC is 'ERR', the command ARG is executed whenever a - pipeline (which may consist of a single simple command), a list, or - a compound command returns a non-zero exit status, subject to the + The '-l' option causes 'trap' to print a list of signal names and + their corresponding numbers. Each SIGSPEC is either a signal name + or a signal number. Signal names are case insensitive and the + 'SIG' prefix is optional. + + If a SIGSPEC is '0' or 'EXIT', ACTION is executed when the shell + exits. If a SIGSPEC is 'DEBUG', ACTION is executed before every + simple command, 'for' command, 'case' command, 'select' command, (( + arithmetic command, [[ conditional command, arithmetic 'for' + command, and before the first command executes in a shell function. + Refer to the description of the 'extdebug' option to the 'shopt' + builtin (*note The Shopt Builtin::) for details of its effect on + the 'DEBUG' trap. If a SIGSPEC is 'RETURN', ACTION is executed + each time a shell function or a script executed with the '.' or + 'source' builtins finishes executing. + + If a SIGSPEC is 'ERR', ACTION is executed whenever a pipeline + (which may consist of a single simple command), a list, or a + compound command returns a non-zero exit status, subject to the following conditions. The 'ERR' trap is not executed if the failed command is part of the command list immediately following an 'until' or 'while' keyword, part of the test following the 'if' or @@ -3603,10 +3609,11 @@ standard. status is being inverted using '!'. These are the same conditions obeyed by the 'errexit' ('-e') option. - Signals ignored upon entry to the shell cannot be trapped or reset. - Trapped signals that are not being ignored are reset to their - original values in a subshell or subshell environment when one is - created. + Signals ignored upon entry to a non-interactive shell cannot be + trapped or reset. Interactive shells permit trapping signals + ignored on entry. Trapped signals that are not being ignored are + reset to their original values in a subshell or subshell + environment when one is created. The return status is zero unless a SIGSPEC does not specify a valid signal. @@ -7190,8 +7197,9 @@ startup files. handler for a given signal to the original disposition, they should use '-' as the first argument. - 42. 'trap -p' displays signals whose dispositions are set to SIG_DFL - and those that were ignored when the shell started. + 42. 'trap -p' without arguments displays signals whose dispositions + are set to SIG_DFL and those that were ignored when the shell + started, not just trapped signals. 43. The '.' and 'source' builtins do not search the current directory for the filename argument if it is not found by searching 'PATH'. @@ -10887,10 +10895,11 @@ of Bash. The latest version of Bash is always available for FTP from . Once you have determined that a bug actually exists, use the -'bashbug' 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 or posted to the Usenet -newsgroup 'gnu.bash.bug'. +'bashbug' command to submit a bug report or use the form at the Bash project page. +If you have a fix, you are encouraged to submit that as well! +Suggestions and 'philosophical' bug reports may be mailed to + or . All bug reports should include: * The version number of Bash. @@ -11867,10 +11876,10 @@ D.1 Index of Shell Builtin Commands * typeset: Bash Builtins. (line 631) * ulimit: Bash Builtins. (line 637) * umask: Bourne Shell Builtins. - (line 415) + (line 422) * unalias: Bash Builtins. (line 743) * unset: Bourne Shell Builtins. - (line 433) + (line 440) * wait: Job Control Builtins. (line 76) @@ -12534,138 +12543,138 @@ D.5 Concept Index  Tag Table: -Node: Top896 -Node: Introduction2815 -Node: What is Bash?3028 -Node: What is a shell?4139 -Node: Definitions6674 -Node: Basic Shell Features9622 -Node: Shell Syntax10838 -Node: Shell Operation11861 -Node: Quoting13151 -Node: Escape Character14452 -Node: Single Quotes14934 -Node: Double Quotes15279 -Node: ANSI-C Quoting16554 -Node: Locale Translation17861 -Node: Creating Internationalized Scripts19169 -Node: Comments23283 -Node: Shell Commands23898 -Node: Reserved Words24833 -Node: Simple Commands25586 -Node: Pipelines26237 -Node: Lists29233 -Node: Compound Commands31025 -Node: Looping Constructs32034 -Node: Conditional Constructs34526 -Node: Command Grouping49011 -Node: Coprocesses50486 -Node: GNU Parallel53146 -Node: Shell Functions54060 -Node: Shell Parameters61942 -Node: Positional Parameters66327 -Node: Special Parameters67226 -Node: Shell Expansions70437 -Node: Brace Expansion72561 -Node: Tilde Expansion75292 -Node: Shell Parameter Expansion77910 -Node: Command Substitution96258 -Node: Arithmetic Expansion97610 -Node: Process Substitution98575 -Node: Word Splitting99692 -Node: Filename Expansion101633 -Node: Pattern Matching104379 -Node: Quote Removal109378 -Node: Redirections109670 -Node: Executing Commands119327 -Node: Simple Command Expansion119994 -Node: Command Search and Execution122101 -Node: Command Execution Environment124476 -Node: Environment127508 -Node: Exit Status129168 -Node: Signals130949 -Node: Shell Scripts134395 -Node: Shell Builtin Commands137419 -Node: Bourne Shell Builtins139454 -Node: Bash Builtins160917 -Node: Modifying Shell Behavior191770 -Node: The Set Builtin192112 -Node: The Shopt Builtin202710 -Node: Special Builtins218619 -Node: Shell Variables219595 -Node: Bourne Shell Variables220029 -Node: Bash Variables222130 -Node: Bash Features254942 -Node: Invoking Bash255952 -Node: Bash Startup Files261962 -Node: Interactive Shells267090 -Node: What is an Interactive Shell?267498 -Node: Is this Shell Interactive?268144 -Node: Interactive Shell Behavior268956 -Node: Bash Conditional Expressions272582 -Node: Shell Arithmetic277221 -Node: Aliases280162 -Node: Arrays282772 -Node: The Directory Stack289160 -Node: Directory Stack Builtins289941 -Node: Controlling the Prompt294198 -Node: The Restricted Shell297160 -Node: Bash POSIX Mode299767 -Node: Shell Compatibility Mode311682 -Node: Job Control320246 -Node: Job Control Basics320703 -Node: Job Control Builtins325702 -Node: Job Control Variables331494 -Node: Command Line Editing332647 -Node: Introduction and Notation334315 -Node: Readline Interaction335935 -Node: Readline Bare Essentials337123 -Node: Readline Movement Commands338909 -Node: Readline Killing Commands339866 -Node: Readline Arguments341784 -Node: Searching342825 -Node: Readline Init File345008 -Node: Readline Init File Syntax346266 -Node: Conditional Init Constructs369849 -Node: Sample Init File374042 -Node: Bindable Readline Commands377163 -Node: Commands For Moving378364 -Node: Commands For History380412 -Node: Commands For Text385403 -Node: Commands For Killing389049 -Node: Numeric Arguments392079 -Node: Commands For Completion393215 -Node: Keyboard Macros397403 -Node: Miscellaneous Commands398088 -Node: Readline vi Mode404030 -Node: Programmable Completion404934 -Node: Programmable Completion Builtins412711 -Node: A Programmable Completion Example423460 -Node: Using History Interactively428705 -Node: Bash History Facilities429386 -Node: Bash History Builtins432388 -Node: History Interaction437409 -Node: Event Designators441026 -Node: Word Designators442377 -Node: Modifiers444134 -Node: Installing Bash445939 -Node: Basic Installation447073 -Node: Compilers and Options450792 -Node: Compiling For Multiple Architectures451530 -Node: Installation Names453219 -Node: Specifying the System Type455325 -Node: Sharing Defaults456039 -Node: Operation Controls456709 -Node: Optional Features457664 -Node: Reporting Bugs468880 -Node: Major Differences From The Bourne Shell470152 -Node: GNU Free Documentation License486998 -Node: Indexes512172 -Node: Builtin Index512623 -Node: Reserved Word Index519447 -Node: Variable Index521892 -Node: Function Index538663 -Node: Concept Index552444 +Node: Top892 +Node: Introduction2807 +Node: What is Bash?3020 +Node: What is a shell?4131 +Node: Definitions6666 +Node: Basic Shell Features9614 +Node: Shell Syntax10830 +Node: Shell Operation11853 +Node: Quoting13143 +Node: Escape Character14444 +Node: Single Quotes14926 +Node: Double Quotes15271 +Node: ANSI-C Quoting16546 +Node: Locale Translation17853 +Node: Creating Internationalized Scripts19161 +Node: Comments23275 +Node: Shell Commands23890 +Node: Reserved Words24825 +Node: Simple Commands25578 +Node: Pipelines26229 +Node: Lists29225 +Node: Compound Commands31017 +Node: Looping Constructs32026 +Node: Conditional Constructs34518 +Node: Command Grouping49003 +Node: Coprocesses50478 +Node: GNU Parallel53138 +Node: Shell Functions54052 +Node: Shell Parameters61934 +Node: Positional Parameters66319 +Node: Special Parameters67218 +Node: Shell Expansions70429 +Node: Brace Expansion72553 +Node: Tilde Expansion75284 +Node: Shell Parameter Expansion77902 +Node: Command Substitution96251 +Node: Arithmetic Expansion97603 +Node: Process Substitution98568 +Node: Word Splitting99685 +Node: Filename Expansion101626 +Node: Pattern Matching104372 +Node: Quote Removal109371 +Node: Redirections109663 +Node: Executing Commands119320 +Node: Simple Command Expansion119987 +Node: Command Search and Execution122094 +Node: Command Execution Environment124469 +Node: Environment127501 +Node: Exit Status129161 +Node: Signals130942 +Node: Shell Scripts134388 +Node: Shell Builtin Commands137412 +Node: Bourne Shell Builtins139447 +Node: Bash Builtins161229 +Node: Modifying Shell Behavior192082 +Node: The Set Builtin192424 +Node: The Shopt Builtin203022 +Node: Special Builtins218931 +Node: Shell Variables219907 +Node: Bourne Shell Variables220341 +Node: Bash Variables222442 +Node: Bash Features255254 +Node: Invoking Bash256264 +Node: Bash Startup Files262274 +Node: Interactive Shells267402 +Node: What is an Interactive Shell?267810 +Node: Is this Shell Interactive?268456 +Node: Interactive Shell Behavior269268 +Node: Bash Conditional Expressions272894 +Node: Shell Arithmetic277533 +Node: Aliases280474 +Node: Arrays283084 +Node: The Directory Stack289472 +Node: Directory Stack Builtins290253 +Node: Controlling the Prompt294510 +Node: The Restricted Shell297472 +Node: Bash POSIX Mode300079 +Node: Shell Compatibility Mode312043 +Node: Job Control320607 +Node: Job Control Basics321064 +Node: Job Control Builtins326063 +Node: Job Control Variables331855 +Node: Command Line Editing333008 +Node: Introduction and Notation334676 +Node: Readline Interaction336296 +Node: Readline Bare Essentials337484 +Node: Readline Movement Commands339270 +Node: Readline Killing Commands340227 +Node: Readline Arguments342145 +Node: Searching343186 +Node: Readline Init File345369 +Node: Readline Init File Syntax346627 +Node: Conditional Init Constructs370210 +Node: Sample Init File374403 +Node: Bindable Readline Commands377524 +Node: Commands For Moving378725 +Node: Commands For History380773 +Node: Commands For Text385764 +Node: Commands For Killing389410 +Node: Numeric Arguments392440 +Node: Commands For Completion393576 +Node: Keyboard Macros397764 +Node: Miscellaneous Commands398449 +Node: Readline vi Mode404391 +Node: Programmable Completion405295 +Node: Programmable Completion Builtins413072 +Node: A Programmable Completion Example423821 +Node: Using History Interactively429066 +Node: Bash History Facilities429747 +Node: Bash History Builtins432749 +Node: History Interaction437770 +Node: Event Designators441387 +Node: Word Designators442738 +Node: Modifiers444495 +Node: Installing Bash446300 +Node: Basic Installation447434 +Node: Compilers and Options451153 +Node: Compiling For Multiple Architectures451891 +Node: Installation Names453580 +Node: Specifying the System Type455686 +Node: Sharing Defaults456400 +Node: Operation Controls457070 +Node: Optional Features458025 +Node: Reporting Bugs469241 +Node: Major Differences From The Bourne Shell470582 +Node: GNU Free Documentation License487428 +Node: Indexes512602 +Node: Builtin Index513053 +Node: Reserved Word Index519877 +Node: Variable Index522322 +Node: Function Index539093 +Node: Concept Index552874  End Tag Table diff --git a/doc/bash.pdf b/doc/bash.pdf index b8f7dd69..0160c067 100644 Binary files a/doc/bash.pdf and b/doc/bash.pdf differ diff --git a/doc/bash.ps b/doc/bash.ps index b6a4bbe8..28c47433 100644 --- a/doc/bash.ps +++ b/doc/bash.ps @@ -1,6 +1,6 @@ %!PS-Adobe-3.0 %%Creator: groff version 1.22.4 -%%CreationDate: Mon Sep 19 12:02:42 2022 +%%CreationDate: Fri Dec 2 17:01:15 2022 %%DocumentNeededResources: font Times-Roman %%+ font Times-Bold %%+ font Times-Italic @@ -340,7 +340,7 @@ F .475(xtended deb)-.15 F(ug-)-.2 E (~/.bashr)3.598 E(c)-.37 E F0 1.598(if the)4.408 F(shell is interacti) 144 710.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(GNU Bash 5.2)72 768 Q -(2022 September 19)135.955 E(1)190.115 E 0 Cg EP +(2022 December 2)139.295 E(1)193.455 E 0 Cg EP %%Page: 2 2 %%BeginPageSetup BP @@ -463,8 +463,8 @@ F2(~/.bashr)108 691.2 Q(c)-.37 E F0 2.535(,i)C 2.535(ft)-2.535 G .035 Q F1(bash)5.306 E F0 2.806(is started non-interacti)5.306 F -.15(ve)-.25 G(ly).15 E 5.306(,t)-.65 G 5.306(or)-5.306 G 2.806 (un a shell script, for e)-5.306 F 2.805(xample, it looks for the v)-.15 -F(ariable)-.25 E(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(2) -190.115 E 0 Cg EP +F(ariable)-.25 E(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(2) +193.455 E 0 Cg EP %%Page: 3 3 %%BeginPageSetup BP @@ -595,7 +595,7 @@ F2(case)3.144 E F0(or)3.144 E F2(select)3.143 E F0 .643(command \(only) 669.6 R F6(SHELL GRAMMAR)72 686.4 Q F0 (This section describes the syntax of the v)108 698.4 Q (arious forms of shell commands.)-.25 E(GNU Bash 5.2)72 768 Q -(2022 September 19)135.955 E(3)190.115 E 0 Cg EP +(2022 December 2)139.295 E(3)193.455 E 0 Cg EP %%Page: 4 4 %%BeginPageSetup BP @@ -718,7 +718,7 @@ or more pipelines separated by the)108 650.4 R F1(&&)2.671 E F0(and) G(cuted if, and only if,).15 E F2(command1)2.7 E F0(returns an e)2.5 E (xit status of zero \(success\).)-.15 E(An OR list has the form)108 712.8 Q F2(command1)144 729.6 Q F1(||)2.5 E F2(command2)2.5 E F0 -(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(4)190.115 E 0 Cg EP +(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(4)193.455 E 0 Cg EP %%Page: 5 5 %%BeginPageSetup BP @@ -854,7 +854,7 @@ ormal quoting and pattern characters lose their meanings between brack) .583(with inde)144 720 R 3.083(x0)-.15 G .582 (contains the portion of the string matching the entire re)-.001 F .582 (gular e)-.15 F 3.082(xpression. Substrings)-.15 F(GNU Bash 5.2)72 768 Q -(2022 September 19)135.955 E(5)190.115 E 0 Cg EP +(2022 December 2)139.295 E(5)193.455 E 0 Cg EP %%Page: 6 6 %%BeginPageSetup BP @@ -998,8 +998,8 @@ F0 .254(in place of)2.754 F F3(;;)2.754 E F0 .254(causes e)2.754 F -.15 (Using)144 720 Q F3(;;&)3.378 E F0 .878(in place of)3.378 F F3(;;)3.378 E F0 .878(causes the shell to test the ne)3.378 F .878 (xt pattern list in the statement, if an)-.15 F 2.178 -.65(y, a)-.15 H -(nd).65 E(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(6)190.115 E -0 Cg EP +(nd).65 E(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(6)193.455 E 0 +Cg EP %%Page: 7 7 %%BeginPageSetup BP @@ -1124,7 +1124,7 @@ Q F0 2.698(As)108 691.2 S .198 (cutes a compound command with).15 F 2.5(an)108 703.2 S .5 -.25(ew s) -2.5 H(et of positional parameters.).25 E (Shell functions are declared as follo)5 E(ws:)-.25 E(GNU Bash 5.2)72 -768 Q(2022 September 19)135.955 E(7)190.115 E 0 Cg EP +768 Q(2022 December 2)139.295 E(7)193.455 E 0 Cg EP %%Page: 8 8 %%BeginPageSetup BP @@ -1257,8 +1257,8 @@ E F2(@)2.5 E F0(ha)2.5 E .3 -.15(ve s)-.2 H (replaced as speci\214ed by the ANSI C standard.)3.027 F (Backslash escape sequences, if present, are decoded as follo)108 684 Q (ws:)-.25 E F2(\\a)144 696 Q F0(alert \(bell\))180 696 Q F2(\\b)144 708 -Q F0(backspace)180 708 Q(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 -E(8)190.115 E 0 Cg EP +Q F0(backspace)180 708 Q(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E +(8)193.455 E 0 Cg EP %%Page: 9 9 %%BeginPageSetup BP @@ -1305,30 +1305,30 @@ or if the string is not translated, the dollar sign is ignored.).25 F 393.6 R .535(ault, whether or not it is translated and)-.1 F 2.798 (replaced. If)108 405.6 R(the)2.798 E F1(noexpand_translation)2.797 E F0 .297(option is enabled using the)2.797 F F1(shopt)2.797 E F0 -.2(bu) -2.797 G .297(iltin, translated strings are sin-).2 F 2.044 -(gle-quoted instead of double-quoted.)108 417.6 R 2.044 -(See the description of)7.044 F F1(shopt)4.545 E F0(belo)4.545 E 4.545 -(wu)-.25 G(nder)-4.545 E/F3 9/Times-Bold@0 SF(SHELL)4.545 E/F4 9 -/Times-Roman@0 SF -.09(BU)C(IL).09 E(TIN)-.828 E F3(COM-)A(MANDS)108 -429.6 Q F4(.)A/F5 10.95/Times-Bold@0 SF -.81(PA)72 446.4 S(RAMETERS).81 -E F0(A)108 458.4 Q F2(par)4.575 E(ameter)-.15 E F0 .825 -(is an entity that stores v)4.055 F 3.325(alues. It)-.25 F .825 -(can be a)3.325 F F2(name)3.684 E F0 3.324(,an).18 G(umber)-3.324 E -3.324(,o)-.4 G 3.324(ro)-3.324 G .824(ne of the special characters) --3.324 F .801(listed belo)108 470.4 R 3.301(wu)-.25 G(nder)-3.301 E F1 -.801(Special P)3.301 F(arameters)-.1 E F0 5.802(.A)C F2(variable)-2.21 E -F0 .802(is a parameter denoted by a)3.482 F F2(name)3.662 E F0 5.802(.A) -.18 G -.25(va)-2.5 G .802(riable has a).25 F F2(value)108 482.4 Q F0 -.369(and zero or more)2.869 F F2(attrib)2.869 E(utes)-.2 E F0 5.369(.A)C -(ttrib)-5.369 E .369(utes are assigned using the)-.2 F F1(declar)2.868 E -(e)-.18 E F0 -.2(bu)2.868 G .368(iltin command \(see).2 F F1(declar) -2.868 E(e)-.18 E F0(belo)108 494.4 Q 2.5(wi)-.25 G(n)-2.5 E F3(SHELL B) -2.5 E(UIL)-.09 E(TIN COMMANDS)-.828 E F4(\).)A F0 2.754(Ap)108 511.2 S -.254(arameter is set if it has been assigned a v)-2.754 F 2.754 -(alue. The)-.25 F .254(null string is a v)2.754 F .255(alid v)-.25 F -2.755(alue. Once)-.25 F 2.755(av)2.755 G .255(ariable is set, it)-3.005 -F(may be unset only by using the)108 523.2 Q F1(unset)2.5 E F0 -.2(bu) -2.5 G(iltin command \(see).2 E F3(SHELL B)2.5 E(UIL)-.09 E(TIN COMMANDS) +2.797 G .297(iltin, translated strings are sin-).2 F 1.228 +(gle-quoted instead of double-quoted.)108 417.6 R 1.229 +(See the description of)6.228 F F1(shopt)3.729 E F0(belo)3.729 E 3.729 +(wu)-.25 G(nder)-3.729 E/F3 9/Times-Bold@0 SF 1.229(SHELL B)3.729 F(UIL) +-.09 E 1.229(TIN COM-)-.828 F(MANDS)108 429.6 Q/F4 9/Times-Roman@0 SF(.) +A/F5 10.95/Times-Bold@0 SF -.81(PA)72 446.4 S(RAMETERS).81 E F0(A)108 +458.4 Q F2(par)4.575 E(ameter)-.15 E F0 .825(is an entity that stores v) +4.055 F 3.325(alues. It)-.25 F .825(can be a)3.325 F F2(name)3.684 E F0 +3.324(,an).18 G(umber)-3.324 E 3.324(,o)-.4 G 3.324(ro)-3.324 G .824 +(ne of the special characters)-3.324 F .801(listed belo)108 470.4 R +3.301(wu)-.25 G(nder)-3.301 E F1 .801(Special P)3.301 F(arameters)-.1 E +F0 5.802(.A)C F2(variable)-2.21 E F0 .802(is a parameter denoted by a) +3.482 F F2(name)3.662 E F0 5.802(.A).18 G -.25(va)-2.5 G .802 +(riable has a).25 F F2(value)108 482.4 Q F0 .369(and zero or more)2.869 +F F2(attrib)2.869 E(utes)-.2 E F0 5.369(.A)C(ttrib)-5.369 E .369 +(utes are assigned using the)-.2 F F1(declar)2.868 E(e)-.18 E F0 -.2(bu) +2.868 G .368(iltin command \(see).2 F F1(declar)2.868 E(e)-.18 E F0 +(belo)108 494.4 Q 2.5(wi)-.25 G(n)-2.5 E F3(SHELL B)2.5 E(UIL)-.09 E +(TIN COMMANDS)-.828 E F4(\).)A F0 2.754(Ap)108 511.2 S .254 +(arameter is set if it has been assigned a v)-2.754 F 2.754(alue. The) +-.25 F .254(null string is a v)2.754 F .255(alid v)-.25 F 2.755 +(alue. Once)-.25 F 2.755(av)2.755 G .255(ariable is set, it)-3.005 F +(may be unset only by using the)108 523.2 Q F1(unset)2.5 E F0 -.2(bu)2.5 +G(iltin command \(see).2 E F3(SHELL B)2.5 E(UIL)-.09 E(TIN COMMANDS) -.828 E F0(belo)2.25 E(w\).)-.25 E(A)108 540 Q F2(variable)2.79 E F0 (may be assigned to by a statement of the form)2.68 E F2(name)144 556.8 Q F0(=[)A F2(value)A F0(])A(If)108 573.6 Q F2(value)3.023 E F0 .233 @@ -1373,7 +1373,7 @@ F0 2.664(commands\). When)2.664 F .164(+= is)2.664 F .132 (sion and added to the v)108 722.4 R(ariable')-.25 E 3.726(sc)-.55 G 1.227(urrent v)-3.726 F 1.227(alue, which is also e)-.25 F -.25(va)-.25 G 3.727(luated. When).25 F 1.227(+= is applied to an array)3.727 F -(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(9)190.115 E 0 Cg EP +(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(9)193.455 E 0 Cg EP %%Page: 10 10 %%BeginPageSetup BP @@ -1515,7 +1515,7 @@ E(ground pipeline.)-.15 E F1108 703.2 Q F0 .882 R -.2(vo)-.4 G .881(cation, by the).2 F F1(set)3.381 E F0 -.2(bu)3.381 G .881(iltin command, or).2 F(those set by the shell itself \(such as the) 144 715.2 Q F12.5 E F0(option\).)2.5 E(GNU Bash 5.2)72 768 Q -(2022 September 19)135.955 E(10)185.115 E 0 Cg EP +(2022 December 2)139.295 E(10)188.455 E 0 Cg EP %%Page: 11 11 %%BeginPageSetup BP @@ -1643,7 +1643,7 @@ F F1($0)2.751 E F0 2.751(;s)C(ee)-2.751 E .041 (f)-5.216 E F1 -.3(BA)2.716 G(SH_ARGV0).3 E F0 .216 (is unset, it loses its special properties, e)2.716 F -.15(ve)-.25 G 2.716(ni).15 G(f)-2.716 E(it is subsequently reset.)144 705.6 Q -(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(11)185.115 E 0 Cg EP +(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(11)188.455 E 0 Cg EP %%Page: 12 12 %%BeginPageSetup BP @@ -1748,7 +1748,7 @@ H(he current completion function.).1 E F1(COMP_LINE)108 690 Q F0 1.208 (yt)-3.537 G 1.037(he programmable completion f)-3.537 F 1.037 (acilities \(see)-.1 F F1(Pr)3.537 E 1.037(ogrammable Completion)-.18 F F0(be-)3.537 E(lo)144 726 Q(w\).)-.25 E(GNU Bash 5.2)72 768 Q -(2022 September 19)135.955 E(12)185.115 E 0 Cg EP +(2022 December 2)139.295 E(12)188.455 E 0 Cg EP %%Page: 13 13 %%BeginPageSetup BP @@ -1871,8 +1871,8 @@ F1(]})A F0 -.1(wa)2.512 G 2.512(sc).1 G .012(alled from the \214le) (at line number)144 702 R F1(${B)3.684 E(ASH_LINENO[)-.3 E F2($i)A F1 (]})A F0 6.184(.T)C(he)-6.184 E F1(caller)3.683 E F0 -.2(bu)3.683 G 1.183(iltin displays the current call stack using).2 F -(this information.)144 714 Q(GNU Bash 5.2)72 768 Q(2022 September 19) -135.955 E(13)185.115 E 0 Cg EP +(this information.)144 714 Q(GNU Bash 5.2)72 768 Q(2022 December 2) +139.295 E(13)188.455 E 0 Cg EP %%Page: 14 14 %%BeginPageSetup BP @@ -1966,8 +1966,8 @@ F0 1.547(line b)4.047 F(uf)-.2 E(fer)-.25 E 4.047(,f)-.4 G 1.547 3.517 F(UIL)-.09 E 1.017(TIN COMMANDS)-.828 F F0(belo)3.267 E 3.516 (w\). The)-.25 F 1.016(characters between the insertion point and the) 3.516 F(mark are often called the)144 720 Q F3 -.37(re)2.5 G(gion)-.03 E -F0(.)A(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(14)185.115 E 0 -Cg EP +F0(.)A(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(14)188.455 E 0 Cg +EP %%Page: 15 15 %%BeginPageSetup BP @@ -2090,8 +2090,8 @@ E F0 3.748(command. This)3.748 F 1.247 (is a colon-separated list of directories in which the)3.748 F 3.795 (shell looks for destination directories speci\214ed by the)144 729.6 R F1(cd)6.295 E F0 6.296(command. A)6.296 F 3.796(sample v)6.296 F 3.796 -(alue is)-.25 F(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(15) -185.115 E 0 Cg EP +(alue is)-.25 F(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(15) +188.455 E 0 Cg EP %%Page: 16 16 %%BeginPageSetup BP @@ -2208,7 +2208,7 @@ A F2(HISTFILE)108 672 Q F0 .181 -.1 F(alue)-.25 E(is)144 696 Q F5(~/.bash_history)2.5 E F0 5(.I)C 2.5 (fu)-5 G(nset, the command history is not sa)-2.5 E -.15(ve)-.2 G 2.5 (dw).15 G(hen a shell e)-2.5 E(xits.)-.15 E(GNU Bash 5.2)72 768 Q -(2022 September 19)135.955 E(16)185.115 E 0 Cg EP +(2022 December 2)139.295 E(16)188.455 E 0 Cg EP %%Page: 17 17 %%BeginPageSetup BP @@ -2327,7 +2327,7 @@ E F0(\(see)4.426 E F2(READLINE)2.76 E F0(be-)2.51 E(lo)144 624 Q(w\).) (rrides the v).15 F .973(alue of)-.25 F F2(LANG)3.473 E F0 .973(and an) 3.223 F 3.473(yo)-.15 G(ther)-3.473 E F1(LC_)3.473 E F0 -.25(va)3.473 G .974(riable specifying a locale cate-).25 F(gory)144 720 Q(.)-.65 E -(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(17)185.115 E 0 Cg EP +(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(17)188.455 E 0 Cg EP %%Page: 18 18 %%BeginPageSetup BP @@ -2436,8 +2436,8 @@ E F0(and)3.423 E F1(\\W)3.423 E F0 .923(prompt string escapes \(see) -.15 F F2(PR)3.674 E(OMPTING)-.27 E F0(belo)3.424 E 1.174 (w\) and displayed by interacti)-.25 F -.15(ve)-.25 G (shells after reading a command and before the command is e)144 720 Q --.15(xe)-.15 G(cuted.).15 E(GNU Bash 5.2)72 768 Q(2022 September 19) -135.955 E(18)185.115 E 0 Cg EP +-.15(xe)-.15 G(cuted.).15 E(GNU Bash 5.2)72 768 Q(2022 December 2) +139.295 E(18)188.455 E 0 Cg EP %%Page: 19 19 %%BeginPageSetup BP @@ -2551,7 +2551,7 @@ E F0(belo)3.084 E 3.334(w\). If)-.25 F .834(set to an)3.334 F 3.334(yo) (must be a pre\214x of a stopped job')144 692.4 R 2.816(sn)-.55 G .316 (ame; this pro)-2.816 F .315(vides functionality analogous to the)-.15 F F1(%)2.815 E F3(string)A F0(job)2.815 E(identi\214er)144 704.4 Q(.)-.55 -E(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(19)185.115 E 0 Cg EP +E(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(19)188.455 E 0 Cg EP %%Page: 20 20 %%BeginPageSetup BP @@ -2703,7 +2703,7 @@ F .228(to the e)108 727.2 R .228(xpansion of the special parameters)-.15 F F1(*)2.728 E F0(and)2.728 E F1(@)2.728 E F0(\(see)2.728 E F1 .228 (Special P)2.728 F(arameters)-.1 E F0(abo)2.727 E -.15(ve)-.15 G 2.727 (\). ${#).15 F F3(name)A F0([)A F3(subscript)A F0(]})A(GNU Bash 5.2)72 -768 Q(2022 September 19)135.955 E(20)185.115 E 0 Cg EP +768 Q(2022 December 2)139.295 E(20)188.455 E 0 Cg EP %%Page: 21 21 %%BeginPageSetup BP @@ -2853,7 +2853,7 @@ F .719(The results of each e)5.719 F .719 F2(]})A F0 3.149(,w)C(here)-3.149 E F1(x)3.149 E F0(and)3.149 E F1(y) 3.149 E F0 .649(are either inte)3.149 F .649 (gers or single letters, and)-.15 F(GNU Bash 5.2)72 768 Q -(2022 September 19)135.955 E(21)185.115 E 0 Cg EP +(2022 December 2)139.295 E(21)188.455 E 0 Cg EP %%Page: 22 22 %%BeginPageSetup BP @@ -2991,7 +2991,7 @@ E -.855(AT)-.666 G(H).855 E F4(,)A F0(and)2.25 E F3(CDP)2.5 E -.855(AT) (the v)108 724.8 R .415(ariable to be e)-.25 F .415 (xpanded from characters immediately follo)-.15 F .414 (wing it which could be interpreted as part of)-.25 F(GNU Bash 5.2)72 -768 Q(2022 September 19)135.955 E(22)185.115 E 0 Cg EP +768 Q(2022 December 2)139.295 E(22)188.455 E 0 Cg EP %%Page: 23 23 %%BeginPageSetup BP @@ -3125,8 +3125,8 @@ E F1(@)3.284 E F0(or)3.284 E F1(*)3.284 E F0 3.284(,t)C .784 (en relati)-.1 F 1.851 -.15(ve t)-.25 H 4.051(oo).15 G 1.551 (ne greater than the greatest positional parameter)-4.051 F 4.051(,s)-.4 G 4.052(oa)-4.051 G 4.052(no)-4.052 G -.25(ff)-4.052 G 1.552 -(set of \2551).25 F(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E -(23)185.115 E 0 Cg EP +(set of \2551).25 F(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(23) +188.455 E 0 Cg EP %%Page: 24 24 %%BeginPageSetup BP @@ -3255,7 +3255,7 @@ H 3.314(ft).65 G .814(he pattern matches a trailing portion of the e) (,)A .423(the pattern remo)144 708 R -.25(va)-.15 G 2.923(lo).25 G .422 (peration is applied to each member of the array in turn, and the e) -2.923 F .422(xpansion is)-.15 F(the resultant list.)144 720 Q -(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(24)185.115 E 0 Cg EP +(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(24)188.455 E 0 Cg EP %%Page: 25 25 %%BeginPageSetup BP @@ -3389,7 +3389,7 @@ F F1(par)3.36 E(ameter)-.15 E F0 .153(or information about)144 705.6 R F1(par)2.653 E(ameter)-.15 E F0 .153(itself, depending on the v)2.653 F .153(alue of)-.25 F F1(oper)2.653 E(ator)-.15 E F0 5.154(.E)C(ach)-5.154 E F1(oper)2.654 E(ator)-.15 E F0 .154(is a sin-)2.654 F(gle letter:)144 -717.6 Q(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(25)185.115 E 0 +717.6 Q(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(25)188.455 E 0 Cg EP %%Page: 26 26 %%BeginPageSetup @@ -3495,7 +3495,7 @@ F2 -.2(ex)2.735 G(pr).2 E(ession)-.37 E F0(under)2.975 E .235 .2 E(ession)-.37 E F0 2.799(are not treated specially and are remo)5.3 F -.15(ve)-.15 G 5.299(d. All).15 F(tok)5.299 E 2.799(ens in the e)-.1 F 2.799(xpression under)-.15 F(go)-.18 E(GNU Bash 5.2)72 768 Q -(2022 September 19)135.955 E(26)185.115 E 0 Cg EP +(2022 December 2)139.295 E(26)188.455 E 0 Cg EP %%Page: 27 27 %%BeginPageSetup BP @@ -3651,7 +3651,7 @@ F 1.041(ut in other)-.2 F .132(matching conte)108 674.4 R .132 F F3(pattern)3.811 E F0 5.061(.I).24 G(f)-5.061 E F1(GLO-)2.561 E (BIGNORE)108 727.2 Q F0 2.015(is set, each matching \214le name that al\ so matches one of the patterns in)4.264 F F1(GLOBIGNORE)4.515 E F0(is) -4.265 E(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(27)185.115 E 0 +4.265 E(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(27)188.455 E 0 Cg EP %%Page: 28 28 %%BeginPageSetup @@ -3769,8 +3769,8 @@ R .038(In the follo)5.038 F .038(wing description, a)-.25 F F4 678 Q -.15(ve)-.25 G 2.5(np).15 G(atterns)-2.5 E F1(+\()144 690 Q F4 (pattern-list).833 E F1(\)).833 E F0 (Matches one or more occurrences of the gi)180 702 Q -.15(ve)-.25 G 2.5 -(np).15 G(atterns)-2.5 E(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 -E(28)185.115 E 0 Cg EP +(np).15 G(atterns)-2.5 E(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E +(28)188.455 E 0 Cg EP %%Page: 29 29 %%BeginPageSetup BP @@ -3781,10 +3781,10 @@ SF(@\()144 84 Q/F2 10/Times-Italic@0 SF(pattern-list).833 E F1(\)).833 E F0(Matches one of the gi)180 96 Q -.15(ve)-.25 G 2.5(np).15 G(atterns) -2.5 E F1(!\()144 108 Q F2(pattern-list).833 E F1(\)).833 E F0 (Matches an)180 120 Q(ything e)-.15 E(xcept one of the gi)-.15 E -.15 -(ve)-.25 G 2.5(np).15 G(atterns)-2.5 E(The)108 136.8 Q F1(extglob)A F0 -.477(option changes the beha)2.977 F .477(vior of the parser)-.2 F 2.977 -(,s)-.4 G .478(ince the parentheses are normally treated as opera-) --2.977 F .105(tors with syntactic meaning.)108 148.8 R 1.705 -.8(To e) +(ve)-.25 G 2.5(np).15 G(atterns)-2.5 E(The)108 136.8 Q F1(extglob)2.791 +E F0 .291(option changes the beha)2.791 F .291(vior of the parser)-.2 F +2.791(,s)-.4 G .292(ince the parentheses are normally treated as opera-) +-2.791 F .105(tors with syntactic meaning.)108 148.8 R 1.705 -.8(To e) 5.105 H .105(nsure that e).8 F .105 (xtended matching patterns are parsed correctly)-.15 F 2.604(,m)-.65 G (ak)-2.604 E 2.604(es)-.1 G .104(ure that)-2.604 F F1(extglob)108 160.8 @@ -3886,7 +3886,7 @@ F2(dirlist)2.85 E F0(.).68 E F1(Bash)108 691.2 Q F0 .598(handles se) (vides these special \214les, bash will use them;)-.15 F (otherwise it will emulate them internally with the beha)108 715.2 Q (vior described belo)-.2 E -.65(w.)-.25 G(GNU Bash 5.2)72 768 Q -(2022 September 19)135.955 E(29)185.115 E 0 Cg EP +(2022 December 2)139.295 E(29)188.455 E 0 Cg EP %%Page: 30 30 %%BeginPageSetup BP @@ -3972,8 +3972,8 @@ F2(n)A F0(])A F1(>>)A F2(wor)A(d)-.37 E F1(Redir)87 602.4 Q A(d)-.37 E F0(Of the tw)108 700.8 Q 2.5(of)-.1 G (orms, the \214rst is preferred.)-2.5 E(This is semantically equi)5 E -.25(va)-.25 G(lent to).25 E F1(>)144 717.6 Q F2(wor)A(d)-.37 E F0(2)2.5 -E F1(>&)A F0(1)A(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(30) -185.115 E 0 Cg EP +E F1(>&)A F0(1)A(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(30) +188.455 E 0 Cg EP %%Page: 31 31 %%BeginPageSetup BP @@ -4070,7 +4070,7 @@ F0 2.65<2c8c>C .15(le descriptor)-2.65 F F1(n)3.01 E F0 .15(is closed.) 3.465 E F0 3.466(,t)C .966 (he standard output and standard error are redirected as described) -3.466 F(pre)108 720 Q(viously)-.25 E(.)-.65 E(GNU Bash 5.2)72 768 Q -(2022 September 19)135.955 E(31)185.115 E 0 Cg EP +(2022 December 2)139.295 E(31)188.455 E 0 Cg EP %%Page: 32 32 %%BeginPageSetup BP @@ -4192,8 +4192,8 @@ F .639(function is e)108 708 R -.15(xe)-.15 G .639(cuted, the ar).15 F -.18 F -.15(xe)-.15 G(cution.).15 E 1.659(The special parameter)108 720 R F1(#)4.159 E F0 1.659(is updated to re\215ect the change.)4.159 F 1.659(Special parameter)6.659 F F1(0)4.159 E F0 1.658(is unchanged.) -4.158 F 1.658(The \214rst)6.658 F(GNU Bash 5.2)72 768 Q -(2022 September 19)135.955 E(32)185.115 E 0 Cg EP +4.158 F 1.658(The \214rst)6.658 F(GNU Bash 5.2)72 768 Q(2022 December 2) +139.295 E(32)188.455 E 0 Cg EP %%Page: 33 33 %%BeginPageSetup BP @@ -4333,8 +4333,8 @@ S(iltin.).2 E .371(Functions may be recursi)108 676.8 R -.15(ve)-.25 G (stack and restrict the number of function in)108 688.8 R -.2(vo)-.4 G 2.822(cations. By).2 F(def)2.822 E .322 (ault, no limit is imposed on the number of re-)-.1 F(cursi)108 700.8 Q -.3 -.15(ve c)-.25 H(alls.).15 E(GNU Bash 5.2)72 768 Q(2022 September 19) -135.955 E(33)185.115 E 0 Cg EP +.3 -.15(ve c)-.25 H(alls.).15 E(GNU Bash 5.2)72 768 Q(2022 December 2) +139.295 E(33)188.455 E 0 Cg EP %%Page: 34 34 %%BeginPageSetup BP @@ -4435,7 +4435,7 @@ F2(test)2.633 E F0(and)2.633 E F2([)2.633 E F0 .133 (vior based on the number of ar)-.2 F .198 (guments; see the descriptions of those commands for an)-.18 F 2.698(yo) -.15 G .198(ther command-)-2.698 F(speci\214c actions.)108 720 Q -(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(34)185.115 E 0 Cg EP +(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(34)188.455 E 0 Cg EP %%Page: 35 35 %%BeginPageSetup BP @@ -4537,7 +4537,7 @@ F F2(optname)2.992 E F0 .262(is enabled.)2.942 F .262 F0(is zero.)2.5 E F2(string)108 658.8 Q F1108 670.8 Q F2(string) 2.5 E F0 -.35(Tr)144 682.8 S(ue if the length of).35 E F2(string)2.84 E F0(is non-zero.)2.72 E F2(string1)108 699.6 Q F1(==)2.5 E F2(string2)2.5 -E F0(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(35)185.115 E 0 Cg +E F0(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(35)188.455 E 0 Cg EP %%Page: 36 36 %%BeginPageSetup @@ -4647,7 +4647,7 @@ mpts to locate it.)108 655.2 R .379(If there e)5.379 F .379 720 R -.15(xe)-.15 G 1.915(cutable \214les \(see).15 F F2(hash)4.415 E F0(under)4.415 E F3 1.915(SHELL B)4.415 F(UIL)-.09 E 1.915(TIN COMMANDS) -.828 F F0(belo)4.165 E 4.415(w\). A)-.25 F(full)4.415 E(GNU Bash 5.2)72 -768 Q(2022 September 19)135.955 E(36)185.115 E 0 Cg EP +768 Q(2022 December 2)139.295 E(36)188.455 E 0 Cg EP %%Page: 37 37 %%BeginPageSetup BP @@ -4755,7 +4755,7 @@ F1(PPID)2.5 E F0 .426(When a simple command other than a b)108 552 R (fect the shell')-.25 E 2.5(se)-.55 G -.15(xe)-2.65 G(cution en).15 E (vironment.)-.4 E(A)108 729.6 Q F3(subshell)2.5 E F0(is a cop)2.5 E 2.5 (yo)-.1 G 2.5(ft)-2.5 G(he shell process.)-2.5 E(GNU Bash 5.2)72 768 Q -(2022 September 19)135.955 E(37)185.115 E 0 Cg EP +(2022 December 2)139.295 E(37)188.455 E 0 Cg EP %%Page: 38 38 %%BeginPageSetup BP @@ -4885,7 +4885,7 @@ Q(xits with a non-zero v)-.15 E 2.5(alue. See)-.25 F(also the)2.5 E F1 -.15(ve s)-.25 H .915(hell\), and).15 F F4(SIGINT)3.415 E F0 .915 (is caught and handled \(so that the)3.165 F F1(wait)3.415 E F0 -.2(bu) 3.416 G .916(iltin is interruptible\).).2 F .916(In all cases,)5.916 F -(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(38)185.115 E 0 Cg EP +(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(38)188.455 E 0 Cg EP %%Page: 39 39 %%BeginPageSetup BP @@ -5019,7 +5019,7 @@ F .146(group ID dif)108 698.4 R .146(fers from the terminal')-.25 F .146 -2.66 F(-)-.2 E 3.052(minal. Background)108 722.4 R .551 (processes which attempt to read from \(write to when)3.052 F F6 .551 (stty tostop)3.051 F F0 .551(is in ef)3.051 F .551(fect\) the)-.25 F -(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(39)185.115 E 0 Cg EP +(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(39)188.455 E 0 Cg EP %%Page: 40 40 %%BeginPageSetup BP @@ -5153,7 +5153,7 @@ as follo)108 609.6 Q(ws:)-.25 E F2(\\a)144 621.6 Q F0 (the hostname up to the \214rst `.)180 693.6 Q(')-.7 E F2(\\H)144 705.6 Q F0(the hostname)180 705.6 Q F2(\\j)144 717.6 Q F0 (the number of jobs currently managed by the shell)180 717.6 Q -(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(40)185.115 E 0 Cg EP +(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(40)188.455 E 0 Cg EP %%Page: 41 41 %%BeginPageSetup BP @@ -5272,8 +5272,8 @@ F0 .463(In this section, the Emacs-style notation is used to denote k) -.15 F .567(which can be yank)108 696 R .567(ed all at once.)-.1 F .567 (Commands which do not kill te)5.567 F .567 (xt separate the chunks of te)-.15 F .567(xt on the kill)-.15 F(ring.) -108 708 Q(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(41)185.115 E -0 Cg EP +108 708 Q(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(41)188.455 E 0 +Cg EP %%Page: 42 42 %%BeginPageSetup BP @@ -5374,7 +5374,7 @@ G(rsal\255ar).1 E(gument)-.1 E F0(.)A F2 .315(C\255x C\255r)5.155 F F0 144 676.8 Q F0(meta pre\214x)180 676.8 Q F1(\\e)144 688.8 Q F0 (an escape character)180 688.8 Q F1(\\\\)144 700.8 Q F0(backslash)180 700.8 Q F1(\\")144 712.8 Q F0(literal ")180 712.8 Q(GNU Bash 5.2)72 768 -Q(2022 September 19)135.955 E(42)185.115 E 0 Cg EP +Q(2022 December 2)139.295 E(42)188.455 E 0 Cg EP %%Page: 43 43 %%BeginPageSetup BP @@ -5485,8 +5485,8 @@ E F0 2.51(,r)C .01(eadline ne)-2.51 F -.15(ve)-.25 G(r).15 E .94 s to bind the control characters treated specially by the k)-2.556 F (ernel')-.1 E 2.555(st)-.55 G(ermi-)-2.555 E(nal dri)144 705.6 Q -.15 (ve)-.25 G 2.5(rt).15 G 2.5(ot)-2.5 G(heir readline equi)-2.5 E -.25(va) --.25 G(lents.).25 E(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E -(43)185.115 E 0 Cg EP +-.25 G(lents.).25 E(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(43) +188.455 E 0 Cg EP %%Page: 44 44 %%BeginPageSetup BP @@ -5594,7 +5594,7 @@ R -.15(ve)-.25 G 5.622(.T).15 G .622(he v)-5.622 F .621(alue is e)-.25 F .621(xpanded lik)-.15 F 3.121(ea)-.1 G -.1(ke)144 720 S 3.339(yb)-.05 G .839(inding, so the standard set of meta- and control pre\214x)-3.339 F .84(es and backslash escape sequences is)-.15 F(GNU Bash 5.2)72 768 Q -(2022 September 19)135.955 E(44)185.115 E 0 Cg EP +(2022 December 2)139.295 E(44)188.455 E 0 Cg EP %%Page: 45 45 %%BeginPageSetup BP @@ -5715,7 +5715,7 @@ F2 -.37(re)2.867 G(adline).37 E F0 .367(will w)2.867 F .367 1.106 -.15(ey s)-.1 H 3.306(equence\). If).15 F .806(no input is recei) 3.306 F -.15(ve)-.25 G 3.306(dw).15 G .807(ithin the timeout,)-3.306 F F2 -.37(re)3.307 G(adline).37 E F0(will)3.307 E(GNU Bash 5.2)72 768 Q -(2022 September 19)135.955 E(45)185.115 E 0 Cg EP +(2022 December 2)139.295 E(45)188.455 E 0 Cg EP %%Page: 46 46 %%BeginPageSetup BP @@ -5825,8 +5825,8 @@ the completion that match characters after point in the w)144 660 R (The v)5.475 F(alue)-.25 E 1.235(is e)144 720 R 1.235(xpanded lik)-.15 F 3.735(eak)-.1 G 1.535 -.15(ey b)-3.835 H 1.236 (inding, so the standard set of meta- and control pre\214x).15 F 1.236 -(es and backslash)-.15 F(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 -E(46)185.115 E 0 Cg EP +(es and backslash)-.15 F(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E +(46)188.455 E 0 Cg EP %%Page: 47 47 %%BeginPageSetup BP @@ -5932,8 +5932,8 @@ or by whitespace; the operator may be separated from)180 693.6 R .13 .129(Both string and boolean v)5.129 F .129(ariables may be)-.25 F (tested. Boolean v)180 717.6 Q(ariables must be tested ag)-.25 E (ainst the v)-.05 E(alues)-.25 E F2(on)2.5 E F0(and)2.5 E F2(of)2.5 E(f) --.18 E F0(.)A(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(47) -185.115 E 0 Cg EP +-.18 E F0(.)A(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(47)188.455 +E 0 Cg EP %%Page: 48 48 %%BeginPageSetup BP @@ -6028,8 +6028,8 @@ E(beginning\255of\255line \(C\255a\))108 511.2 Q F0(Mo)144 523.2 Q .3 Q(orward\255w)-.25 E(ord)-.1 E F0(Mo)144 691.2 Q .784 -.15(ve f)-.15 H (orw).15 E .484(ard to the end of the ne)-.1 F .484(xt w)-.15 F 2.984 (ord. W)-.1 F .484(ords are delimited by non-quoted shell metacharac-) --.8 F(ters.)144 703.2 Q(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 -E(48)185.115 E 0 Cg EP +-.8 F(ters.)144 703.2 Q(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E +(48)188.455 E 0 Cg EP %%Page: 49 49 %%BeginPageSetup BP @@ -6118,8 +6118,8 @@ sing a non-incremental search for)-.1 F 2.5(as)144 664.8 S (emental\255f)-.18 E(orward\255sear)-.25 E(ch\255history \(M\255n\))-.18 E F0 1.353(Search forw)144 688.8 R 1.354(ard through the history using \ a non-incremental search for a string supplied by the)-.1 F(user)144 -700.8 Q(.)-.55 E(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(49) -185.115 E 0 Cg EP +700.8 Q(.)-.55 E(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(49) +188.455 E 0 Cg EP %%Page: 50 50 %%BeginPageSetup BP @@ -6222,7 +6222,7 @@ R .799(xample, by)-.15 F/F5 10/Courier@0 SF(stty)3.299 E F0 5.799(.I)C (there are no characters on the line, and point is at the be)144 688.8 R .167(ginning of the line, readline interprets it as)-.15 F (the end of input and returns)144 700.8 Q F3(EOF)2.5 E F4(.)A F0 -(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(50)185.115 E 0 Cg EP +(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(50)188.455 E 0 Cg EP %%Page: 51 51 %%BeginPageSetup BP @@ -6317,7 +6317,7 @@ Q(ard from point to the be)-.1 E(ginning of the line.)-.15 E (ord \(M\255Rubout\))-.1 E F0(Kill the w)144 712.8 Q(ord behind point.) -.1 E -.8(Wo)5 G(rd boundaries are the same as those used by).8 E F1 (backward\255w)2.5 E(ord)-.1 E F0(.)A(GNU Bash 5.2)72 768 Q -(2022 September 19)135.955 E(51)185.115 E 0 Cg EP +(2022 December 2)139.295 E(51)188.455 E 0 Cg EP %%Page: 52 52 %%BeginPageSetup BP @@ -6412,7 +6412,7 @@ F .929(ord to be completed with a single match from the list of)-.1 F 1.193(possible completions.)144 729.6 R 1.193(Repeated e)6.193 F -.15 (xe)-.15 G 1.193(cution of).15 F F1(menu\255complete)3.694 E F0 1.194 (steps through the list of possible)3.694 F(GNU Bash 5.2)72 768 Q -(2022 September 19)135.955 E(52)185.115 E 0 Cg EP +(2022 December 2)139.295 E(52)188.455 E 0 Cg EP %%Page: 53 53 %%BeginPageSetup BP @@ -6506,8 +6506,8 @@ E F0(Re-e)144 664.8 Q -.15(xe)-.15 G .999(cute the last k).15 F -.15(ey) E F1(print\255last\255kbd\255macr)108 688.8 Q 2.5(o\()-.18 G(\))-2.5 E F0(Print the last k)144 700.8 Q -.15(ey)-.1 G (board macro de\214ned in a format suitable for the).15 E F2(inputr)2.5 -E(c)-.37 E F0(\214le.)2.5 E(GNU Bash 5.2)72 768 Q(2022 September 19) -135.955 E(53)185.115 E 0 Cg EP +E(c)-.37 E F0(\214le.)2.5 E(GNU Bash 5.2)72 768 Q(2022 December 2) +139.295 E(53)188.455 E 0 Cg EP %%Page: 54 54 %%BeginPageSetup BP @@ -6611,7 +6611,7 @@ ssible completions.)2.5 E F1(glob\255expand\255w)108 696 Q (names is inserted, replacing the w)144 720 R 3.016(ord. If)-.1 F 3.016 (an)3.016 G .516(umeric ar)-3.016 F .516 (gument is supplied, an asterisk is appended)-.18 F(GNU Bash 5.2)72 768 -Q(2022 September 19)135.955 E(54)185.115 E 0 Cg EP +Q(2022 December 2)139.295 E(54)188.455 E 0 Cg EP %%Page: 55 55 %%BeginPageSetup BP @@ -6738,7 +6738,7 @@ F0(and)2.734 E F12.734 E F0(op-)2.734 E 4.209(tions is in)108 R .628(ord preceding the w)-.1 F .629 (ord being completed on the current command line.)-.1 F .629 (No \214ltering of the generated)5.629 F(GNU Bash 5.2)72 768 Q -(2022 September 19)135.955 E(55)185.115 E 0 Cg EP +(2022 December 2)139.295 E(55)188.455 E 0 Cg EP %%Page: 56 56 %%BeginPageSetup BP @@ -6865,7 +6865,7 @@ E/F3 10/Courier@0 SF(_completion_loader\(\))108 604.8 Q({)108 616.8 Q 6 (stores each command in the history list prior to parameter and v)108 729.6 R .287(ariable e)-.25 F .287(xpansion \(see)-.15 F F2(EXP)2.787 E (ANSION)-.666 E F0(abo)2.537 E -.15(ve)-.15 G(\)).15 E(GNU Bash 5.2)72 -768 Q(2022 September 19)135.955 E(56)185.115 E 0 Cg EP +768 Q(2022 December 2)139.295 E(56)188.455 E 0 Cg EP %%Page: 57 57 %%BeginPageSetup BP @@ -7009,7 +7009,7 @@ F0(will also inhibit e)108 705.6 Q(xpansion.)-.15 E(Se)108 722.4 Q -.15 (ve)-.25 G .109(ral shell options settable with the).15 F F4(shopt)2.609 E F0 -.2(bu)2.609 G .11(iltin may be used to tailor the beha).2 F .11 (vior of history e)-.2 F(xpansion.)-.15 E(GNU Bash 5.2)72 768 Q -(2022 September 19)135.955 E(57)185.115 E 0 Cg EP +(2022 December 2)139.295 E(57)188.455 E 0 Cg EP %%Page: 58 58 %%BeginPageSetup BP @@ -7124,8 +7124,8 @@ E(If a w)108 676.8 Q(ord designator is supplied without an e)-.1 E -.15 (wing modi\214ers,)-.25 F(each preceded by a `:'.)108 717.6 Q (These modify)5 E 2.5(,o)-.65 G 2.5(re)-2.5 G(dit, the w)-2.5 E (ord or w)-.1 E(ords selected from the history e)-.1 E -.15(ve)-.25 G -(nt.).15 E(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(58)185.115 -E 0 Cg EP +(nt.).15 E(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(58)188.455 E +0 Cg EP %%Page: 59 59 %%BeginPageSetup BP @@ -7270,7 +7270,7 @@ F 1.313(plied, the name and v)144 692.4 R 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 (which no alias has been de\214ned.)144 704.4 Q(GNU Bash 5.2)72 768 Q -(2022 September 19)135.955 E(59)185.115 E 0 Cg EP +(2022 December 2)139.295 E(59)188.455 E 0 Cg EP %%Page: 60 60 %%BeginPageSetup BP @@ -7391,7 +7391,7 @@ E F1(br)108 698.4 Q(eak)-.18 E F0([)2.5 E F2(n)A F0(])A .054 E F0(1.)2.555 E(If)144 722.4 Q F2(n)3.075 E F0 .215(is greater than the\ number of enclosing loops, all enclosing loops are e)2.955 F 2.714 (xited. The)-.15 F .214(return v)2.714 F(alue)-.25 E(GNU Bash 5.2)72 768 -Q(2022 September 19)135.955 E(60)185.115 E 0 Cg EP +Q(2022 December 2)139.295 E(60)188.455 E 0 Cg EP %%Page: 61 61 %%BeginPageSetup BP @@ -7534,7 +7534,7 @@ E .352(The matches will be generated in the same w)144 708 R .352 (ay as if the programmable completion code had gen-)-.1 F .02(erated th\ em directly from a completion speci\214cation with the same \215ags.)144 720 R(If)5.02 E F1(wor)2.52 E(d)-.37 E F0 .02(is speci\214ed, only)2.52 -F(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(61)185.115 E 0 Cg EP +F(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(61)188.455 E 0 Cg EP %%Page: 62 62 %%BeginPageSetup BP @@ -7640,8 +7640,8 @@ letions alphabetically).7 E(.)-.65 E F2(nospace)184 616.8 Q F0 -.7(Te) (action)2.5 E F0(may be one of the follo)2.5 E (wing to generate a list of possible completions:)-.25 E F2(alias)184 700.8 Q F0(Alias names.)224 700.8 Q(May also be speci\214ed as)5 E F2 -2.5 E F0(.)A(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(62) -185.115 E 0 Cg EP +2.5 E F0(.)A(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(62) +188.455 E 0 Cg EP %%Page: 63 63 %%BeginPageSetup BP @@ -7727,7 +7727,7 @@ F .981(quoting is honored within)3.481 F F3(wor)3.481 E(dlist)-.37 E F0 A F0 1.964 (The possible completions are the members of the resultant list which) 6.464 F(match the w)184 720 Q(ord being completed.)-.1 E(GNU Bash 5.2)72 -768 Q(2022 September 19)135.955 E(63)185.115 E 0 Cg EP +768 Q(2022 December 2)139.295 E(63)188.455 E 0 Cg EP %%Page: 64 64 %%BeginPageSetup BP @@ -7870,7 +7870,7 @@ Q F0(Gi)180 715.2 Q 1.62 -.15(ve e)-.25 H(ach).15 E F2(name)3.82 E F0 1.518(That other v)180 727.2 R 1.518(ariable is de\214ned by the v)-.25 F 1.519(alue of)-.25 F F2(name)4.019 E F0 6.519(.A)C 1.519 (ll references, assignments, and)-6.519 F(GNU Bash 5.2)72 768 Q -(2022 September 19)135.955 E(64)185.115 E 0 Cg EP +(2022 December 2)139.295 E(64)188.455 E 0 Cg EP %%Page: 65 65 %%BeginPageSetup BP @@ -8002,7 +8002,7 @@ F .307(If the)5.308 F F22.807 E F0 .307(option is gi)2.807 F -.15 (xpg_echo)144 720 Q F0 .601 (shell option may be used to dynamically determine whether or not)3.101 F F2(echo)3.102 E F0 -.15(ex)3.102 G .602(pands these).15 F -(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(65)185.115 E 0 Cg EP +(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(65)188.455 E 0 Cg EP %%Page: 66 66 %%BeginPageSetup BP @@ -8125,8 +8125,8 @@ F -.15(xe)-.15 G 3.32(cuted. A).15 F .82(subshell e)3.32 F .82 -2.788 F 2.788(ee)-.1 G -.25(ff)-2.788 G .288(ect in the current shell,) .25 F(and the return status is 0.)144 710.4 Q (If there is a redirection error)5 E 2.5(,t)-.4 G -(he return status is 1.)-2.5 E(GNU Bash 5.2)72 768 Q(2022 September 19) -135.955 E(66)185.115 E 0 Cg EP +(he return status is 1.)-2.5 E(GNU Bash 5.2)72 768 Q(2022 December 2) +139.295 E(66)188.455 E 0 Cg EP %%Page: 67 67 %%BeginPageSetup BP @@ -8269,7 +8269,7 @@ F1(getopts)108 631.2 Q F2(optstring name)2.5 E F0([)2.5 E F2(ar)A 2.5 (the v)144 727.2 R(ariable)-.25 E F3(OPT)3.067 E(ARG)-.81 E F5(.)A F0 .566(The shell does not reset)5.067 F F3(OPTIND)3.066 E F0 .566 (automatically; it must be manually reset)2.816 F(GNU Bash 5.2)72 768 Q -(2022 September 19)135.955 E(67)185.115 E 0 Cg EP +(2022 December 2)139.295 E(67)188.455 E 0 Cg EP %%Page: 68 68 %%BeginPageSetup BP @@ -8378,7 +8378,7 @@ F F3(n)3.24 E F0 .38(lists only the last)3.12 F F3(n)3.24 E F0 2.88 2.88 E(MA)144 727.2 Q(T)-.855 E F0 1.491 (is set and not null, it is used as a format string for)3.741 F F3 (strftime)3.992 E F0 1.492(\(3\) to display the time stamp)B -(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(68)185.115 E 0 Cg EP +(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(68)188.455 E 0 Cg EP %%Page: 69 69 %%BeginPageSetup BP @@ -8504,7 +8504,7 @@ F1 -.2(ex)2.619 G(it_status).2 E F0(ar)2.619 E(-)-.2 E .799(gument to) (The)5.962 E F33.462 E F0 .962(option is equi)3.462 F -.25(va)-.25 G .962(lent to).25 F F33.462 E F0(.)A F3(kill)5.962 E F0 .962 (returns true if at least one signal w)3.462 F(as)-.1 E(GNU Bash 5.2)72 -768 Q(2022 September 19)135.955 E(69)185.115 E 0 Cg EP +768 Q(2022 December 2)139.295 E(69)188.455 E 0 Cg EP %%Page: 70 70 %%BeginPageSetup BP @@ -8643,7 +8643,7 @@ F F1(popd)2.594 E F0(uses)2.594 E(the)144 703.2 Q F1(cd)2.697 E F0 -.2 (iltin to change to the directory at the top of the stack.).2 F .196 (If the)5.196 F F1(cd)2.696 E F0 -.1(fa)2.696 G(ils,).1 E F1(popd)2.696 E F0 .196(returns a non-)2.696 F(zero v)144 715.2 Q(alue.)-.25 E -(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(70)185.115 E 0 Cg EP +(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(70)188.455 E 0 Cg EP %%Page: 71 71 %%BeginPageSetup BP @@ -8755,7 +8755,7 @@ F1(cd)2.5 E F0 -.1(fa)2.5 G(ils,).1 E F1(pushd)2.5 E F0 (returns 0 unless the directory stack is empty)4.28 F(.)-.65 E .881 (When rotating the directory stack,)144 722.4 R F1(pushd)3.381 E F0 .881 (returns 0 unless the directory stack is empty or a non-)3.381 F -(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(71)185.115 E 0 Cg EP +(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(71)188.455 E 0 Cg EP %%Page: 72 72 %%BeginPageSetup BP @@ -8881,7 +8881,7 @@ F0(seconds.)3.061 E F2(timeout)5.561 E F0 .561(may be a decimal number) .3 -.15(ve i)-.25 H(f).15 E F1 -.18(re)2.5 G(ad).18 E F0 .506(is readin\ g input from a terminal, pipe, or other special \214le; it has no ef)180 722.4 R .506(fect when reading)-.25 F(GNU Bash 5.2)72 768 Q -(2022 September 19)135.955 E(72)185.115 E 0 Cg EP +(2022 December 2)139.295 E(72)188.455 E 0 Cg EP %%Page: 73 73 %%BeginPageSetup BP @@ -9029,7 +9029,7 @@ F2 1.521(compound command)4.021 F F0(\(see)4.021 E F3 1.521 F1(&&)3.418 E F0(or)3.418 E F1(||)3.418 E F0 3.418(,a)C 1.218 -.15(ny c) -3.418 H .918(ommand in a pipeline b).15 F .917 (ut the last, or if the command')-.2 F 3.417(sr)-.55 G(eturn)-3.417 E -(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(73)185.115 E 0 Cg EP +(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(73)188.455 E 0 Cg EP %%Page: 74 74 %%BeginPageSetup BP @@ -9116,7 +9116,7 @@ E F0(.)A F1(noexec)184 678 Q F0(Same as)224 678 Q F12.5 E F0(.)A F1(noglob)184 690 Q F0(Same as)224 690 Q F12.5 E F0(.)A F1(nolog) 184 702 Q F0(Currently ignored.)224 702 Q F1(notify)184 714 Q F0 (Same as)224 714 Q F12.5 E F0(.)A(GNU Bash 5.2)72 768 Q -(2022 September 19)135.955 E(74)185.115 E 0 Cg EP +(2022 December 2)139.295 E(74)188.455 E 0 Cg EP %%Page: 75 75 %%BeginPageSetup BP @@ -9232,7 +9232,7 @@ F .531(ault when the shell is inter)-.1 F(-)-.2 E(acti)184 642 Q -.15 (cuted in a subshell en).15 F 4.432(vironment. The)-.4 F F1(DEB)4.432 E (UG)-.1 E F0(and)4.432 E F1(RETURN)184 726 Q F0 (traps are normally not inherited in such cases.)2.5 E(GNU Bash 5.2)72 -768 Q(2022 September 19)135.955 E(75)185.115 E 0 Cg EP +768 Q(2022 December 2)139.295 E(75)188.455 E 0 Cg EP %%Page: 76 76 %%BeginPageSetup BP @@ -9352,7 +9352,7 @@ E F0 .736(checks that a command found in the hash table e)3.237 F .736 (xists before trying to e)-.15 F -.15(xe)-.15 G(-).15 E(cute it.)184 718.8 Q(If a hashed command no longer e)5 E (xists, a normal path search is performed.)-.15 E(GNU Bash 5.2)72 768 Q -(2022 September 19)135.955 E(76)185.115 E 0 Cg EP +(2022 December 2)139.295 E(76)188.455 E 0 Cg EP %%Page: 77 77 %%BeginPageSetup BP @@ -9448,8 +9448,8 @@ F -.2(vo)-.4 G 1.081(cation, be-).2 F(ha)184 693.6 Q F1(declar)4.251 E(e)-.18 E F0 -.2(bu)4.251 G 1.751 (iltin displays the source \214le name and line).2 F (number corresponding to each function name supplied as an ar)220 722.4 -Q(gument.)-.18 E(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(77) -185.115 E 0 Cg EP +Q(gument.)-.18 E(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(77) +188.455 E 0 Cg EP %%Page: 78 78 %%BeginPageSetup BP @@ -9543,7 +9543,7 @@ G .575(he opportunity to re-edit a f)-3.075 F .575(ailed his-)-.1 F (nstead, the resulting line is loaded into the)-5.662 F F1 -.18(re)3.161 G(adline).18 E F0(editing)3.161 E -.2(bu)184 708 S -.25(ff).2 G(er).25 E 2.5(,a)-.4 G(llo)-2.5 E(wing further modi\214cation.)-.25 E -(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(78)185.115 E 0 Cg EP +(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(78)188.455 E 0 Cg EP %%Page: 79 79 %%BeginPageSetup BP @@ -9629,7 +9629,7 @@ ing in single quotes instead of)3.617 F(double quotes.)184 674.4 Q -.1(Pa)3.354 G .854(thname Expansion).1 F F0(abo)3.354 E -.15(ve)-.15 G 3.354(\)t).15 G(o)-3.354 E -.15(ex)184 715.2 S (pand to a null string, rather than themselv).15 E(es.)-.15 E -(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(79)185.115 E 0 Cg EP +(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(79)188.455 E 0 Cg EP %%Page: 80 80 %%BeginPageSetup BP @@ -9720,7 +9720,7 @@ F12.5 E F0(as signifying the end of options.)2.5 E .785 (Returns the v)180 690 R .26(alue of)-.25 F F3 -.2(ex)2.76 G(pr).2 E F0 5.26(.T)C .26(his may be used to o)-5.26 F -.15(ve)-.15 G .26 (rride the normal precedence of opera-).15 F(tors.)180 702 Q -(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(80)185.115 E 0 Cg EP +(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(80)188.455 E 0 Cg EP %%Page: 81 81 %%BeginPageSetup BP @@ -9797,673 +9797,677 @@ F0(or)2.5 E F2([)2.5 E F0 2.5(,t)C(he)-2.5 E F2(<)2.5 E F0(and)2.5 E F2 1.229(Print the accumulated user and system times for the shell and for\ processes run from the shell.)144 513.6 R(The return status is 0.)144 525.6 Q F2(trap)108 542.4 Q F0([)2.5 E F2(\255lp)A F0 2.5(][)C([)-2.5 E -F1(ar)A(g)-.37 E F0(])A F1(sigspec)2.5 E F0(...])2.5 E .682(The command) -144 554.4 R F1(ar)3.512 E(g)-.37 E F0 .682(is to be read and e)3.402 F --.15(xe)-.15 G .682(cuted when the shell recei).15 F -.15(ve)-.25 G -3.183(ss).15 G(ignal\(s\))-3.183 E F1(sigspec)3.523 E F0 5.683(.I).31 G -(f)-5.683 E F1(ar)3.513 E(g)-.37 E F0(is)3.403 E .609 -(absent \(and there is a single)144 566.4 R F1(sigspec)3.108 E F0 3.108 -(\)o)C(r)-3.108 E F23.108 E F0 3.108(,e)C .608 -(ach speci\214ed signal is reset to its original disposition)-3.108 F -.658(\(the v)144 578.4 R .658(alue it had upon entrance to the shell\).) --.25 F(If)5.658 E F1(ar)3.488 E(g)-.37 E F0 .659 -(is the null string the signal speci\214ed by each)3.378 F F1(sigspec) -144.34 590.4 Q F0 .581 -(is ignored by the shell and by the commands it in)3.391 F -.2(vo)-.4 G --.1(ke).2 G 3.08(s. If).1 F F1(ar)3.41 E(g)-.37 E F0 .58 -(is not present and)3.3 F F23.08 E F0(has)3.08 E 1.214 -(been supplied, then the trap commands associated with each)144 602.4 R -F1(sigspec)4.054 E F0 1.215(are displayed.)4.024 F 1.215(If no ar)6.215 -F(gu-)-.18 E .86(ments are supplied or if only)144 614.4 R F23.36 -E F0 .86(is gi)3.36 F -.15(ve)-.25 G(n,).15 E F2(trap)3.36 E F0 .86 -(prints the list of commands associated with each)3.36 F 2.83 -(signal. The)144 626.4 R F22.83 E F0 .33(option causes the shell \ -to print a list of signal names and their corresponding num-)2.83 F -4.311(bers. Each)144 638.4 R F1(sigspec)4.651 E F0 1.811 -(is either a signal name de\214ned in <)4.621 F F1(signal.h)A F0 1.81 -(>, or a signal number)B 6.81(.S)-.55 G(ignal)-6.81 E -(names are case insensiti)144 650.4 Q .3 -.15(ve a)-.25 H(nd the).15 E -F3(SIG)2.5 E F0(pre\214x is optional.)2.25 E .666(If a)144 668.4 R F1 -(sigspec)3.506 E F0(is)3.476 E F3(EXIT)3.166 E F0 .666 -(\(0\) the command)2.916 F F1(ar)3.496 E(g)-.37 E F0 .666(is e)3.386 F --.15(xe)-.15 G .666(cuted on e).15 F .667(xit from the shell.)-.15 F -.667(If a)5.667 F F1(sigspec)3.507 E F0(is)3.477 E F3(DE-)3.167 E -.09 -(BU)144 680.4 S(G).09 E F4(,)A F0 .484(the command)2.734 F F1(ar)3.314 E -(g)-.37 E F0 .484(is e)3.204 F -.15(xe)-.15 G .484(cuted before e).15 F --.15(ve)-.25 G(ry).15 E F1 .483(simple command)2.984 F F0(,)A F1(for) -2.983 E F0(command,)2.983 E F1(case)2.983 E F0(command,)2.983 E F1 -(select)144 692.4 Q F0 .562(command, e)3.062 F -.15(ve)-.25 G .563 -(ry arithmetic).15 F F1(for)3.063 E F0 .563 -(command, and before the \214rst command e)3.063 F -.15(xe)-.15 G .563 -(cutes in a shell).15 F .623(function \(see)144 704.4 R F3 .622 -(SHELL GRAMMAR)3.122 F F0(abo)2.872 E -.15(ve)-.15 G 3.122(\). Refer).15 -F .622(to the description of the)3.122 F F2(extdeb)3.122 E(ug)-.2 E F0 -.622(option to the)3.122 F F2(shopt)144 716.4 Q F0 -.2(bu)2.996 G .496 -(iltin for details of its ef).2 F .496(fect on the)-.25 F F2(DEB)2.996 E -(UG)-.1 E F0 2.996(trap. If)2.996 F(a)2.996 E F1(sigspec)3.336 E F0(is) -3.306 E F3(RETURN)2.996 E F4(,)A F0 .496(the command)2.746 F F1(ar) -144.33 728.4 Q(g)-.37 E F0 .18(is e)2.9 F -.15(xe)-.15 G .18 -(cuted each time a shell function or a script e).15 F -.15(xe)-.15 G .18 -(cuted with the).15 F F2(.)2.68 E F0(or)2.68 E F2(sour)2.68 E(ce)-.18 E -F0 -.2(bu)2.68 G .18(iltins \214nishes).2 F(GNU Bash 5.2)72 768 Q -(2022 September 19)135.955 E(81)185.115 E 0 Cg EP +F1(action)A F0(])A F1(sigspec)2.5 E F0(...])2.5 E(The)144 554.4 Q F1 +(action)3.733 E F0 .903(is a command that is read and e)3.643 F -.15(xe) +-.15 G .903(cuted when the shell recei).15 F -.15(ve)-.25 G 3.403(ss).15 +G(ignal\(s\))-3.403 E F1(sigspec)3.744 E F0 5.904(.I).31 G(f)-5.904 E F1 +(action)144.33 566.4 Q F0 .106(is absent \(and there is a single)2.846 F +F1(sigspec)2.605 E F0 2.605(\)o)C(r)-2.605 E F22.605 E F0 2.605(,e)C +.105(ach speci\214ed signal is reset to its original dis-)-2.605 F .626 +(position \(the v)144 578.4 R .626 +(alue it had upon entrance to the shell\).)-.25 F(If)5.626 E F1(action) +3.456 E F0 .626(is the null string the signal speci-)3.366 F +(\214ed by each)144 590.4 Q F1(sigspec)2.84 E F0 +(is ignored by the shell and by the commands it in)2.81 E -.2(vo)-.4 G +-.1(ke).2 G(s.).1 E .165(If no ar)144 608.4 R .165 +(guments are supplied,)-.18 F F2(trap)2.665 E F0 .165 +(displays the actions associated with each trapped signal as a set)2.665 +F(of)144 620.4 Q F2(trap)2.569 E F0 .069(commands that can be reused as\ + shell input to restore the current signal dispositions.)2.569 F(If)5.07 +E F22.57 E F0 .474(is gi)144 632.4 R -.15(ve)-.25 G .474(n, and) +.15 F F1(action)3.303 E F0 .473(is not present, then)3.213 F F2(trap) +2.973 E F0 .473(displays the actions associated with each)2.973 F F1 +(sigspec)3.313 E F0(or)3.283 E(,)-.4 E .363 +(if none are supplied, for all trapped signals, as a set of)144 644.4 R +F2(trap)2.864 E F0 .364(commands that can be reused as shell)2.864 F +(input to restore the current signal dispositions.)144 656.4 Q(The)144 +674.4 Q F23.217 E F0 .717(option causes)3.217 F F2(trap)3.217 E F0 +.716(to print a list of signal names and their corresponding numbers.) +3.216 F(Each)5.716 E F1(sigspec)144.34 686.4 Q F0 .709 +(is either a signal name de\214ned in <)3.518 F F1(signal.h)A F0 .709 +(>, or a signal number)B 5.709(.S)-.55 G .709(ignal names are case) +-5.709 F(insensiti)144 698.4 Q .3 -.15(ve a)-.25 H(nd the).15 E F3(SIG) +2.5 E F0(pre\214x is optional.)2.25 E .092(If a)144 716.4 R F1(sigspec) +2.932 E F0(is)2.902 E F3(EXIT)2.592 E F0 .092(\(0\) the command)2.342 F +F1(action)2.921 E F0 .091(is e)2.831 F -.15(xe)-.15 G .091(cuted on e) +.15 F .091(xit from the shell.)-.15 F .091(If a)5.091 F F1(sigspec)2.931 +E F0(is)2.901 E F3(DE-)2.591 E -.09(BU)144 728.4 S(G).09 E F4(,)A F0 +3.269(the command)5.518 F F1(action)6.099 E F0 3.269(is e)6.009 F -.15 +(xe)-.15 G 3.269(cuted before e).15 F -.15(ve)-.25 G(ry).15 E F1 3.269 +(simple command)5.769 F F0(,)A F1(for)5.769 E F0(command,)5.769 E F1 +(case)5.769 E F0(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(81) +188.455 E 0 Cg EP %%Page: 82 82 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S 137.14(SH\(1\) General).35 F -(Commands Manual)2.5 E -.35(BA)139.64 G(SH\(1\)).35 E -.15(exe)144 84 S -(cuting.).15 E .96(If a)144 102 R/F1 10/Times-Italic@0 SF(sigspec)3.8 E -F0(is)3.77 E/F2 9/Times-Bold@0 SF(ERR)3.46 E/F3 9/Times-Roman@0 SF(,)A -F0 .96(the command)3.21 F F1(ar)3.791 E(g)-.37 E F0 .961(is e)3.681 F --.15(xe)-.15 G .961(cuted whene).15 F -.15(ve)-.25 G 3.461(rap).15 G -.961(ipeline \(which may consist of a)-3.461 F .185(single simple comma\ -nd\), a list, or a compound command returns a non\255zero e)144 114 R -.184(xit status, subject to)-.15 F .451(the follo)144 126 R .451 -(wing conditions.)-.25 F(The)5.451 E F2(ERR)2.951 E F0 .451 -(trap is not e)2.701 F -.15(xe)-.15 G .451(cuted if the f).15 F .452 -(ailed command is part of the com-)-.1 F .388 -(mand list immediately follo)144 138 R .388(wing a)-.25 F/F4 10 -/Times-Bold@0 SF(while)2.888 E F0(or)2.888 E F4(until)2.888 E F0 -.1(ke) -2.888 G(yw)-.05 E .388(ord, part of the test in an)-.1 F F1(if)2.897 E -F0 .387(statement, part)4.847 F .777(of a command e)144 150 R -.15(xe) --.15 G .778(cuted in a).15 F F4(&&)3.278 E F0(or)3.278 E F4(||)3.278 E -F0 .778(list e)3.278 F .778(xcept the command follo)-.15 F .778 -(wing the \214nal)-.25 F F4(&&)3.278 E F0(or)3.278 E F4(||)3.278 E F0 -3.278(,a)C -.15(ny)-3.278 G 1.28(command in a pipeline b)144 162 R 1.28 +(Commands Manual)2.5 E -.35(BA)139.64 G(SH\(1\)).35 E(command,)144 84 Q +/F1 10/Times-Italic@0 SF(select)3.076 E F0 .575 +(command, \(\( arithmetic command, [[ conditional command, arithmetic) +3.076 F F1(for)3.075 E F0(com-)3.075 E .392 +(mand, and before the \214rst command e)144 96 R -.15(xe)-.15 G .393 +(cutes in a shell function \(see).15 F/F2 9/Times-Bold@0 SF .393 +(SHELL GRAMMAR)2.893 F F0(abo)2.643 E -.15(ve)-.15 G(\).).15 E .556 +(Refer to the description of the)144 108 R/F3 10/Times-Bold@0 SF(extdeb) +3.056 E(ug)-.2 E F0 .556(option to the)3.056 F F3(shopt)3.056 E F0 -.2 +(bu)3.056 G .556(iltin for details of its ef).2 F .556(fect on the)-.25 +F F3(DEB)144 120 Q(UG)-.1 E F0 2.514(trap. If)2.514 F(a)2.514 E F1 +(sigspec)2.854 E F0(is)2.824 E F2(RETURN)2.514 E/F4 9/Times-Roman@0 SF +(,)A F0 .014(the command)2.264 F F1(action)2.845 E F0 .015(is e)2.755 F +-.15(xe)-.15 G .015(cuted each time a shell function).15 F +(or a script e)144 132 Q -.15(xe)-.15 G(cuted with the).15 E F3(.)2.5 E +F0(or)2.5 E F3(sour)2.5 E(ce)-.18 E F0 -.2(bu)2.5 G(iltins \214nishes e) +.2 E -.15(xe)-.15 G(cuting.).15 E .285(If a)144 150 R F1(sigspec)3.125 E +F0(is)3.095 E F2(ERR)2.784 E F4(,)A F0 .284(the command)2.534 F F1 +(action)3.114 E F0 .284(is e)3.024 F -.15(xe)-.15 G .284(cuted whene).15 +F -.15(ve)-.25 G 2.784(rap).15 G .284(ipeline \(which may consist of a) +-2.784 F .185(single simple command\), a list, or a compound command re\ +turns a non\255zero e)144 162 R .185(xit status, subject to)-.15 F .452 +(the follo)144 174 R .452(wing conditions.)-.25 F(The)5.452 E F2(ERR) +2.952 E F0 .451(trap is not e)2.701 F -.15(xe)-.15 G .451 +(cuted if the f).15 F .451(ailed command is part of the com-)-.1 F .387 +(mand list immediately follo)144 186 R .387(wing a)-.25 F F3(while)2.887 +E F0(or)2.887 E F3(until)2.888 E F0 -.1(ke)2.888 G(yw)-.05 E .388 +(ord, part of the test in an)-.1 F F1(if)2.898 E F0 .388 +(statement, part)4.848 F .778(of a command e)144 198 R -.15(xe)-.15 G +.778(cuted in a).15 F F3(&&)3.278 E F0(or)3.278 E F3(||)3.278 E F0 .778 +(list e)3.278 F .778(xcept the command follo)-.15 F .778 +(wing the \214nal)-.25 F F3(&&)3.278 E F0(or)3.278 E F3(||)3.277 E F0 +3.277(,a)C -.15(ny)-3.277 G 1.28(command in a pipeline b)144 210 R 1.28 (ut the last, or if the command')-.2 F 3.78(sr)-.55 G 1.28(eturn v)-3.78 -F 1.28(alue is being in)-.25 F -.15(ve)-.4 G 1.28(rted using).15 F F4(!) -3.78 E F0(.)A(These are the same conditions obe)144 174 Q(yed by the) --.15 E F4(err)2.5 E(exit)-.18 E F0(\()2.5 E F4A F0 2.5(\)o)C -(ption.)-2.5 E .132 -(Signals ignored upon entry to the shell cannot be trapped or reset.)144 -192 R -.35(Tr)5.133 G .133(apped signals that are not be-).35 F .117 -(ing ignored are reset to their original v)144 204 R .117 -(alues in a subshell or subshell en)-.25 F .117 -(vironment when one is cre-)-.4 F 2.5(ated. The)144 216 R -(return status is f)2.5 E(alse if an)-.1 E(y)-.15 E F1(sigspec)2.84 E F0 -(is in)2.81 E -.25(va)-.4 G(lid; otherwise).25 E F4(trap)2.5 E F0 -(returns true.)2.5 E F4(type)108 232.8 Q F0([)2.5 E F4(\255aftpP)A F0(]) -A F1(name)2.5 E F0([)2.5 E F1(name)A F0(...])2.5 E -.4(Wi)144 244.8 S -.173(th no options, indicate ho).4 F 2.673(we)-.25 G(ach)-2.673 E F1 -(name)3.033 E F0 -.1(wo)2.853 G .174 +F 1.28(alue is being in)-.25 F -.15(ve)-.4 G 1.28(rted using).15 F F3(!) +3.78 E F0(.)A(These are the same conditions obe)144 222 Q(yed by the) +-.15 E F3(err)2.5 E(exit)-.18 E F0(\()2.5 E F3A F0 2.5(\)o)C +(ption.)-2.5 E .07(When the shell is not interacti)144 240 R -.15(ve) +-.25 G 2.57(,s).15 G .069 +(ignals ignored upon entry to the shell cannot be trapped or reset.) +-2.57 F(Interacti)144 252 Q .951 -.15(ve s)-.25 H .651 +(hells permit trapping signals ignored on entry).15 F 5.651(.T)-.65 G +.652(rapped signals that are not being ig-)-6.001 F .577 +(nored are reset to their original v)144 264 R .576 +(alues in a subshell or subshell en)-.25 F .576 +(vironment when one is created.)-.4 F(The return status is f)144 276 Q +(alse if an)-.1 E(y)-.15 E F1(sigspec)2.84 E F0(is in)2.81 E -.25(va)-.4 +G(lid; otherwise).25 E F3(trap)2.5 E F0(returns true.)2.5 E F3(type)108 +292.8 Q F0([)2.5 E F3(\255aftpP)A F0(])A F1(name)2.5 E F0([)2.5 E F1 +(name)A F0(...])2.5 E -.4(Wi)144 304.8 S .173 +(th no options, indicate ho).4 F 2.673(we)-.25 G(ach)-2.673 E F1(name) +3.033 E F0 -.1(wo)2.853 G .174 (uld be interpreted if used as a command name.).1 F .174(If the)5.174 F -F4144 256.8 Q F0 .715(option is used,)3.215 F F4(type)3.215 E F0 +F3144 316.8 Q F0 .715(option is used,)3.215 F F3(type)3.215 E F0 .715(prints a string which is one of)3.215 F F1(alias)3.545 E F0(,).27 E F1 -.1(ke)3.215 G(ywor)-.2 E(d)-.37 E F0(,).77 E F1(function)5.185 E F0 (,).24 E F1 -.2(bu)3.215 G(iltin).2 E F0 3.215(,o).24 G(r)-3.215 E F1 -(\214le)5.125 E F0(if)3.395 E F1(name)144.36 268.8 Q F0 .086 +(\214le)5.125 E F0(if)3.395 E F1(name)144.36 328.8 Q F0 .086 (is an alias, shell reserv)2.766 F .086(ed w)-.15 F .086 (ord, function, b)-.1 F .087(uiltin, or disk \214le, respecti)-.2 F -.15 (ve)-.25 G(ly).15 E 5.087(.I)-.65 G 2.587(ft)-5.087 G(he)-2.587 E F1 (name)2.947 E F0 .087(is not)2.767 F .119 -(found, then nothing is printed, and an e)144 280.8 R .118 +(found, then nothing is printed, and an e)144 340.8 R .118 (xit status of f)-.15 F .118(alse is returned.)-.1 F .118(If the)5.118 F -F42.618 E F0 .118(option is used,)2.618 F F4(type)2.618 E F0 .855 -(either returns the name of the disk \214le that w)144 292.8 R .855 +F32.618 E F0 .118(option is used,)2.618 F F3(type)2.618 E F0 .855 +(either returns the name of the disk \214le that w)144 352.8 R .855 (ould be e)-.1 F -.15(xe)-.15 G .855(cuted if).15 F F1(name)3.715 E F0 .855(were speci\214ed as a com-)3.535 F .529(mand name, or nothing if) -144 304.8 R/F5 10/Courier@0 SF .528(type -t name)3.028 F F0 -.1(wo)3.028 +144 364.8 R/F5 10/Courier@0 SF .528(type -t name)3.028 F F0 -.1(wo)3.028 G .528(uld not return).1 F F1(\214le)4.938 E F0 5.528(.T).18 G(he)-5.528 -E F43.028 E F0 .528(option forces a)3.028 F F2 -.666(PA)3.028 G -(TH)-.189 E F0 .006(search for each)144 316.8 R F1(name)2.506 E F0 2.506 +E F33.028 E F0 .528(option forces a)3.028 F F2 -.666(PA)3.028 G +(TH)-.189 E F0 .006(search for each)144 376.8 R F1(name)2.506 E F0 2.506 (,e)C -.15(ve)-2.756 G 2.506(ni).15 G(f)-2.506 E F5 .007(type -t name) 2.506 F F0 -.1(wo)2.507 G .007(uld not return).1 F F1(\214le)4.417 E F0 -5.007(.I).18 G 2.507(fac)-5.007 G .007(ommand is hashed,)-2.507 F F4 -2.507 E F0(and)144 328.8 Q F43.231 E F0 .731 +5.007(.I).18 G 2.507(fac)-5.007 G .007(ommand is hashed,)-2.507 F F3 +2.507 E F0(and)144 388.8 Q F33.231 E F0 .731 (print the hashed v)3.231 F .73 (alue, which is not necessarily the \214le that appears \214rst in)-.25 -F F2 -.666(PA)3.23 G(TH)-.189 E F3(.)A F0 .73(If the)5.23 F F4144 -340.8 Q F0 .823(option is used,)3.323 F F4(type)3.323 E F0 .824 +F F2 -.666(PA)3.23 G(TH)-.189 E F4(.)A F0 .73(If the)5.23 F F3144 +400.8 Q F0 .823(option is used,)3.323 F F3(type)3.323 E F0 .824 (prints all of the places that contain an e)3.323 F -.15(xe)-.15 G .824 (cutable named).15 F F1(name)3.684 E F0 5.824(.T).18 G .824(his in-) -5.824 F 1.176(cludes aliases and functions, if and only if the)144 -352.8 R F43.676 E F0 1.176(option is not also used.)3.676 F 1.176 +412.8 R F33.676 E F0 1.176(option is not also used.)3.676 F 1.176 (The table of hashed)6.176 F 1.223(commands is not consulted when using) -144 364.8 R F43.723 E F0 6.223(.T)C(he)-6.223 E F43.723 E F0 +144 424.8 R F33.723 E F0 6.223(.T)C(he)-6.223 E F33.723 E F0 1.223(option suppresses shell function lookup, as)3.723 F .326(with the) -144 376.8 R F4(command)2.826 E F0 -.2(bu)2.826 G(iltin.).2 E F4(type) +144 436.8 R F3(command)2.826 E F0 -.2(bu)2.826 G(iltin.).2 E F3(type) 5.326 E F0 .326(returns true if all of the ar)2.826 F .325 (guments are found, f)-.18 F .325(alse if an)-.1 F 2.825(ya)-.15 G .325 -(re not)-2.825 F(found.)144 388.8 Q F4(ulimit)108 405.6 Q F0([)2.5 E F4 -(\255HS)A F0(])A F42.5 E(ulimit)108 417.6 Q F0([)2.5 E F4(\255HS)A -F0 2.5(][)C F4(\255bcde\214klmnpqrstuvxPR)-2.5 E(T)-.4 E F0([)2.5 E F1 -(limit)A F0(]])A(Pro)144 429.6 Q .243(vides control o)-.15 F -.15(ve) +(re not)-2.825 F(found.)144 448.8 Q F3(ulimit)108 465.6 Q F0([)2.5 E F3 +(\255HS)A F0(])A F32.5 E(ulimit)108 477.6 Q F0([)2.5 E F3(\255HS)A +F0 2.5(][)C F3(\255bcde\214klmnpqrstuvxPR)-2.5 E(T)-.4 E F0([)2.5 E F1 +(limit)A F0(]])A(Pro)144 489.6 Q .243(vides control o)-.15 F -.15(ve) -.15 G 2.743(rt).15 G .243(he resources a)-2.743 F -.25(va)-.2 G .244 (ilable to the shell and to processes started by it, on systems).25 F -.944(that allo)144 441.6 R 3.444(ws)-.25 G .944(uch control.)-3.444 F -(The)5.944 E F43.444 E F0(and)3.444 E F43.444 E F0 .943 +.944(that allo)144 501.6 R 3.444(ws)-.25 G .944(uch control.)-3.444 F +(The)5.944 E F33.444 E F0(and)3.444 E F33.444 E F0 .943 (options specify that the hard or soft limit is set for the)3.444 F(gi) -144 453.6 Q -.15(ve)-.25 G 2.708(nr).15 G 2.708(esource. A)-2.708 F .208 +144 513.6 Q -.15(ve)-.25 G 2.708(nr).15 G 2.708(esource. A)-2.708 F .208 (hard limit cannot be increased by a non-root user once it is set; a so\ -ft limit may)2.708 F .426(be increased up to the v)144 465.6 R .426 -(alue of the hard limit.)-.25 F .425(If neither)5.426 F F42.925 E -F0(nor)2.925 E F42.925 E F0 .425 +ft limit may)2.708 F .426(be increased up to the v)144 525.6 R .426 +(alue of the hard limit.)-.25 F .425(If neither)5.426 F F32.925 E +F0(nor)2.925 E F32.925 E F0 .425 (is speci\214ed, both the soft and)2.925 F .139(hard limits are set.)144 -477.6 R .139(The v)5.139 F .139(alue of)-.25 F F1(limit)2.729 E F0 .139 +537.6 R .139(The v)5.139 F .139(alue of)-.25 F F1(limit)2.729 E F0 .139 (can be a number in the unit speci\214ed for the resource or one)3.319 F -.742(of the special v)144 489.6 R(alues)-.25 E F4(hard)3.242 E F0(,)A F4 -(soft)3.241 E F0 3.241(,o)C(r)-3.241 E F4(unlimited)3.241 E F0 3.241(,w) +.742(of the special v)144 549.6 R(alues)-.25 E F3(hard)3.242 E F0(,)A F3 +(soft)3.241 E F0 3.241(,o)C(r)-3.241 E F3(unlimited)3.241 E F0 3.241(,w) C .741(hich stand for the current hard limit, the current)-3.241 F .023 -(soft limit, and no limit, respecti)144 501.6 R -.15(ve)-.25 G(ly).15 E +(soft limit, and no limit, respecti)144 561.6 R -.15(ve)-.25 G(ly).15 E 5.023(.I)-.65 G(f)-5.023 E F1(limit)2.613 E F0 .023 (is omitted, the current v)3.203 F .023 (alue of the soft limit of the re-)-.25 F .985 -(source is printed, unless the)144 513.6 R F43.485 E F0 .984 +(source is printed, unless the)144 573.6 R F33.485 E F0 .984 (option is gi)3.485 F -.15(ve)-.25 G 3.484(n. When).15 F .984 (more than one resource is speci\214ed, the)3.484 F .7 -(limit name and unit, if appropriate, are printed before the v)144 525.6 +(limit name and unit, if appropriate, are printed before the v)144 585.6 R 3.2(alue. Other)-.25 F .7(options are interpreted as)3.2 F(follo)144 -537.6 Q(ws:)-.25 E F4144 549.6 Q F0 -(All current limits are reported; no limits are set)180 549.6 Q F4 -144 561.6 Q F0(The maximum sock)180 561.6 Q(et b)-.1 E(uf)-.2 E -(fer size)-.25 E F4144 573.6 Q F0 -(The maximum size of core \214les created)180 573.6 Q F4144 585.6 -Q F0(The maximum size of a process')180 585.6 Q 2.5(sd)-.55 G(ata se) --2.5 E(gment)-.15 E F4144 597.6 Q F0 -(The maximum scheduling priority \("nice"\))180 597.6 Q F4144 -609.6 Q F0 +597.6 Q(ws:)-.25 E F3144 609.6 Q F0 +(All current limits are reported; no limits are set)180 609.6 Q F3 +144 621.6 Q F0(The maximum sock)180 621.6 Q(et b)-.1 E(uf)-.2 E +(fer size)-.25 E F3144 633.6 Q F0 +(The maximum size of core \214les created)180 633.6 Q F3144 645.6 +Q F0(The maximum size of a process')180 645.6 Q 2.5(sd)-.55 G(ata se) +-2.5 E(gment)-.15 E F3144 657.6 Q F0 +(The maximum scheduling priority \("nice"\))180 657.6 Q F3144 +669.6 Q F0 (The maximum size of \214les written by the shell and its children)180 -609.6 Q F4144 621.6 Q F0(The maximum number of pending signals)180 -621.6 Q F4144 633.6 Q F0 -(The maximum number of kqueues that may be allocated)180 633.6 Q F4 -144 645.6 Q F0(The maximum size that may be lock)180 645.6 Q -(ed into memory)-.1 E F4144 657.6 Q F0 -(The maximum resident set size \(man)180 657.6 Q 2.5(ys)-.15 G -(ystems do not honor this limit\))-2.5 E F4144 669.6 Q F0 .791(Th\ -e maximum number of open \214le descriptors \(most systems do not allo) -180 669.6 R 3.29(wt)-.25 G .79(his v)-3.29 F .79(alue to)-.25 F -(be set\))180 681.6 Q F4144 693.6 Q F0 -(The pipe size in 512-byte blocks \(this may not be set\))180 693.6 Q F4 -144 705.6 Q F0 -(The maximum number of bytes in POSIX message queues)180 705.6 Q F4 -144 717.6 Q F0(The maximum real-time scheduling priority)180 717.6 -Q(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(82)185.115 E 0 Cg EP +669.6 Q F3144 681.6 Q F0(The maximum number of pending signals)180 +681.6 Q F3144 693.6 Q F0 +(The maximum number of kqueues that may be allocated)180 693.6 Q F3 +144 705.6 Q F0(The maximum size that may be lock)180 705.6 Q +(ed into memory)-.1 E F3144 717.6 Q F0 +(The maximum resident set size \(man)180 717.6 Q 2.5(ys)-.15 G +(ystems do not honor this limit\))-2.5 E(GNU Bash 5.2)72 768 Q +(2022 December 2)139.295 E(82)188.455 E 0 Cg EP %%Page: 83 83 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S 137.14(SH\(1\) General).35 F (Commands Manual)2.5 E -.35(BA)139.64 G(SH\(1\)).35 E/F1 10/Times-Bold@0 -SF144 84 Q F0(The maximum stack size)180 84 Q F1144 96 Q F0 -(The maximum amount of cpu time in seconds)180 96 Q F1144 108 Q F0 -(The maximum number of processes a)180 108 Q -.25(va)-.2 G -(ilable to a single user).25 E F1144 120 Q F0 .47 -(The maximum amount of virtual memory a)180 120 R -.25(va)-.2 G .47 -(ilable to the shell and, on some systems, to).25 F(its children)180 132 -Q F1144 144 Q F0(The maximum number of \214le locks)180 144 Q F1 -144 156 Q F0(The maximum number of pseudoterminals)180 156 Q F1 -144 168 Q F0(The maximum time a real-time process can run before \ -blocking, in microseconds)180 168 Q F1144 180 Q F0 -(The maximum number of threads)180 180 Q(If)144 196.8 Q/F2 10 +SF144 84 Q F0 .791(The maximum number of open \214le descriptors \ +\(most systems do not allo)180 84 R 3.29(wt)-.25 G .79(his v)-3.29 F .79 +(alue to)-.25 F(be set\))180 96 Q F1144 108 Q F0 +(The pipe size in 512-byte blocks \(this may not be set\))180 108 Q F1 +144 120 Q F0(The maximum number of bytes in POSIX message queues) +180 120 Q F1144 132 Q F0 +(The maximum real-time scheduling priority)180 132 Q F1144 144 Q +F0(The maximum stack size)180 144 Q F1144 156 Q F0 +(The maximum amount of cpu time in seconds)180 156 Q F1144 168 Q +F0(The maximum number of processes a)180 168 Q -.25(va)-.2 G +(ilable to a single user).25 E F1144 180 Q F0 .47 +(The maximum amount of virtual memory a)180 180 R -.25(va)-.2 G .47 +(ilable to the shell and, on some systems, to).25 F(its children)180 192 +Q F1144 204 Q F0(The maximum number of \214le locks)180 204 Q F1 +144 216 Q F0(The maximum number of pseudoterminals)180 216 Q F1 +144 228 Q F0(The maximum time a real-time process can run before \ +blocking, in microseconds)180 228 Q F1144 240 Q F0 +(The maximum number of threads)180 240 Q(If)144 256.8 Q/F2 10 /Times-Italic@0 SF(limit)3.058 E F0 .468(is gi)3.648 F -.15(ve)-.25 G .468(n, and the).15 F F12.968 E F0 .468(option is not used,)2.968 F F2(limit)2.968 E F0 .468(is the ne)2.968 F 2.968(wv)-.25 G .468 (alue of the speci\214ed resource.)-3.218 F(If)5.468 E .044 -(no option is gi)144 208.8 R -.15(ve)-.25 G .044(n, then).15 F F1 +(no option is gi)144 268.8 R -.15(ve)-.25 G .044(n, then).15 F F1 2.544 E F0 .045(is assumed.)2.545 F -1.11(Va)5.045 G .045 (lues are in 1024-byte increments, e)1.11 F .045(xcept for)-.15 F F1 2.545 E F0 2.545(,w)C .045(hich is)-2.545 F .67(in seconds;)144 -220.8 R F13.17 E F0 3.17(,w)C .67(hich is in microseconds;)-3.17 F +280.8 R F13.17 E F0 3.17(,w)C .67(hich is in microseconds;)-3.17 F F13.17 E F0 3.17(,w)C .67(hich is in units of 512-byte blocks;) -3.17 F F13.17 E F0(,)A F13.17 E F0(,)A F13.17 E F0(,) -A F1144 232.8 Q F0(,)A F13.736 E F0 3.736(,a)C(nd)-3.736 E +A F1144 292.8 Q F0(,)A F13.736 E F0 3.736(,a)C(nd)-3.736 E F13.736 E F0 3.736(,w)C 1.236(hich are unscaled v)-3.736 F 1.236 (alues; and, when in posix mode,)-.25 F F13.736 E F0(and)3.736 E F13.736 E F0 3.736(,w)C 1.237(hich are in)-3.736 F .239 -(512-byte increments.)144 244.8 R .238 +(512-byte increments.)144 304.8 R .238 (The return status is 0 unless an in)5.239 F -.25(va)-.4 G .238 (lid option or ar).25 F .238(gument is supplied, or an)-.18 F -(error occurs while setting a ne)144 256.8 Q 2.5(wl)-.25 G(imit.)-2.5 E -F1(umask)108 273.6 Q F0([)2.5 E F1A F0 2.5(][)C F1-2.5 E F0 +(error occurs while setting a ne)144 316.8 Q 2.5(wl)-.25 G(imit.)-2.5 E +F1(umask)108 333.6 Q F0([)2.5 E F1A F0 2.5(][)C F1-2.5 E F0 2.5(][)C F2(mode)-2.5 E F0(])A .18 -(The user \214le-creation mask is set to)144 285.6 R F2(mode)3.06 E F0 +(The user \214le-creation mask is set to)144 345.6 R F2(mode)3.06 E F0 5.18(.I).18 G(f)-5.18 E F2(mode)3.06 E F0(be)2.86 E .18 (gins with a digit, it is interpreted as an octal)-.15 F .066(number; o\ therwise it is interpreted as a symbolic mode mask similar to that acce\ -pted by)144 297.6 R F2 -.15(ch)2.566 G(mod).15 E F0(\(1\).).77 E(If)144 -309.6 Q F2(mode)3.262 E F0 .382(is omitted, the current v)3.062 F .382 +pted by)144 357.6 R F2 -.15(ch)2.566 G(mod).15 E F0(\(1\).).77 E(If)144 +369.6 Q F2(mode)3.262 E F0 .382(is omitted, the current v)3.062 F .382 (alue of the mask is printed.)-.25 F(The)5.382 E F12.882 E F0 .382 (option causes the mask to be)2.882 F .547 -(printed in symbolic form; the def)144 321.6 R .547 +(printed in symbolic form; the def)144 381.6 R .547 (ault output is an octal number)-.1 F 5.547(.I)-.55 G 3.047(ft)-5.547 G (he)-3.047 E F13.047 E F0 .547(option is supplied, and)3.047 F F2 -(mode)144.38 333.6 Q F0 .551 +(mode)144.38 393.6 Q F0 .551 (is omitted, the output is in a form that may be reused as input.)3.231 -F .552(The return status is 0 if the)5.552 F(mode w)144 345.6 Q +F .552(The return status is 0 if the)5.552 F(mode w)144 405.6 Q (as successfully changed or if no)-.1 E F2(mode)2.5 E F0(ar)2.5 E (gument w)-.18 E(as supplied, and f)-.1 E(alse otherwise.)-.1 E F1 -(unalias)108 362.4 Q F0<5bad>2.5 E F1(a)A F0 2.5(][)C F2(name)-2.5 E F0 -(...])2.5 E(Remo)144 374.4 Q 1.058 -.15(ve e)-.15 H(ach).15 E F2(name) +(unalias)108 422.4 Q F0<5bad>2.5 E F1(a)A F0 2.5(][)C F2(name)-2.5 E F0 +(...])2.5 E(Remo)144 434.4 Q 1.058 -.15(ve e)-.15 H(ach).15 E F2(name) 3.258 E F0 .758(from the list of de\214ned aliases.)3.258 F(If)5.758 E F13.258 E F0 .757(is supplied, all alias de\214nitions are re-) -3.258 F(mo)144 386.4 Q -.15(ve)-.15 G 2.5(d. The).15 F(return v)2.5 E +3.258 F(mo)144 446.4 Q -.15(ve)-.15 G 2.5(d. The).15 F(return v)2.5 E (alue is true unless a supplied)-.25 E F2(name)2.86 E F0 -(is not a de\214ned alias.)2.68 E F1(unset)108 403.2 Q F0<5bad>2.5 E F1 +(is not a de\214ned alias.)2.68 E F1(unset)108 463.2 Q F0<5bad>2.5 E F1 (fv)A F0 2.5(][)C-2.5 E F1(n)A F0 2.5(][)C F2(name)-2.5 E F0(...]) -2.5 E -.15(Fo)144 415.2 S 3.803(re).15 G(ach)-3.803 E F2(name)4.163 E F0 +2.5 E -.15(Fo)144 475.2 S 3.803(re).15 G(ach)-3.803 E F2(name)4.163 E F0 3.803(,r).18 G(emo)-3.803 E 1.603 -.15(ve t)-.15 H 1.303 (he corresponding v).15 F 1.303(ariable or function.)-.25 F 1.303 (If the)6.303 F F13.804 E F0 1.304(option is gi)3.804 F -.15(ve) --.25 G 1.304(n, each).15 F F2(name)144.36 427.2 Q F0 .465 +-.25 G 1.304(n, each).15 F F2(name)144.36 487.2 Q F0 .465 (refers to a shell v)3.145 F .464(ariable, and that v)-.25 F .464 (ariable is remo)-.25 F -.15(ve)-.15 G 2.964(d. Read-only).15 F -.25(va) -2.964 G .464(riables may not be un-).25 F 2.768(set. If)144 439.2 R F1 +2.964 G .464(riables may not be un-).25 F 2.768(set. If)144 499.2 R F1 2.768 E F0 .269(is speci\214ed, each)2.768 F F2(name)3.129 E F0 .269(refers to a shell function, and the function de\214nition is remo) -2.949 F -.15(ve)-.15 G(d.).15 E .404(If the)144 451.2 R F12.904 E +2.949 F -.15(ve)-.15 G(d.).15 E .404(If the)144 511.2 R F12.904 E F0 .404(option is supplied, and)2.904 F F2(name)2.904 E F0 .404(is a v) 2.904 F .404(ariable with the)-.25 F F2(namer)2.904 E(ef)-.37 E F0 (attrib)2.904 E(ute,)-.2 E F2(name)2.904 E F0 .403(will be unset)2.904 F -.719(rather than the v)144 463.2 R .719(ariable it references.)-.25 F F1 +.719(rather than the v)144 523.2 R .719(ariable it references.)-.25 F F1 5.719 E F0 .719(has no ef)3.219 F .719(fect if the)-.25 F F1 3.22 E F0 .72(option is supplied.)3.22 F .72(If no options)5.72 F .737 -(are supplied, each)144 475.2 R F2(name)3.237 E F0 .737(refers to a v) +(are supplied, each)144 535.2 R F2(name)3.237 E F0 .737(refers to a v) 3.237 F .737(ariable; if there is no v)-.25 F .736 (ariable by that name, a function with)-.25 F 1.761(that name, if an)144 -487.2 R 3.061 -.65(y, i)-.15 H 4.261(su).65 G 4.261(nset. Each)-4.261 F +547.2 R 3.061 -.65(y, i)-.15 H 4.261(su).65 G 4.261(nset. Each)-4.261 F 1.761(unset v)4.261 F 1.761(ariable or function is remo)-.25 F -.15(ve) -.15 G 4.262(df).15 G 1.762(rom the en)-4.262 F(vironment)-.4 E 3.172 -(passed to subsequent commands.)144 499.2 R 3.172(If an)8.172 F 5.672 +(passed to subsequent commands.)144 559.2 R 3.172(If an)8.172 F 5.672 (yo)-.15 G(f)-5.672 E/F3 9/Times-Bold@0 SF -.27(BA)5.672 G(SH_ALIASES) .27 E/F4 9/Times-Roman@0 SF(,)A F3 -.27(BA)5.421 G(SH_ARGV0).27 E F4(,)A -F3 -.27(BA)5.421 G(SH_CMDS).27 E F4(,)A F3 -.27(BA)144 511.2 S +F3 -.27(BA)5.421 G(SH_CMDS).27 E F4(,)A F3 -.27(BA)144 571.2 S (SH_COMMAND).27 E F4(,)A F3 -.27(BA)11.481 G(SH_SUBSHELL).27 E F4(,)A F3 -.27(BA)11.482 G(SHPID).27 E F4(,)A F3(COMP_W)11.482 E(ORDBREAKS)-.09 E F4(,)A F3(DIRST)11.482 E -.495(AC)-.81 G(K).495 E F4(,)A F3(EPOCHREAL) -144 523.2 Q(TIME)-.828 E F4(,)A F3(EPOCHSECONDS)2.67 E F4(,)A F3(FUNCN) +144 583.2 Q(TIME)-.828 E F4(,)A F3(EPOCHSECONDS)2.67 E F4(,)A F3(FUNCN) 2.67 E(AME)-.18 E F4(,)A F3(GR)2.67 E(OUPS)-.27 E F4(,)A F3(HISTCMD)2.67 E F4(,)A F3(LINENO)2.67 E F4(,)A F3(RANDOM)2.67 E F4(,)A F3(SECONDS)144 -535.2 Q F4(,)A F0(or)4.029 E F3(SRANDOM)4.279 E F0 1.779(are unset, the) +595.2 Q F4(,)A F0(or)4.029 E F3(SRANDOM)4.279 E F0 1.779(are unset, the) 4.029 F 4.279(yl)-.15 G 1.779(ose their special properties, e)-4.279 F -.15(ve)-.25 G 4.279(ni).15 G 4.28(ft)-4.279 G(he)-4.28 E 4.28(ya)-.15 G -1.78(re subse-)-4.28 F(quently reset.)144 547.2 Q(The e)5 E +1.78(re subse-)-4.28 F(quently reset.)144 607.2 Q(The e)5 E (xit status is true unless a)-.15 E F2(name)2.86 E F0 -(is readonly or may not be unset.)2.68 E F1(wait)108 564 Q F0([)2.5 E F1 +(is readonly or may not be unset.)2.68 E F1(wait)108 624 Q F0([)2.5 E F1 (\255fn)A F0 2.5(][)C F1-2.5 E F2(varname)2.5 E F0 2.5(][)C F2 -(id ...)-2.5 E F0(])A -.8(Wa)144 576 S .659(it for each speci\214ed chi\ +(id ...)-2.5 E F0(])A -.8(Wa)144 636 S .659(it for each speci\214ed chi\ ld process and return its termination status.).8 F(Each)5.659 E F2(id) 3.169 E F0 .658(may be a process)3.928 F .008 -(ID or a job speci\214cation; if a job spec is gi)144 588 R -.15(ve)-.25 +(ID or a job speci\214cation; if a job spec is gi)144 648 R -.15(ve)-.25 G .009(n, all processes in that job').15 F 2.509(sp)-.55 G .009 (ipeline are w)-2.509 F .009(aited for)-.1 F 5.009(.I)-.55 G(f)-5.009 E -F2(id)144.01 600 Q F0 .442(is not gi)3.712 F -.15(ve)-.25 G(n,).15 E F1 +F2(id)144.01 660 Q F0 .442(is not gi)3.712 F -.15(ve)-.25 G(n,).15 E F1 (wait)2.942 E F0 -.1(wa)2.942 G .441 (its for all running background jobs and the last-e).1 F -.15(xe)-.15 G .441(cuted process substitu-).15 F .597 -(tion, if its process id is the same as)144 612 R F1($!)3.098 E F0 3.098 +(tion, if its process id is the same as)144 672 R F1($!)3.098 E F0 3.098 (,a)C .598(nd the return status is zero.)-3.098 F .598(If the)5.598 F F1 -3.098 E F0 .598(option is supplied,)3.098 F F1(wait)144 624 Q F0 +3.098 E F0 .598(option is supplied,)3.098 F F1(wait)144 684 Q F0 -.1(wa)3.083 G .583(its for a single job from the list of).1 F F2(id) 3.083 E F0 3.083(so)C 1.383 -.4(r, i)-3.083 H 3.083(fn).4 G(o)-3.083 E F2(id)3.083 E F0 3.083(sa)C .583(re supplied, an)-3.083 F 3.083(yj)-.15 -G .582(ob, to complete and)-3.083 F .403(returns its e)144 636 R .403 +G .582(ob, to complete and)-3.083 F .403(returns its e)144 696 R .403 (xit status.)-.15 F .403(If none of the supplied ar)5.403 F .403 (guments is a child of the shell, or if no ar)-.18 F(guments)-.18 E .573 -(are supplied and the shell has no unw)144 648 R .573 +(are supplied and the shell has no unw)144 708 R .573 (aited-for children, the e)-.1 F .573(xit status is 127.)-.15 F .572 (If the)5.573 F F13.072 E F0 .572(option is)3.072 F .39 (supplied, the process or job identi\214er of the job for which the e) -144 660 R .39(xit status is returned is assigned to)-.15 F .905(the v) -144 672 R(ariable)-.25 E F2(varname)3.405 E F0 .905 -(named by the option ar)3.405 F 3.405(gument. The)-.18 F -.25(va)3.405 G -.905(riable will be unset initially).25 F 3.405(,b)-.65 G(efore)-3.405 E -(an)144 684 Q 3.89(ya)-.15 G 3.89(ssignment. This)-3.89 F 1.39 -(is useful only when the)3.89 F F13.89 E F0 1.39 -(option is supplied.)3.89 F 1.39(Supplying the)6.39 F F13.89 E F0 -(option,)3.89 E .575(when job control is enabled, forces)144 696 R F1 -(wait)3.075 E F0 .575(to w)3.075 F .575(ait for)-.1 F F2(id)3.075 E F0 -.574(to terminate before returning its status, in-)3.075 F .635 -(stead of returning when it changes status.)144 708 R(If)5.635 E F2(id) -3.145 E F0 .635(speci\214es a non-e)3.905 F .635 -(xistent process or job, the return)-.15 F 1.694(status is 127.)144 720 -R(If)6.694 E F1(wait)4.194 E F0 1.694(is interrupted by a signal, the r\ -eturn status will be greater than 128, as)4.194 F(GNU Bash 5.2)72 768 Q -(2022 September 19)135.955 E(83)185.115 E 0 Cg EP +144 720 R .39(xit status is returned is assigned to)-.15 F(GNU Bash 5.2) +72 768 Q(2022 December 2)139.295 E(83)188.455 E 0 Cg EP %%Page: 84 84 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S 137.14(SH\(1\) General).35 F -(Commands Manual)2.5 E -.35(BA)139.64 G(SH\(1\)).35 E .113 -(described under)144 84 R/F1 10/Times-Bold@0 SF(SIGN)2.613 E(ALS)-.2 E -F0(abo)2.613 E -.15(ve)-.15 G 5.113(.O).15 G .113 -(therwise, the return status is the e)-5.113 F .114 -(xit status of the last process)-.15 F(or job w)144 96 Q(aited for)-.1 E -(.)-.55 E/F2 10.95/Times-Bold@0 SF(SHELL COMP)72 112.8 Q -1.04(AT)-.81 G -(IBILITY MODE)1.04 E F0 1.355(Bash-4.0 introduced the concept of a)108 -124.8 R/F3 10/Times-Italic@0 SF 1.355(shell compatibility le)3.855 F -(vel)-.15 E F0 3.855(,s)C 1.354 -(peci\214ed as a set of options to the shopt)-3.855 F -.2(bu)108 136.8 S -.398(iltin \().2 F F1(compat31)2.898 E F0(,)A F1(compat32)2.898 E F0(,)A -F1(compat40)2.898 E F0(,)A F1(compat41)2.898 E F0 2.898(,a)C .399 -(nd so on\).)-2.898 F .399(There is only one current compatibility)5.399 -F(le)108 148.8 Q -.15(ve)-.25 G 3.254(l-).15 G 3.254(-e)-3.254 G .754 -(ach option is mutually e)-3.254 F(xclusi)-.15 E -.15(ve)-.25 G 5.754 -(.T).15 G .754(he compatibility le)-5.754 F -.15(ve)-.25 G 3.253(li).15 -G 3.253(si)-3.253 G .753(ntended to allo)-3.253 F 3.253(wu)-.25 G .753 -(sers to select be-)-3.253 F(ha)108 160.8 Q 1.083(vior from pre)-.2 F -1.083(vious v)-.25 F 1.083(ersions that is incompatible with ne)-.15 F -1.083(wer v)-.25 F 1.083(ersions while the)-.15 F 3.584(ym)-.15 G 1.084 -(igrate scripts to use)-3.584 F(current features and beha)108 172.8 Q -(vior)-.2 E 2.5(.I)-.55 G(t')-2.5 E 2.5(si)-.55 G +(Commands Manual)2.5 E -.35(BA)139.64 G(SH\(1\)).35 E .905(the v)144 84 +R(ariable)-.25 E/F1 10/Times-Italic@0 SF(varname)3.405 E F0 .905 +(named by the option ar)3.405 F 3.405(gument. The)-.18 F -.25(va)3.405 G +.905(riable will be unset initially).25 F 3.405(,b)-.65 G(efore)-3.405 E +(an)144 96 Q 3.89(ya)-.15 G 3.89(ssignment. This)-3.89 F 1.39 +(is useful only when the)3.89 F/F2 10/Times-Bold@0 SF3.89 E F0 +1.39(option is supplied.)3.89 F 1.39(Supplying the)6.39 F F23.89 E +F0(option,)3.89 E .575(when job control is enabled, forces)144 108 R F2 +(wait)3.075 E F0 .575(to w)3.075 F .575(ait for)-.1 F F1(id)3.075 E F0 +.574(to terminate before returning its status, in-)3.075 F .635 +(stead of returning when it changes status.)144 120 R(If)5.635 E F1(id) +3.145 E F0 .635(speci\214es a non-e)3.905 F .635 +(xistent process or job, the return)-.15 F .802(status is 127.)144 132 R +(If)5.801 E F2(wait)3.301 E F0 .801(is interrupted by a signal, the ret\ +urn status will be greater than 128, as de-)3.301 F .019(scribed under) +144 144 R F2(SIGN)2.519 E(ALS)-.2 E F0(abo)2.519 E -.15(ve)-.15 G 5.019 +(.O).15 G .019(therwise, the return status is the e)-5.019 F .02 +(xit status of the last process or)-.15 F(job w)144 156 Q(aited for)-.1 +E(.)-.55 E/F3 10.95/Times-Bold@0 SF(SHELL COMP)72 172.8 Q -1.04(AT)-.81 +G(IBILITY MODE)1.04 E F0 1.355(Bash-4.0 introduced the concept of a)108 +184.8 R F1 1.355(shell compatibility le)3.855 F(vel)-.15 E F0 3.855(,s)C +1.354(peci\214ed as a set of options to the shopt)-3.855 F -.2(bu)108 +196.8 S .398(iltin \().2 F F2(compat31)2.898 E F0(,)A F2(compat32)2.898 +E F0(,)A F2(compat40)2.898 E F0(,)A F2(compat41)2.898 E F0 2.898(,a)C +.399(nd so on\).)-2.898 F .399(There is only one current compatibility) +5.399 F(le)108 208.8 Q -.15(ve)-.25 G 3.254(l-).15 G 3.254(-e)-3.254 G +.754(ach option is mutually e)-3.254 F(xclusi)-.15 E -.15(ve)-.25 G +5.754(.T).15 G .754(he compatibility le)-5.754 F -.15(ve)-.25 G 3.253 +(li).15 G 3.253(si)-3.253 G .753(ntended to allo)-3.253 F 3.253(wu)-.25 +G .753(sers to select be-)-3.253 F(ha)108 220.8 Q 1.083(vior from pre) +-.2 F 1.083(vious v)-.25 F 1.083(ersions that is incompatible with ne) +-.15 F 1.083(wer v)-.25 F 1.083(ersions while the)-.15 F 3.584(ym)-.15 G +1.084(igrate scripts to use)-3.584 F(current features and beha)108 232.8 +Q(vior)-.2 E 2.5(.I)-.55 G(t')-2.5 E 2.5(si)-.55 G (ntended to be a temporary solution.)-2.5 E 1.457 -(This section does not mention beha)108 189.6 R 1.457 +(This section does not mention beha)108 249.6 R 1.457 (vior that is standard for a particular v)-.2 F 1.456 -(ersion \(e.g., setting)-.15 F F1(compat32)3.956 E F0 .886 -(means that quoting the rhs of the re)108 201.6 R(ge)-.15 E .886 +(ersion \(e.g., setting)-.15 F F2(compat32)3.956 E F0 .886 +(means that quoting the rhs of the re)108 261.6 R(ge)-.15 E .886 (xp matching operator quotes special re)-.15 F(ge)-.15 E .887 -(xp characters in the w)-.15 F(ord,)-.1 E(which is def)108 213.6 Q +(xp characters in the w)-.15 F(ord,)-.1 E(which is def)108 273.6 Q (ault beha)-.1 E(vior in bash-3.2 and subsequent v)-.2 E(ersions\).)-.15 -E .523(If a user enables, say)108 230.4 R(,)-.65 E F1(compat32)3.023 E +E .523(If a user enables, say)108 290.4 R(,)-.65 E F2(compat32)3.023 E F0 3.023(,i)C 3.023(tm)-3.023 G .523(ay af)-3.023 F .523(fect the beha) -.25 F .523(vior of other compatibility le)-.2 F -.15(ve)-.25 G .522 (ls up to and includ-).15 F .259(ing the current compatibility le)108 -242.4 R -.15(ve)-.25 G 2.759(l. The).15 F .259 +302.4 R -.15(ve)-.25 G 2.759(l. The).15 F .259 (idea is that each compatibility le)2.759 F -.15(ve)-.25 G 2.76(lc).15 G .26(ontrols beha)-2.76 F .26(vior that changed)-.2 F 1.646(in that v)108 -254.4 R 1.646(ersion of)-.15 F F1(bash)4.146 E F0 4.146(,b)C 1.646 +314.4 R 1.646(ersion of)-.15 F F2(bash)4.146 E F0 4.146(,b)C 1.646 (ut that beha)-4.346 F 1.646(vior may ha)-.2 F 1.946 -.15(ve b)-.2 H 1.646(een present in earlier v).15 F 4.146(ersions. F)-.15 F 1.645 (or instance, the)-.15 F .76 -(change to use locale-based comparisons with the)108 266.4 R F1([[)3.261 +(change to use locale-based comparisons with the)108 326.4 R F2([[)3.261 E F0 .761(command came in bash-4.1, and earlier v)3.261 F .761 (ersions used)-.15 F 1.905(ASCII-based comparisons, so enabling)108 -278.4 R F1(compat32)4.405 E F0 1.904 +338.4 R F2(compat32)4.405 E F0 1.904 (will enable ASCII-based comparisons as well.)4.405 F(That)6.904 E .295 -(granularity may not be suf)108 290.4 R .296 +(granularity may not be suf)108 350.4 R .296 (\214cient for all uses, and as a result users should emplo)-.25 F 2.796 (yc)-.1 G .296(ompatibility le)-2.796 F -.15(ve)-.25 G .296(ls care-).15 -F(fully)108 302.4 Q 5(.R)-.65 G(ead the documentation for a particular \ +F(fully)108 362.4 Q 5(.R)-.65 G(ead the documentation for a particular \ feature to \214nd out the current beha)-5 E(vior)-.2 E(.)-.55 E .532 -(Bash-4.3 introduced a ne)108 319.2 R 3.032(ws)-.25 G .531(hell v)-3.032 +(Bash-4.3 introduced a ne)108 379.2 R 3.032(ws)-.25 G .531(hell v)-3.032 F(ariable:)-.25 E/F4 9/Times-Bold@0 SF -.27(BA)3.031 G(SH_COMP).27 E -.855(AT)-.666 G/F5 9/Times-Roman@0 SF(.).855 E F0 .531(The v)5.031 F .531(alue assigned to this v)-.25 F .531(ariable \(a decimal)-.25 F -.15 -(ve)108 331.2 S .107(rsion number lik).15 F 2.607(e4)-.1 G .107 -(.2, or an inte)-2.607 F .107(ger corresponding to the)-.15 F F1(compat) -2.608 E F3(NN)A F0 .108(option, lik)2.608 F 2.608(e4)-.1 G .108 -(2\) determines the com-)-2.608 F(patibility le)108 343.2 Q -.15(ve)-.25 -G(l.).15 E .388(Starting with bash-4.4, Bash has be)108 360 R .388 +(ve)108 391.2 S .107(rsion number lik).15 F 2.607(e4)-.1 G .107 +(.2, or an inte)-2.607 F .107(ger corresponding to the)-.15 F F2(compat) +2.608 E F1(NN)A F0 .108(option, lik)2.608 F 2.608(e4)-.1 G .108 +(2\) determines the com-)-2.608 F(patibility le)108 403.2 Q -.15(ve)-.25 +G(l.).15 E .388(Starting with bash-4.4, Bash has be)108 420 R .388 (gun deprecating older compatibility le)-.15 F -.15(ve)-.25 G 2.887 (ls. Ev).15 F(entually)-.15 E 2.887(,t)-.65 G .387(he options will) --2.887 F(be remo)108 372 Q -.15(ve)-.15 G 2.5(di).15 G 2.5(nf)-2.5 G -.2 +-2.887 F(be remo)108 432 Q -.15(ve)-.15 G 2.5(di).15 G 2.5(nf)-2.5 G -.2 (avo)-2.6 G 2.5(ro).2 G(f)-2.5 E F4 -.27(BA)2.5 G(SH_COMP).27 E -.855 -(AT)-.666 G F5(.).855 E F0 1.163(Bash-5.0 is the \214nal v)108 388.8 R +(AT)-.666 G F5(.).855 E F0 1.163(Bash-5.0 is the \214nal v)108 448.8 R 1.163(ersion for which there will be an indi)-.15 F 1.164 (vidual shopt option for the pre)-.25 F 1.164(vious v)-.25 F(ersion.) --.15 E(Users should use)108 400.8 Q F4 -.27(BA)2.5 G(SH_COMP).27 E -.855 +-.15 E(Users should use)108 460.8 Q F4 -.27(BA)2.5 G(SH_COMP).27 E -.855 (AT)-.666 G F0(on bash-5.0 and later v)3.105 E(ersions.)-.15 E 1.614 -(The follo)108 417.6 R 1.613(wing table describes the beha)-.25 F 1.613 +(The follo)108 477.6 R 1.613(wing table describes the beha)-.25 F 1.613 (vior changes controlled by each compatibility le)-.2 F -.15(ve)-.25 G -4.113(ls).15 G 4.113(etting. The)-4.113 F F1(compat)108 429.6 Q F3(NN)A +4.113(ls).15 G 4.113(etting. The)-4.113 F F2(compat)108 489.6 Q F1(NN)A F0 1.186(tag is used as shorthand for setting the compatibility le)3.685 -F -.15(ve)-.25 G 3.686(lt).15 G(o)-3.686 E F3(NN)3.686 E F0 1.186 +F -.15(ve)-.25 G 3.686(lt).15 G(o)-3.686 E F1(NN)3.686 E F0 1.186 (using one of the follo)3.686 F(wing)-.25 E 3.807(mechanisms. F)108 -441.6 R 1.307(or v)-.15 F 1.307 +501.6 R 1.307(or v)-.15 F 1.307 (ersions prior to bash-5.0, the compatibility le)-.15 F -.15(ve)-.25 G -3.806(lm).15 G 1.306(ay be set using the corresponding)-3.806 F F1 -(compat)108 453.6 Q F3(NN)A F0 .502(shopt option.)3.002 F -.15(Fo)5.502 +3.806(lm).15 G 1.306(ay be set using the corresponding)-3.806 F F2 +(compat)108 513.6 Q F1(NN)A F0 .502(shopt option.)3.002 F -.15(Fo)5.502 G 3.002(rb).15 G .502(ash-4.3 and later v)-3.002 F .502(ersions, the) -.15 F F4 -.27(BA)3.002 G(SH_COMP).27 E -.855(AT)-.666 G F0 -.25(va) 3.607 G .502(riable is preferred, and it).25 F -(is required for bash-5.1 and later v)108 465.6 Q(ersions.)-.15 E F1 -(compat31)108 482.4 Q F0<83>144 494.4 Q(quoting the rhs of the)180 494.4 -Q F1([[)2.5 E F0(command')2.5 E 2.5(sr)-.55 G -.15(eg)-2.5 G -.15(ex).15 +(is required for bash-5.1 and later v)108 525.6 Q(ersions.)-.15 E F2 +(compat31)108 542.4 Q F0<83>144 554.4 Q(quoting the rhs of the)180 554.4 +Q F2([[)2.5 E F0(command')2.5 E 2.5(sr)-.55 G -.15(eg)-2.5 G -.15(ex).15 G 2.5(pm).15 G(atching operator \(=~\) has no special ef)-2.5 E(fect) --.25 E F1(compat32)108 511.2 Q F0<83>144 523.2 Q .35 -(interrupting a command list such as "a ; b ; c" causes the e)180 523.2 +-.25 E F2(compat32)108 571.2 Q F0<83>144 583.2 Q .35 +(interrupting a command list such as "a ; b ; c" causes the e)180 583.2 R -.15(xe)-.15 G .35(cution of the ne).15 F .35(xt command)-.15 F .017 -(in the list \(in bash-4.0 and later v)180 535.2 R .018 +(in the list \(in bash-4.0 and later v)180 595.2 R .018 (ersions, the shell acts as if it recei)-.15 F -.15(ve)-.25 G 2.518(dt) .15 G .018(he interrupt, so in-)-2.518 F -(terrupting one command in a list aborts the e)180 547.2 Q -.15(xe)-.15 -G(cution of the entire list\)).15 E F1(compat40)108 564 Q F0<83>144 576 -Q(the)180 576 Q F1(<)2.674 E F0(and)2.674 E F1(>)2.673 E F0 .173 -(operators to the)2.673 F F1([[)2.673 E F0 .173 +(terrupting one command in a list aborts the e)180 607.2 Q -.15(xe)-.15 +G(cution of the entire list\)).15 E F2(compat40)108 624 Q F0<83>144 636 +Q(the)180 636 Q F2(<)2.674 E F0(and)2.674 E F2(>)2.673 E F0 .173 +(operators to the)2.673 F F2([[)2.673 E F0 .173 (command do not consider the current locale when compar)2.673 F(-)-.2 E -.067(ing strings; the)180 588 R 2.567(yu)-.15 G .067(se ASCII ordering.) +.067(ing strings; the)180 648 R 2.567(yu)-.15 G .067(se ASCII ordering.) -2.567 F .068(Bash v)5.068 F .068 -(ersions prior to bash-4.1 use ASCII collation)-.15 F(and)180 600 Q F3 +(ersions prior to bash-4.1 use ASCII collation)-.15 F(and)180 660 Q F1 (str)4.743 E(cmp)-.37 E F0 1.903 (\(3\); bash-4.1 and later use the current locale').19 F 4.402(sc)-.55 G -1.902(ollation sequence and)-4.402 F F3(str)4.742 E(-)-.2 E(coll)180 612 -Q F0(\(3\).).51 E F1(compat41)108 628.8 Q F0<83>144 640.8 Q(in)180 640.8 -Q F3(posix)3.79 E F0(mode,)3.79 E F1(time)3.79 E F0 1.29(may be follo) +1.902(ollation sequence and)-4.402 F F1(str)4.742 E(-)-.2 E(coll)180 672 +Q F0(\(3\).).51 E F2(compat41)108 688.8 Q F0<83>144 700.8 Q(in)180 700.8 +Q F1(posix)3.79 E F0(mode,)3.79 E F2(time)3.79 E F0 1.29(may be follo) 3.79 F 1.29(wed by options and still be recognized as a reserv)-.25 F -(ed)-.15 E -.1(wo)180 652.8 S(rd \(this is POSIX interpretation 267\)).1 -E<83>144 664.8 Q(in)180 664.8 Q F3(posix)2.709 E F0 .208 -(mode, the parser requires that an e)2.709 F -.15(ve)-.25 G 2.708(nn).15 -G .208(umber of single quotes occur in the)-2.708 F F3(wor)2.708 E(d) --.37 E F0 .281(portion of a double-quoted parameter e)180 676.8 R .282 -(xpansion and treats them specially)-.15 F 2.782(,s)-.65 G 2.782(ot) --2.782 G .282(hat charac-)-2.782 F(ters within the single quotes are co\ -nsidered quoted \(this is POSIX interpretation 221\))180 688.8 Q F1 -(compat42)108 705.6 Q F0<83>144 717.6 Q 1.056(the replacement string in\ - double-quoted pattern substitution does not under)180 717.6 R 1.055 -(go quote re-)-.18 F(mo)180 729.6 Q -.25(va)-.15 G(l, as it does in v) -.25 E(ersions after bash-4.2)-.15 E(GNU Bash 5.2)72 768 Q -(2022 September 19)135.955 E(84)185.115 E 0 Cg EP +(ed)-.15 E -.1(wo)180 712.8 S(rd \(this is POSIX interpretation 267\)).1 +E(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(84)188.455 E 0 Cg EP %%Page: 85 85 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S 137.14(SH\(1\) General).35 F -(Commands Manual)2.5 E -.35(BA)139.64 G(SH\(1\)).35 E<83>144 84 Q .021 -(in posix mode, single quotes are considered special when e)180 84 R -.021(xpanding the)-.15 F/F1 10/Times-Italic@0 SF(wor)2.521 E(d)-.37 E F0 -.021(portion of a)2.521 F .018(double-quoted parameter e)180 96 R .017 +(Commands Manual)2.5 E -.35(BA)139.64 G(SH\(1\)).35 E<83>144 84 Q(in)180 +84 Q/F1 10/Times-Italic@0 SF(posix)2.709 E F0 .208 +(mode, the parser requires that an e)2.709 F -.15(ve)-.25 G 2.708(nn).15 +G .208(umber of single quotes occur in the)-2.708 F F1(wor)2.708 E(d) +-.37 E F0 .281(portion of a double-quoted parameter e)180 96 R .282 +(xpansion and treats them specially)-.15 F 2.782(,s)-.65 G 2.782(ot) +-2.782 G .282(hat charac-)-2.782 F(ters within the single quotes are co\ +nsidered quoted \(this is POSIX interpretation 221\))180 108 Q/F2 10 +/Times-Bold@0 SF(compat42)108 124.8 Q F0<83>144 136.8 Q 1.056(the repla\ +cement string in double-quoted pattern substitution does not under)180 +136.8 R 1.055(go quote re-)-.18 F(mo)180 148.8 Q -.25(va)-.15 G +(l, as it does in v).25 E(ersions after bash-4.2)-.15 E<83>144 160.8 Q +.021(in posix mode, single quotes are considered special when e)180 +160.8 R .021(xpanding the)-.15 F F1(wor)2.521 E(d)-.37 E F0 .021 +(portion of a)2.521 F .018(double-quoted parameter e)180 172.8 R .017 (xpansion and can be used to quote a closing brace or other spe-)-.15 F .998(cial character \(this is part of POSIX interpretation 221\); in la\ -ter v)180 108 R .999(ersions, single quotes)-.15 F -(are not special within double-quoted w)180 120 Q(ord e)-.1 E(xpansions) --.15 E/F2 10/Times-Bold@0 SF(compat43)108 136.8 Q F0<83>144 148.8 Q -1.071(the shell does not print a w)180 148.8 R 1.07 +ter v)180 184.8 R .999(ersions, single quotes)-.15 F +(are not special within double-quoted w)180 196.8 Q(ord e)-.1 E +(xpansions)-.15 E F2(compat43)108 213.6 Q F0<83>144 225.6 Q 1.071 +(the shell does not print a w)180 225.6 R 1.07 (arning message if an attempt is made to use a quoted com-)-.1 F .71 -(pound assignment as an ar)180 160.8 R .711 +(pound assignment as an ar)180 237.6 R .711 (gument to declare \(e.g., declare -a foo=\010\(1 2\)\010\). Later v) --.18 F(ersions)-.15 E -.1(wa)180 172.8 S -(rn that this usage is deprecated).1 E<83>144 184.8 Q -.1(wo)180 184.8 S +-.18 F(ersions)-.15 E -.1(wa)180 249.6 S +(rn that this usage is deprecated).1 E<83>144 261.6 Q -.1(wo)180 261.6 S .501(rd e).1 F .501(xpansion errors are considered non-f)-.15 F .501 -(atal errors that cause the current command to)-.1 F -.1(fa)180 196.8 S +(atal errors that cause the current command to)-.1 F -.1(fa)180 273.6 S .605(il, e).1 F -.15(ve)-.25 G 3.105(ni).15 G 3.105(np)-3.105 G .605 (osix mode \(the def)-3.105 F .605(ault beha)-.1 F .605(vior is to mak) -.2 F 3.105(et)-.1 G .605(hem f)-3.105 F .605 -(atal errors that cause the)-.1 F(shell to e)180 208.8 Q(xit\))-.15 E -<83>144 220.8 Q .355(when e)180 220.8 R -.15(xe)-.15 G .354 +(atal errors that cause the)-.1 F(shell to e)180 285.6 Q(xit\))-.15 E +<83>144 297.6 Q .355(when e)180 297.6 R -.15(xe)-.15 G .354 (cuting a shell function, the loop state \(while/until/etc.\)).15 F .354 (is not reset, so)5.354 F F2(br)2.854 E(eak)-.18 E F0(or)2.854 E F2 -(continue)180 232.8 Q F0 .052 +(continue)180 309.6 Q F0 .052 (in that function will break or continue loops in the calling conte) 2.552 F .053(xt. Bash-4.4 and)-.15 F(later reset the loop state to pre) -180 244.8 Q -.15(ve)-.25 G(nt this).15 E F2(compat44)108 261.6 Q F0<83> -144 273.6 Q .719(the shell sets up the v)180 273.6 R .719(alues used by) +180 321.6 Q -.15(ve)-.25 G(nt this).15 E F2(compat44)108 338.4 Q F0<83> +144 350.4 Q .719(the shell sets up the v)180 350.4 R .719(alues used by) -.25 F/F3 9/Times-Bold@0 SF -.27(BA)3.219 G(SH_ARGV).27 E F0(and)2.969 E F3 -.27(BA)3.219 G(SH_ARGC).27 E F0 .719(so the)2.969 F 3.218(yc)-.15 G -.718(an e)-3.218 F(xpand)-.15 E(to the shell')180 285.6 Q 2.5(sp)-.55 G +.718(an e)-3.218 F(xpand)-.15 E(to the shell')180 362.4 Q 2.5(sp)-.55 G (ositional parameters e)-2.5 E -.15(ve)-.25 G 2.5(ni).15 G 2.5(fe)-2.5 G -(xtended deb)-2.65 E(ugging mode is not enabled)-.2 E<83>144 297.6 Q -2.634(as)180 297.6 S .134(ubshell inherits loops from its parent conte) +(xtended deb)-2.65 E(ugging mode is not enabled)-.2 E<83>144 374.4 Q +2.634(as)180 374.4 S .134(ubshell inherits loops from its parent conte) -2.634 F .135(xt, so)-.15 F F2(br)2.635 E(eak)-.18 E F0(or)2.635 E F2 (continue)2.635 E F0 .135(will cause the sub-)2.635 F(shell to e)180 -309.6 Q 2.5(xit. Bash-5.0)-.15 F(and later reset the loop state to pre) -2.5 E -.15(ve)-.25 G(nt the e).15 E(xit)-.15 E<83>144 321.6 Q -.25(va) -180 321.6 S .619(riable assignments preceding b).25 F .618(uiltins lik) +386.4 Q 2.5(xit. Bash-5.0)-.15 F(and later reset the loop state to pre) +2.5 E -.15(ve)-.25 G(nt the e).15 E(xit)-.15 E<83>144 398.4 Q -.25(va) +180 398.4 S .619(riable assignments preceding b).25 F .618(uiltins lik) -.2 F(e)-.1 E F2(export)3.118 E F0(and)3.118 E F2 -.18(re)3.118 G (adonly).18 E F0 .618(that set attrib)3.118 F .618(utes con-)-.2 F .119 -(tinue to af)180 333.6 R .119(fect v)-.25 F .119 +(tinue to af)180 410.4 R .119(fect v)-.25 F .119 (ariables with the same name in the calling en)-.25 F .12(vironment e) -.4 F -.15(ve)-.25 G 2.62(ni).15 G 2.62(ft)-2.62 G .12(he shell is)-2.62 -F(not in posix mode)180 345.6 Q F2(compat50)108 362.4 Q F0<83>144 374.4 -Q 1.209(Bash-5.1 changed the w)180 374.4 R(ay)-.1 E F3($RANDOM)3.709 E +F(not in posix mode)180 422.4 Q F2(compat50)108 439.2 Q F0<83>144 451.2 +Q 1.209(Bash-5.1 changed the w)180 451.2 R(ay)-.1 E F3($RANDOM)3.709 E F0 1.209(is generated to introduce slightly more random-)3.459 F 1.018 -(ness. If the shell compatibility le)180 386.4 R -.15(ve)-.25 G 3.518 +(ness. If the shell compatibility le)180 463.2 R -.15(ve)-.25 G 3.518 (li).15 G 3.518(ss)-3.518 G 1.018(et to 50 or lo)-3.518 F(wer)-.25 E 3.518(,i)-.4 G 3.518(tr)-3.518 G -2.15 -.25(ev e)-3.518 H 1.019 -(rts to the method from).25 F .733(bash-5.0 and pre)180 398.4 R .733 +(rts to the method from).25 F .733(bash-5.0 and pre)180 475.2 R .733 (vious v)-.25 F .732 (ersions, so seeding the random number generator by assigning a)-.15 F --.25(va)180 410.4 S(lue to).25 E F3(RANDOM)2.5 E F0 -(will produce the same sequence as in bash-5.0)2.25 E<83>144 422.4 Q -.695(If the command hash table is empty)180 422.4 R 3.196(,b)-.65 G .696 +-.25(va)180 487.2 S(lue to).25 E F3(RANDOM)2.5 E F0 +(will produce the same sequence as in bash-5.0)2.25 E<83>144 499.2 Q +.695(If the command hash table is empty)180 499.2 R 3.196(,b)-.65 G .696 (ash v)-3.196 F .696(ersions prior to bash-5.1 printed an informa-)-.15 -F 1.321(tional message to that ef)180 434.4 R 1.321(fect, e)-.25 F -.15 +F 1.321(tional message to that ef)180 511.2 R 1.321(fect, e)-.25 F -.15 (ve)-.25 G 3.821(nw).15 G 1.321 (hen producing output that can be reused as input.)-3.821 F -(Bash-5.1 suppresses that message when the)180 446.4 Q F22.5 E F0 -(option is supplied.)2.5 E F2(compat51)108 463.2 Q F0<83>144 475.2 Q -(The)180 475.2 Q F2(unset)2.954 E F0 -.2(bu)2.954 G .454 +(Bash-5.1 suppresses that message when the)180 523.2 Q F22.5 E F0 +(option is supplied.)2.5 E F2(compat51)108 540 Q F0<83>144 552 Q(The)180 +552 Q F2(unset)2.954 E F0 -.2(bu)2.954 G .454 (iltin treats attempts to unset array subscripts).2 F F2(@)2.955 E F0 (and)2.955 E F2(*)2.955 E F0(dif)2.955 E .455(ferently depending)-.25 F -(on whether the array is inde)180 487.2 Q -.15(xe)-.15 G 2.5(do).15 G -2.5(ra)-2.5 G(ssociati)-2.5 E -.15(ve)-.25 G 2.5(,a).15 G(nd dif)-2.5 E +(on whether the array is inde)180 564 Q -.15(xe)-.15 G 2.5(do).15 G 2.5 +(ra)-2.5 G(ssociati)-2.5 E -.15(ve)-.25 G 2.5(,a).15 G(nd dif)-2.5 E (ferently than in pre)-.25 E(vious v)-.25 E(ersions.)-.15 E/F4 10.95 -/Times-Bold@0 SF(RESTRICTED SHELL)72 504 Q F0(If)108 516 Q F2(bash)3.582 -E F0 1.081(is started with the name)3.581 F F2(rbash)3.581 E F0 3.581 -(,o)C 3.581(rt)-3.581 G(he)-3.581 E F23.581 E F0 1.081 +/Times-Bold@0 SF(RESTRICTED SHELL)72 580.8 Q F0(If)108 592.8 Q F2(bash) +3.582 E F0 1.081(is started with the name)3.581 F F2(rbash)3.581 E F0 +3.581(,o)C 3.581(rt)-3.581 G(he)-3.581 E F23.581 E F0 1.081 (option is supplied at in)3.581 F -.2(vo)-.4 G 1.081 -(cation, the shell becomes re-).2 F 2.976(stricted. A)108 528 R .476 +(cation, the shell becomes re-).2 F 2.976(stricted. A)108 604.8 R .476 (restricted shell is used to set up an en)2.976 F .476 (vironment more controlled than the standard shell.)-.4 F .477(It be-) -5.477 F(ha)108 540 Q -.15(ve)-.2 G 2.5(si).15 G(dentically to)-2.5 E F2 -(bash)2.5 E F0(with the e)2.5 E(xception that the follo)-.15 E -(wing are disallo)-.25 E(wed or not performed:)-.25 E<83>108 556.8 Q -(changing directories with)144 556.8 Q F2(cd)2.5 E F0<83>108 573.6 Q -(setting or unsetting the v)144 573.6 Q(alues of)-.25 E F3(SHELL)2.5 E +5.477 F(ha)108 616.8 Q -.15(ve)-.2 G 2.5(si).15 G(dentically to)-2.5 E +F2(bash)2.5 E F0(with the e)2.5 E(xception that the follo)-.15 E +(wing are disallo)-.25 E(wed or not performed:)-.25 E<83>108 633.6 Q +(changing directories with)144 633.6 Q F2(cd)2.5 E F0<83>108 650.4 Q +(setting or unsetting the v)144 650.4 Q(alues of)-.25 E F3(SHELL)2.5 E /F5 9/Times-Roman@0 SF(,)A F3 -.666(PA)2.25 G(TH)-.189 E F5(,)A F3 (HISTFILE)2.25 E F5(,)A F3(ENV)2.25 E F5(,)A F0(or)2.25 E F3 -.27(BA)2.5 -G(SH_ENV).27 E F0<83>108 590.4 Q(specifying command names containing)144 -590.4 Q F2(/)2.5 E F0<83>108 607.2 Q -(specifying a \214lename containing a)144 607.2 Q F2(/)2.5 E F0 -(as an ar)2.5 E(gument to the)-.18 E F2(.)2.5 E F0 -.2(bu)5 G -(iltin command).2 E<83>108 624 Q -(specifying a \214lename containing a slash as an ar)144 624 Q +G(SH_ENV).27 E F0<83>108 667.2 Q(specifying command names containing)144 +667.2 Q F2(/)2.5 E F0<83>108 684 Q(specifying a \214lename containing a) +144 684 Q F2(/)2.5 E F0(as an ar)2.5 E(gument to the)-.18 E F2(.)2.5 E +F0 -.2(bu)5 G(iltin command).2 E<83>108 700.8 Q +(specifying a \214lename containing a slash as an ar)144 700.8 Q (gument to the)-.18 E F2(history)2.5 E F0 -.2(bu)2.5 G(iltin command).2 -E<83>108 640.8 Q .45 -(specifying a \214lename containing a slash as an ar)144 640.8 R .449 +E<83>108 717.6 Q .45 +(specifying a \214lename containing a slash as an ar)144 717.6 R .449 (gument to the)-.18 F F22.949 E F0 .449(option to the)2.949 F F2 -(hash)2.949 E F0 -.2(bu)2.949 G .449(iltin com-).2 F(mand)144 652.8 Q -<83>108 669.6 Q(importing function de\214nitions from the shell en)144 -669.6 Q(vironment at startup)-.4 E<83>108 686.4 Q(parsing the v)144 -686.4 Q(alue of)-.25 E F3(SHELLOPTS)2.5 E F0(from the shell en)2.25 E -(vironment at startup)-.4 E<83>108 703.2 Q(redirecting output using the\ - >, >|, <>, >&, &>, and >> redirection operators)144 703.2 Q -(GNU Bash 5.2)72 768 Q(2022 September 19)135.955 E(85)185.115 E 0 Cg EP +(hash)2.949 E F0 -.2(bu)2.949 G .449(iltin com-).2 F(mand)144 729.6 Q +(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(85)188.455 E 0 Cg EP %%Page: 86 86 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S 137.14(SH\(1\) General).35 F (Commands Manual)2.5 E -.35(BA)139.64 G(SH\(1\)).35 E<83>108 84 Q -(using the)144 84 Q/F1 10/Times-Bold@0 SF(exec)2.5 E F0 -.2(bu)2.5 G +(importing function de\214nitions from the shell en)144 84 Q +(vironment at startup)-.4 E<83>108 100.8 Q(parsing the v)144 100.8 Q +(alue of)-.25 E/F1 9/Times-Bold@0 SF(SHELLOPTS)2.5 E F0 +(from the shell en)2.25 E(vironment at startup)-.4 E<83>108 117.6 Q(red\ +irecting output using the >, >|, <>, >&, &>, and >> redirection operato\ +rs)144 117.6 Q<83>108 134.4 Q(using the)144 134.4 Q/F2 10/Times-Bold@0 +SF(exec)2.5 E F0 -.2(bu)2.5 G (iltin command to replace the shell with another command).2 E<83>108 -100.8 Q(adding or deleting b)144 100.8 Q(uiltin commands with the)-.2 E -F12.5 E F0(and)2.5 E F12.5 E F0(options to the)2.5 E F1 -(enable)2.5 E F0 -.2(bu)2.5 G(iltin command).2 E<83>108 117.6 Q -(using the)144 117.6 Q F1(enable)2.5 E F0 -.2(bu)2.5 G +151.2 Q(adding or deleting b)144 151.2 Q(uiltin commands with the)-.2 E +F22.5 E F0(and)2.5 E F22.5 E F0(options to the)2.5 E F2 +(enable)2.5 E F0 -.2(bu)2.5 G(iltin command).2 E<83>108 168 Q(using the) +144 168 Q F2(enable)2.5 E F0 -.2(bu)2.5 G (iltin command to enable disabled shell b).2 E(uiltins)-.2 E<83>108 -134.4 Q(specifying the)144 134.4 Q F12.5 E F0(option to the)2.5 E -F1(command)2.5 E F0 -.2(bu)2.5 G(iltin command).2 E<83>108 151.2 Q -(turning of)144 151.2 Q 2.5(fr)-.25 G(estricted mode with)-2.5 E F1 -(set +r)2.5 E F0(or)2.5 E F1(shopt -u r)2.5 E(estricted_shell)-.18 E F0 -(.)A(These restrictions are enforced after an)108 168 Q 2.5(ys)-.15 G +184.8 Q(specifying the)144 184.8 Q F22.5 E F0(option to the)2.5 E +F2(command)2.5 E F0 -.2(bu)2.5 G(iltin command).2 E<83>108 201.6 Q +(turning of)144 201.6 Q 2.5(fr)-.25 G(estricted mode with)-2.5 E F2 +(set +r)2.5 E F0(or)2.5 E F2(shopt -u r)2.5 E(estricted_shell)-.18 E F0 +(.)A(These restrictions are enforced after an)108 218.4 Q 2.5(ys)-.15 G (tartup \214les are read.)-2.5 E 1.566 -(When a command that is found to be a shell script is e)108 184.8 R -.15 -(xe)-.15 G 1.567(cuted \(see).15 F/F2 9/Times-Bold@0 SF 1.567 -(COMMAND EXECUTION)4.067 F F0(abo)3.817 E -.15(ve)-.15 G(\),).15 E F1 -(rbash)108 196.8 Q F0(turns of)2.5 E 2.5(fa)-.25 G .3 -.15(ny r)-2.5 H -(estrictions in the shell spa).15 E(wned to e)-.15 E -.15(xe)-.15 G -(cute the script.).15 E/F3 10.95/Times-Bold@0 SF(SEE ALSO)72 213.6 Q/F4 -10/Times-Italic@0 SF(Bash Refer)108 225.6 Q(ence Manual)-.37 E F0 2.5 -(,B)C(rian F)-2.5 E(ox and Chet Rame)-.15 E(y)-.15 E F4 -(The Gnu Readline Libr)108 237.6 Q(ary)-.15 E F0 2.5(,B)C(rian F)-2.5 E -(ox and Chet Rame)-.15 E(y)-.15 E F4(The Gnu History Libr)108 249.6 Q -(ary)-.15 E F0 2.5(,B)C(rian F)-2.5 E(ox and Chet Rame)-.15 E(y)-.15 E -F4 -.8(Po)108 261.6 S(rtable Oper).8 E +(When a command that is found to be a shell script is e)108 235.2 R -.15 +(xe)-.15 G 1.567(cuted \(see).15 F F1 1.567(COMMAND EXECUTION)4.067 F F0 +(abo)3.817 E -.15(ve)-.15 G(\),).15 E F2(rbash)108 247.2 Q F0(turns of) +2.5 E 2.5(fa)-.25 G .3 -.15(ny r)-2.5 H(estrictions in the shell spa).15 +E(wned to e)-.15 E -.15(xe)-.15 G(cute the script.).15 E/F3 10.95 +/Times-Bold@0 SF(SEE ALSO)72 264 Q/F4 10/Times-Italic@0 SF(Bash Refer) +108 276 Q(ence Manual)-.37 E F0 2.5(,B)C(rian F)-2.5 E(ox and Chet Rame) +-.15 E(y)-.15 E F4(The Gnu Readline Libr)108 288 Q(ary)-.15 E F0 2.5(,B) +C(rian F)-2.5 E(ox and Chet Rame)-.15 E(y)-.15 E F4 +(The Gnu History Libr)108 300 Q(ary)-.15 E F0 2.5(,B)C(rian F)-2.5 E +(ox and Chet Rame)-.15 E(y)-.15 E F4 -.8(Po)108 312 S(rtable Oper).8 E (ating System Interface \(POSIX\) P)-.15 E(art 2: Shell and Utilities) --.8 E F0 2.5(,I)C(EEE --)-2.5 E(http://pubs.opengroup.or)144 273.6 Q -(g/onlinepubs/9699919799/)-.18 E(http://tiswww)108 285.6 Q +-.8 E F0 2.5(,I)C(EEE --)-2.5 E(http://pubs.opengroup.or)144 324 Q +(g/onlinepubs/9699919799/)-.18 E(http://tiswww)108 336 Q (.case.edu/~chet/bash/POSIX -- a description of posix mode)-.65 E F4(sh) -108 297.6 Q F0(\(1\),)A F4(ksh)2.5 E F0(\(1\),)A F4(csh)2.5 E F0(\(1\))A -F4(emacs)108 309.6 Q F0(\(1\),)A F4(vi)2.5 E F0(\(1\))A F4 -.37(re)108 -321.6 S(adline).37 E F0(\(3\))A F3(FILES)72 338.4 Q F4(/bin/bash)109.666 -350.4 Q F0(The)144 362.4 Q F1(bash)2.5 E F0 -.15(exe)2.5 G(cutable).15 E -F4(/etc/pr)109.666 374.4 Q(o\214le)-.45 E F0 -(The systemwide initialization \214le, e)144 386.4 Q -.15(xe)-.15 G -(cuted for login shells).15 E F4(~/.bash_pr)109.666 398.4 Q(o\214le)-.45 -E F0(The personal initialization \214le, e)144 410.4 Q -.15(xe)-.15 G -(cuted for login shells).15 E F4(~/.bashr)109.666 422.4 Q(c)-.37 E F0 -(The indi)144 434.4 Q(vidual per)-.25 E(-interacti)-.2 E -.15(ve)-.25 G -(-shell startup \214le).15 E F4(~/.bash_lo)109.666 446.4 Q(gout)-.1 E F0 -(The indi)144 458.4 Q(vidual login shell cleanup \214le, e)-.25 E -.15 +108 348 Q F0(\(1\),)A F4(ksh)2.5 E F0(\(1\),)A F4(csh)2.5 E F0(\(1\))A +F4(emacs)108 360 Q F0(\(1\),)A F4(vi)2.5 E F0(\(1\))A F4 -.37(re)108 372 +S(adline).37 E F0(\(3\))A F3(FILES)72 388.8 Q F4(/bin/bash)109.666 400.8 +Q F0(The)144 412.8 Q F2(bash)2.5 E F0 -.15(exe)2.5 G(cutable).15 E F4 +(/etc/pr)109.666 424.8 Q(o\214le)-.45 E F0 +(The systemwide initialization \214le, e)144 436.8 Q -.15(xe)-.15 G +(cuted for login shells).15 E F4(~/.bash_pr)109.666 448.8 Q(o\214le)-.45 +E F0(The personal initialization \214le, e)144 460.8 Q -.15(xe)-.15 G +(cuted for login shells).15 E F4(~/.bashr)109.666 472.8 Q(c)-.37 E F0 +(The indi)144 484.8 Q(vidual per)-.25 E(-interacti)-.2 E -.15(ve)-.25 G +(-shell startup \214le).15 E F4(~/.bash_lo)109.666 496.8 Q(gout)-.1 E F0 +(The indi)144 508.8 Q(vidual login shell cleanup \214le, e)-.25 E -.15 (xe)-.15 G(cuted when a login shell e).15 E(xits)-.15 E F4 -(~/.bash_history)109.666 470.4 Q F0(The def)144 482.4 Q(ault v)-.1 E -(alue of)-.25 E F1(HISTFILE)2.5 E F0 2.5(,t)C +(~/.bash_history)109.666 520.8 Q F0(The def)144 532.8 Q(ault v)-.1 E +(alue of)-.25 E F2(HISTFILE)2.5 E F0 2.5(,t)C (he \214le in which bash sa)-2.5 E -.15(ve)-.2 G 2.5(st).15 G -(he command history)-2.5 E F4(~/.inputr)109.666 494.4 Q(c)-.37 E F0 -(Indi)144 506.4 Q(vidual)-.25 E F4 -.37(re)2.5 G(adline).37 E F0 -(initialization \214le)2.5 E F3 -.548(AU)72 523.2 S(THORS).548 E F0 -(Brian F)108 535.2 Q(ox, Free Softw)-.15 E(are F)-.1 E(oundation)-.15 E -(bfox@gnu.or)108 547.2 Q(g)-.18 E(Chet Rame)108 564 Q 1.3 -.65(y, C)-.15 -H(ase W).65 E(estern Reserv)-.8 E 2.5(eU)-.15 G(ni)-2.5 E -.15(ve)-.25 G -(rsity).15 E(chet.rame)108 576 Q(y@case.edu)-.15 E F3 -.11(BU)72 592.8 S -2.738(GR).11 G(EPOR)-2.738 E(TS)-.438 E F0 .568(If you \214nd a b)108 -604.8 R .568(ug in)-.2 F F1(bash,)3.068 E F0 .568(you should report it.) -3.068 F .568(But \214rst, you should mak)5.568 F 3.068(es)-.1 G .568 -(ure that it really is a b)-3.068 F .567(ug, and)-.2 F 5.625 -(that it appears in the latest v)108 616.8 R 5.625(ersion of)-.15 F F1 -(bash)8.125 E F0 10.625(.T)C 5.625(he latest v)-10.625 F 5.626 +(he command history)-2.5 E F4(~/.inputr)109.666 544.8 Q(c)-.37 E F0 +(Indi)144 556.8 Q(vidual)-.25 E F4 -.37(re)2.5 G(adline).37 E F0 +(initialization \214le)2.5 E F3 -.548(AU)72 573.6 S(THORS).548 E F0 +(Brian F)108 585.6 Q(ox, Free Softw)-.15 E(are F)-.1 E(oundation)-.15 E +(bfox@gnu.or)108 597.6 Q(g)-.18 E(Chet Rame)108 614.4 Q 1.3 -.65(y, C) +-.15 H(ase W).65 E(estern Reserv)-.8 E 2.5(eU)-.15 G(ni)-2.5 E -.15(ve) +-.25 G(rsity).15 E(chet.rame)108 626.4 Q(y@case.edu)-.15 E F3 -.11(BU)72 +643.2 S 2.738(GR).11 G(EPOR)-2.738 E(TS)-.438 E F0 .568 +(If you \214nd a b)108 655.2 R .568(ug in)-.2 F F2(bash,)3.068 E F0 .568 +(you should report it.)3.068 F .568(But \214rst, you should mak)5.568 F +3.068(es)-.1 G .568(ure that it really is a b)-3.068 F .567(ug, and)-.2 +F 5.625(that it appears in the latest v)108 667.2 R 5.625(ersion of)-.15 +F F2(bash)8.125 E F0 10.625(.T)C 5.625(he latest v)-10.625 F 5.626 (ersion is al)-.15 F -.1(wa)-.1 G 5.626(ys a).1 F -.25(va)-.2 G 5.626 -(ilable from).25 F F4(ftp://ftp.gnu.or)108 628.8 Q(g/pub/gnu/bash/)-.37 +(ilable from).25 F F4(ftp://ftp.gnu.or)108 679.2 Q(g/pub/gnu/bash/)-.37 E F0(and)2.5 E F4(http://git.savannah.gnu.or)2.5 E (g/cgit/bash.git/snapshot/bash-master)-.37 E(.tar)-1.11 E(.gz)-1.11 E F0 -(.)A .411(Once you ha)108 645.6 R .711 -.15(ve d)-.2 H .411 +(.)A .411(Once you ha)108 696 R .711 -.15(ve d)-.2 H .411 (etermined that a b).15 F .411(ug actually e)-.2 F .411(xists, use the) -.15 F F4(bashb)3.18 E(ug)-.2 E F0 .41(command to submit a b)3.13 F .41 -(ug report.)-.2 F(If)5.41 E .594(you ha)108 657.6 R .894 -.15(ve a \214) +(ug report.)-.2 F(If)5.41 E .594(you ha)108 708 R .894 -.15(ve a \214) -.2 H .595(x, you are encouraged to mail that as well!).15 F .595 (Suggestions and `philosophical' b)5.595 F .595(ug reports may)-.2 F -(be mailed to)108 669.6 Q F4 -.2(bu)2.5 G(g-bash@gnu.or).2 E(g)-.37 E F0 -(or posted to the Usenet ne)2.5 E(wsgroup)-.25 E F1(gnu.bash.b)2.5 E(ug) --.2 E F0(.)A(ALL b)108 686.4 Q(ug reports should include:)-.2 E(The v) -108 703.2 Q(ersion number of)-.15 E F1(bash)2.5 E F0(GNU Bash 5.2)72 768 -Q(2022 September 19)135.955 E(86)185.115 E 0 Cg EP +(be mailed to)108 720 Q F4 -.2(bu)2.5 G(g-bash@gnu.or).2 E(g)-.37 E F0 +(or posted to the Usenet ne)2.5 E(wsgroup)-.25 E F2(gnu.bash.b)2.5 E(ug) +-.2 E F0(.)A(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 E(86)188.455 +E 0 Cg EP %%Page: 87 87 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S 137.14(SH\(1\) General).35 F -(Commands Manual)2.5 E -.35(BA)139.64 G(SH\(1\)).35 E(The hardw)108 84 Q -(are and operating system)-.1 E(The compiler used to compile)108 96 Q -2.5(Ad)108 108 S(escription of the b)-2.5 E(ug beha)-.2 E(viour)-.2 E -2.5(As)108 120 S(hort script or `recipe' which e)-2.5 E -.15(xe)-.15 G -(rcises the b).15 E(ug)-.2 E/F1 10/Times-Italic@0 SF(bashb)108.27 136.8 +(Commands Manual)2.5 E -.35(BA)139.64 G(SH\(1\)).35 E(ALL b)108 84 Q +(ug reports should include:)-.2 E(The v)108 100.8 Q(ersion number of) +-.15 E/F1 10/Times-Bold@0 SF(bash)2.5 E F0(The hardw)108 112.8 Q +(are and operating system)-.1 E(The compiler used to compile)108 124.8 Q +2.5(Ad)108 136.8 S(escription of the b)-2.5 E(ug beha)-.2 E(viour)-.2 E +2.5(As)108 148.8 S(hort script or `recipe' which e)-2.5 E -.15(xe)-.15 G +(rcises the b).15 E(ug)-.2 E/F2 10/Times-Italic@0 SF(bashb)108.27 165.6 Q(ug)-.2 E F0 (inserts the \214rst three items automatically into the template it pro) 2.72 E(vides for \214ling a b)-.15 E(ug report.)-.2 E(Comments and b)108 -153.6 Q(ug reports concerning this manual page should be directed to)-.2 -E F1 -.15(ch)2.5 G(et.r).15 E(ame)-.15 E(y@case)-.3 E(.edu)-.15 E F0(.) -.25 E/F2 10.95/Times-Bold@0 SF -.11(BU)72 170.4 S(GS).11 E F0(It')108 -182.4 Q 2.5(st)-.55 G(oo big and too slo)-2.5 E -.65(w.)-.25 G 1.869 -(There are some subtle dif)108 199.2 R 1.869(ferences between)-.25 F/F3 -10/Times-Bold@0 SF(bash)4.369 E F0 1.869(and traditional v)4.369 F 1.869 -(ersions of)-.15 F F3(sh)4.368 E F0 4.368(,m)C 1.868 -(ostly because of the)-4.368 F/F4 9/Times-Bold@0 SF(POSIX)108 211.2 Q F0 -(speci\214cation.)2.25 E(Aliases are confusing in some uses.)108 228 Q -(Shell b)108 244.8 Q +182.4 Q(ug reports concerning this manual page should be directed to)-.2 +E F2 -.15(ch)2.5 G(et.r).15 E(ame)-.15 E(y@case)-.3 E(.edu)-.15 E F0(.) +.25 E/F3 10.95/Times-Bold@0 SF -.11(BU)72 199.2 S(GS).11 E F0(It')108 +211.2 Q 2.5(st)-.55 G(oo big and too slo)-2.5 E -.65(w.)-.25 G 1.869 +(There are some subtle dif)108 228 R 1.869(ferences between)-.25 F F1 +(bash)4.369 E F0 1.869(and traditional v)4.369 F 1.869(ersions of)-.15 F +F1(sh)4.368 E F0 4.368(,m)C 1.868(ostly because of the)-4.368 F/F4 9 +/Times-Bold@0 SF(POSIX)108 240 Q F0(speci\214cation.)2.25 E +(Aliases are confusing in some uses.)108 256.8 Q(Shell b)108 273.6 Q (uiltin commands and functions are not stoppable/restartable.)-.2 E 1.315(Compound commands and command sequences of the form `a ; b ; c' a\ -re not handled gracefully when)108 261.6 R .39 -(process suspension is attempted.)108 273.6 R .389 +re not handled gracefully when)108 290.4 R .39 +(process suspension is attempted.)108 302.4 R .389 (When a process is stopped, the shell immediately e)5.39 F -.15(xe)-.15 G .389(cutes the ne).15 F .389(xt com-)-.15 F .192 -(mand in the sequence.)108 285.6 R .192(It suf)5.192 F .192(\214ces to \ +(mand in the sequence.)108 314.4 R .192(It suf)5.192 F .192(\214ces to \ place the sequence of commands between parentheses to force it into a) --.25 F(subshell, which may be stopped as a unit.)108 297.6 Q(Array v)108 -314.4 Q(ariables may not \(yet\) be e)-.25 E(xported.)-.15 E -(There may be only one acti)108 331.2 Q .3 -.15(ve c)-.25 H -(oprocess at a time.).15 E(GNU Bash 5.2)72 768 Q(2022 September 19) -135.955 E(87)185.115 E 0 Cg EP +-.25 F(subshell, which may be stopped as a unit.)108 326.4 Q(Array v)108 +343.2 Q(ariables may not \(yet\) be e)-.25 E(xported.)-.15 E +(There may be only one acti)108 360 Q .3 -.15(ve c)-.25 H +(oprocess at a time.).15 E(GNU Bash 5.2)72 768 Q(2022 December 2)139.295 +E(87)188.455 E 0 Cg EP %%Trailer end %%EOF diff --git a/doc/bashref.bt b/doc/bashref.bt index bd1e73b7..dde0493d 100644 --- a/doc/bashref.bt +++ b/doc/bashref.bt @@ -19,7 +19,7 @@ \entry{trap}{54}{\code {trap}} \entry{umask}{55}{\code {umask}} \entry{unset}{55}{\code {unset}} -\entry{alias}{55}{\code {alias}} +\entry{alias}{56}{\code {alias}} \entry{bind}{56}{\code {bind}} \entry{builtin}{57}{\code {builtin}} \entry{caller}{57}{\code {caller}} @@ -35,11 +35,11 @@ \entry{printf}{62}{\code {printf}} \entry{read}{63}{\code {read}} \entry{readarray}{64}{\code {readarray}} -\entry{source}{64}{\code {source}} -\entry{type}{64}{\code {type}} +\entry{source}{65}{\code {source}} +\entry{type}{65}{\code {type}} \entry{typeset}{65}{\code {typeset}} \entry{ulimit}{65}{\code {ulimit}} -\entry{unalias}{66}{\code {unalias}} +\entry{unalias}{67}{\code {unalias}} \entry{set}{67}{\code {set}} \entry{shopt}{71}{\code {shopt}} \entry{dirs}{102}{\code {dirs}} diff --git a/doc/bashref.bts b/doc/bashref.bts index 633f6d19..871f6582 100644 --- a/doc/bashref.bts +++ b/doc/bashref.bts @@ -5,7 +5,7 @@ \initial {[} \entry{\code {[}}{52} \initial {A} -\entry{\code {alias}}{55} +\entry{\code {alias}}{56} \initial {B} \entry{\code {bg}}{114} \entry{\code {bind}}{56} @@ -63,18 +63,18 @@ \entry{\code {set}}{67} \entry{\code {shift}}{52} \entry{\code {shopt}}{71} -\entry{\code {source}}{64} +\entry{\code {source}}{65} \entry{\code {suspend}}{116} \initial {T} \entry{\code {test}}{52} \entry{\code {times}}{54} \entry{\code {trap}}{54} -\entry{\code {type}}{64} +\entry{\code {type}}{65} \entry{\code {typeset}}{65} \initial {U} \entry{\code {ulimit}}{65} \entry{\code {umask}}{55} -\entry{\code {unalias}}{66} +\entry{\code {unalias}}{67} \entry{\code {unset}}{55} \initial {W} \entry{\code {wait}}{115} diff --git a/doc/bashref.dvi b/doc/bashref.dvi index a7a571b8..56964f10 100644 Binary files a/doc/bashref.dvi and b/doc/bashref.dvi differ diff --git a/doc/bashref.html b/doc/bashref.html index 928b3ff1..63b2160a 100644 --- a/doc/bashref.html +++ b/doc/bashref.html @@ -4,9 +4,9 @@