diff --git a/CWRU/CWRU.chlog b/CWRU/CWRU.chlog index be0a0b8d..ab516a2b 100644 --- a/CWRU/CWRU.chlog +++ b/CWRU/CWRU.chlog @@ -7428,3 +7428,61 @@ MANIFEST lib/sh/unicode.c - u32cconv: prefer nl_langinfo to locale_charset like locale.c: locale_isutf8() + +execute_cmd.c + - uw_restore_lineno: an unwind-protect fuction to restore a saved + line_number + - execute_command: add an unwind-protect to restore line_number in + case execute_simple_command longjmps back to top_level or a + return context. + Side effect of https://savannah.gnu.org/support/index.php?110919 + - execute_for_command, execute_select_command, execute_case_command: + add unwind-protect to restore line_number (could also do it for + if, while, until but those don't modify line_number) + - execute_command_internal: add_unwind_protect to restore line number + for arith, cond, function def commands + + 8/14 + ---- +execute_cmd.c + - execute_simple_command: don't call savestring on the_printed_command_except_trap + if it's NULL. + From a report by Grisha Levit + + 8/15 + ---- +lib/readline/rltty.c + - prepare_terminal_settings: replace USE_XON_XOFF macro with private + variable _rl_use_tty_xon_xoff (initially set to 1); if it's set to + 0 disable the tty start and stop characters. Prep for making it a + bindable variable setting + +builtins/read.def + - edit_line: now takes a third argument saying whether or not to + set rl_attempted_completion_function to NULL to use readline's + default filename completion (the default) + - read_builtin: new option -E to use readline and use the bash + default completion (that is, leave rl_attempted_completion_function + unchanged) + From a suggestion by konsolebox back in 5/2021 + + +doc/bash.1,doc/bashref.texi + - read: document new -E option + + 8/17 + ---- +aclocal.m4 + - BASH_CHECK_LIB_TERMCAP: add a check for bash_cv_termcap_lib == + "libcurses"; set TERMCAP_LIB=-lcurses in this case + + 8/18 + ---- +subst.c + - bash_variable_assignment_error: new function, implements default mode + behavior for variable assignment errors + - posix_variable_assignment_error: new function, implements posix mode + behavior for variable assignment errors + - parameter_brace_expand_rhs,expand_declaration_argument, + do_assignment_statements: call posix_variable_assignment_error or + bash_variable_assignment_error as appropriate diff --git a/MANIFEST b/MANIFEST index 03859998..148b6172 100644 --- a/MANIFEST +++ b/MANIFEST @@ -731,7 +731,7 @@ support/fixlinks f 755 support/install.sh f 755 support/texi2dvi f 755 support/texi2html f 755 -support/xenix-link.sh f 755 +#support/xenix-link.sh f 755 support/shobj-conf f 755 support/rlvers.sh f 755 examples/INDEX.txt f diff --git a/aclocal.m4 b/aclocal.m4 index 96d63837..26af88aa 100644 --- a/aclocal.m4 +++ b/aclocal.m4 @@ -955,6 +955,9 @@ TERMCAP_DEP= elif test $bash_cv_termcap_lib = libncurses; then TERMCAP_LIB=-lncurses TERMCAP_DEP= +elif test $bash_cv_termcap_lib = libcurses; then +TERMCAP_LIB=-lcurses +TERMCAP_DEP= elif test $bash_cv_termcap_lib = libc; then TERMCAP_LIB= TERMCAP_DEP= diff --git a/builtins/read.def b/builtins/read.def index 49b64da7..1c528deb 100644 --- a/builtins/read.def +++ b/builtins/read.def @@ -22,7 +22,7 @@ $PRODUCES read.c $BUILTIN read $FUNCTION read_builtin -$SHORT_DOC read [-ers] [-a array] [-d delim] [-i text] [-n nchars] [-N nchars] [-p prompt] [-t timeout] [-u fd] [name ...] +$SHORT_DOC read [-Eers] [-a array] [-d delim] [-i text] [-n nchars] [-N nchars] [-p prompt] [-t timeout] [-u fd] [name ...] Read a line from the standard input and split it into fields. Reads a single line from the standard input, or from file descriptor FD @@ -41,6 +41,8 @@ Options: -d delim continue until the first character of DELIM is read, rather than newline -e use Readline to obtain the line + -E use Readline to obtain the line and use the bash default + completion instead of Readline's default completion -i text use TEXT as the initial text for Readline -n nchars return after reading NCHARS characters rather than waiting for a newline, but honor a delimiter if fewer than @@ -121,7 +123,7 @@ struct ttsave #if defined (READLINE) static void uw_reset_attempted_completion_function (void *); static int set_itext (void); -static char *edit_line (char *, char *); +static char *edit_line (char *, char *, int); static void set_eol_delim (int); static void reset_eol_delim (void *); static void set_readline_timeout (sh_timer *t, time_t, long); @@ -215,7 +217,8 @@ read_builtin (WORD_LIST *list) size_t size; volatile int i; int input_is_tty, input_is_pipe, unbuffered_read, skip_ctlesc, skip_ctlnul; - int raw, edit, nchars, silent, have_timeout, ignore_delim, fd; + int edit, use_bash_completion; + int raw, nchars, silent, have_timeout, ignore_delim, fd; int lastsig, t_errno; int mb_cur_max; unsigned int tmsec, tmusec; @@ -247,6 +250,7 @@ read_builtin (WORD_LIST *list) USE_VAR(input_is_pipe); /* USE_VAR(raw); */ USE_VAR(edit); + USE_VAR(use_bash_completion); USE_VAR(tmsec); USE_VAR(tmusec); USE_VAR(nchars); @@ -268,6 +272,7 @@ read_builtin (WORD_LIST *list) i = 0; /* Index into the string that we are reading. */ raw = edit = 0; /* Not reading raw input by default. */ + use_bash_completion = 0; silent = 0; arrayname = prompt = (char *)NULL; fd = 0; /* file descriptor to read from */ @@ -284,7 +289,7 @@ read_builtin (WORD_LIST *list) ignore_delim = nflag = 0; reset_internal_getopt (); - while ((opt = internal_getopt (list, "ersa:d:i:n:p:t:u:N:")) != -1) + while ((opt = internal_getopt (list, "Eersa:d:i:n:p:t:u:N:")) != -1) { switch (opt) { @@ -302,6 +307,12 @@ read_builtin (WORD_LIST *list) edit = 1; #endif break; + case 'E': +#if defined (READLINE) + edit = use_bash_completion = 1; +#endif + break; + case 'i': #if defined (READLINE) itext = list_optarg; @@ -649,7 +660,7 @@ read_builtin (WORD_LIST *list) if (rlbuf == 0) { reading = 1; - rlbuf = edit_line (prompt ? prompt : "", itext); + rlbuf = edit_line (prompt ? prompt : "", itext, use_bash_completion); reading = 0; rlind = 0; } @@ -1197,7 +1208,7 @@ set_itext (void) } static char * -edit_line (char *p, char *itext) +edit_line (char *p, char *itext, int keep_completion_func) { char *ret; size_t len; @@ -1206,7 +1217,10 @@ edit_line (char *p, char *itext) initialize_readline (); old_attempted_completion_function = rl_attempted_completion_function; - rl_attempted_completion_function = (rl_completion_func_t *)NULL; + /* If we don't indicate that we want to keep the attempted completion + function, reset it so we use the default readline word completion. */ + if (keep_completion_func == 0) + rl_attempted_completion_function = (rl_completion_func_t *)NULL; bashline_set_event_hook (); if (itext) { @@ -1217,7 +1231,8 @@ edit_line (char *p, char *itext) ret = readline (p); - rl_attempted_completion_function = old_attempted_completion_function; + if (keep_completion_func == 0) + rl_attempted_completion_function = old_attempted_completion_function; old_attempted_completion_function = (rl_completion_func_t *)NULL; bashline_reset_event_hook (); diff --git a/configure b/configure index 1814e7ca..8f855379 100755 --- a/configure +++ b/configure @@ -1,5 +1,5 @@ #! /bin/sh -# From configure.ac for Bash 5.3, version 5.056. +# From configure.ac for Bash 5.3, version 5.057. # Guess values for system-dependent variables and create Makefiles. # Generated by GNU Autoconf 2.71 for bash 5.3-devel. # @@ -5961,6 +5961,9 @@ TERMCAP_DEP= elif test $bash_cv_termcap_lib = libncurses; then TERMCAP_LIB=-lncurses TERMCAP_DEP= +elif test $bash_cv_termcap_lib = libcurses; then +TERMCAP_LIB=-lcurses +TERMCAP_DEP= elif test $bash_cv_termcap_lib = libc; then TERMCAP_LIB= TERMCAP_DEP= @@ -9055,8 +9058,8 @@ rm -f core conftest.err conftest.$ac_objext conftest.beam \ LIBS=$save_LIBS test $gl_pthread_api = yes && break done - echo "$as_me:9058: gl_pthread_api=$gl_pthread_api" >&5 - echo "$as_me:9059: LIBPTHREAD=$LIBPTHREAD" >&5 + echo "$as_me:9061: gl_pthread_api=$gl_pthread_api" >&5 + echo "$as_me:9062: LIBPTHREAD=$LIBPTHREAD" >&5 gl_pthread_in_glibc=no # On Linux with glibc >= 2.34, libc contains the fully functional @@ -9082,7 +9085,7 @@ rm -rf conftest* ;; esac - echo "$as_me:9085: gl_pthread_in_glibc=$gl_pthread_in_glibc" >&5 + echo "$as_me:9088: gl_pthread_in_glibc=$gl_pthread_in_glibc" >&5 # Test for libpthread by looking for pthread_kill. (Not pthread_self, # since it is defined as a macro on OSF/1.) @@ -9236,7 +9239,7 @@ fi fi fi - echo "$as_me:9239: LIBPMULTITHREAD=$LIBPMULTITHREAD" >&5 + echo "$as_me:9242: LIBPMULTITHREAD=$LIBPMULTITHREAD" >&5 fi { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether POSIX threads API is available" >&5 printf %s "checking whether POSIX threads API is available... " >&6; } @@ -9464,8 +9467,8 @@ rm -f core conftest.err conftest.$ac_objext conftest.beam \ LIBS=$save_LIBS test $gl_pthread_api = yes && break done - echo "$as_me:9467: gl_pthread_api=$gl_pthread_api" >&5 - echo "$as_me:9468: LIBPTHREAD=$LIBPTHREAD" >&5 + echo "$as_me:9470: gl_pthread_api=$gl_pthread_api" >&5 + echo "$as_me:9471: LIBPTHREAD=$LIBPTHREAD" >&5 gl_pthread_in_glibc=no # On Linux with glibc >= 2.34, libc contains the fully functional @@ -9491,7 +9494,7 @@ rm -rf conftest* ;; esac - echo "$as_me:9494: gl_pthread_in_glibc=$gl_pthread_in_glibc" >&5 + echo "$as_me:9497: gl_pthread_in_glibc=$gl_pthread_in_glibc" >&5 # Test for libpthread by looking for pthread_kill. (Not pthread_self, # since it is defined as a macro on OSF/1.) @@ -9645,7 +9648,7 @@ fi fi fi - echo "$as_me:9648: LIBPMULTITHREAD=$LIBPMULTITHREAD" >&5 + echo "$as_me:9651: LIBPMULTITHREAD=$LIBPMULTITHREAD" >&5 fi { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether POSIX threads API is available" >&5 printf %s "checking whether POSIX threads API is available... " >&6; } @@ -16449,6 +16452,12 @@ if test "x$ac_cv_func_dcgettext" = xyes then : printf "%s\n" "#define HAVE_DCGETTEXT 1" >>confdefs.h +fi +ac_fn_c_check_func "$LINENO" "locale_charset" "ac_cv_func_locale_charset" +if test "x$ac_cv_func_locale_charset" = xyes +then : + printf "%s\n" "#define HAVE_LOCALE_CHARSET 1" >>confdefs.h + fi ac_fn_c_check_func "$LINENO" "mempcpy" "ac_cv_func_mempcpy" if test "x$ac_cv_func_mempcpy" = xyes @@ -16487,6 +16496,9 @@ if test "x$USE_INCLUDED_LIBINTL" = "xyes"; then INTL_DEP='${INTL_LIBDIR}/libintl.a' INTL_INC='-I${INTL_LIBSRC} -I${INTL_BUILDDIR}' LIBINTL_H='${INTL_BUILDDIR}/libintl.h' + + printf "%s\n" "#define HAVE_LOCALE_CHARSET 1" >>confdefs.h + fi @@ -21832,6 +21844,9 @@ TERMCAP_DEP= elif test $bash_cv_termcap_lib = libncurses; then TERMCAP_LIB=-lncurses TERMCAP_DEP= +elif test $bash_cv_termcap_lib = libcurses; then +TERMCAP_LIB=-lcurses +TERMCAP_DEP= elif test $bash_cv_termcap_lib = libc; then TERMCAP_LIB= TERMCAP_DEP= diff --git a/configure.ac b/configure.ac index 4353e7fe..fa5f5747 100644 --- a/configure.ac +++ b/configure.ac @@ -21,7 +21,7 @@ dnl Process this file with autoconf to produce a configure script. # You should have received a copy of the GNU General Public License # along with this program. If not, see . -AC_REVISION([for Bash 5.3, version 5.056])dnl +AC_REVISION([for Bash 5.3, version 5.057])dnl define(bashvers, 5.3) define(relstatus, devel) @@ -927,7 +927,8 @@ AC_CHECK_HEADERS([argz.h errno.h fcntl.h malloc.h stdio_ext.h]) dnl AC_FUNC_MALLOC AC_DEFINE([HAVE_MALLOC]) AC_FUNC_MMAP -AC_CHECK_FUNCS([__argz_count __argz_next __argz_stringify dcgettext mempcpy \ +AC_CHECK_FUNCS([__argz_count __argz_next __argz_stringify dcgettext \ + locale_charset mempcpy \ munmap mremap stpcpy strcspn]) INTL_DEP= INTL_INC= LIBINTL_H= @@ -935,6 +936,8 @@ if test "x$USE_INCLUDED_LIBINTL" = "xyes"; then INTL_DEP='${INTL_LIBDIR}/libintl.a' INTL_INC='-I${INTL_LIBSRC} -I${INTL_BUILDDIR}' LIBINTL_H='${INTL_BUILDDIR}/libintl.h' + + AC_DEFINE([HAVE_LOCALE_CHARSET], 1) fi AC_SUBST(INTL_DEP) AC_SUBST(INTL_INC) diff --git a/doc/Makefile.in b/doc/Makefile.in index 62af8de4..856faf45 100644 --- a/doc/Makefile.in +++ b/doc/Makefile.in @@ -157,9 +157,9 @@ BASHREF_FILES = $(srcdir)/bashref.texi $(srcdir)/fdl.texi $(srcdir)/version.texi # $(RM) $@ # -${TEXI2PDF} $< -all: ps info dvi text html $(MAN2HTML) +all: info dvi text html pdf $(MAN2HTML) nodvi: ps info text html -everything: all pdf +everything: all ps PSFILES = bash.ps bashbug.ps article.ps builtins.ps rbash.ps DVIFILES = bashref.dvi bashref.ps diff --git a/doc/bash.0 b/doc/bash.0 index 59a02a79..cac619fc 100644 --- a/doc/bash.0 +++ b/doc/bash.0 @@ -4434,20 +4434,26 @@ HHIISSTTOORRYY EEXXPPAANNSSIIOONN line from the history list to use during substitution. The second is to select portions of that line for inclusion into the current one. The line selected from the history is the _e_v_e_n_t, and the portions of - that line that are acted upon are _w_o_r_d_s. Various _m_o_d_i_f_i_e_r_s are avail- - able to manipulate the selected words. The line is broken into words - in the same fashion as when reading input, so that several _m_e_t_a_c_h_a_r_a_c_- - _t_e_r-separated words surrounded by quotes are considered one word. His- - tory expansions are introduced by the appearance of the history expan- - sion character, which is !! by default. Only backslash (\\) and single - quotes can quote the history expansion character, but the history ex- - pansion character is also treated as quoted if it immediately precedes - the closing double quote in a double-quoted string. + that line that are acted upon are _w_o_r_d_s. The line is broken into words + in the same fashion as when reading input, so that several _m_e_t_a_c_h_a_r_a_c_- + _t_e_r-separated words surrounded by quotes are considered one word. The + _e_v_e_n_t _d_e_s_i_g_n_a_t_o_r selects the event, the optional _w_o_r_d _d_e_s_i_g_n_a_t_o_r se- + lects words from the event, and various optional _m_o_d_i_f_i_e_r_s are avail- + able to manipulate the selected words. + + History expansions are introduced by the appearance of the history ex- + pansion character, which is !! by default. History expansions may ap- + pear anywhere in the input, but do not nest. + + Only backslash (\\) and single quotes can quote the history expansion + character, but the history expansion character is also treated as + quoted if it immediately precedes the closing double quote in a double- + quoted string. Several characters inhibit history expansion if found immediately fol- lowing the history expansion character, even if it is unquoted: space, - tab, newline, carriage return, ==, ;;, &&, and ||. If the eexxttgglloobb shell - option is enabled, (( will also inhibit expansion. + tab, newline, carriage return, ==, and the other shell metacharacters + defined above. Several shell options settable with the sshhoopptt builtin may be used to tailor the behavior of history expansion. If the hhiissttvveerriiffyy shell op- @@ -4470,60 +4476,63 @@ HHIISSTTOORRYY EEXXPPAANNSSIIOONN EEvveenntt DDeessiiggnnaattoorrss An event designator is a reference to a command line entry in the his- - tory list. Unless the reference is absolute, events are relative to - the current position in the history list. + tory list. The event designator consists of the portion of the word + beginning with the history expansion character and ending with the word + designator if present, or the end of the word. Unless the reference is + absolute, events are relative to the current position in the history + list. - !! Start a history substitution, except when followed by a bbllaannkk, - newline, carriage return, = or ( (when the eexxttgglloobb shell option + !! Start a history substitution, except when followed by a bbllaannkk, + newline, carriage return, = or ( (when the eexxttgglloobb shell option is enabled using the sshhoopptt builtin). !!_n Refer to command line _n. !!--_n Refer to the current command minus _n. !!!! Refer to the previous command. This is a synonym for `!-1'. !!_s_t_r_i_n_g - Refer to the most recent command preceding the current position + Refer to the most recent command preceding the current position in the history list starting with _s_t_r_i_n_g. !!??_s_t_r_i_n_g[[??]] - Refer to the most recent command preceding the current position - in the history list containing _s_t_r_i_n_g. The trailing ?? may be - omitted if _s_t_r_i_n_g is followed immediately by a newline. If - _s_t_r_i_n_g is missing, the string from the most recent search is + Refer to the most recent command preceding the current position + in the history list containing _s_t_r_i_n_g. The trailing ?? may be + omitted if _s_t_r_i_n_g is followed immediately by a newline. If + _s_t_r_i_n_g is missing, the string from the most recent search is used; it is an error if there is no previous search string. ^^_s_t_r_i_n_g_1^^_s_t_r_i_n_g_2^^ - Quick substitution. Repeat the previous command, replacing - _s_t_r_i_n_g_1 with _s_t_r_i_n_g_2. Equivalent to ``!!:s^_s_t_r_i_n_g_1^_s_t_r_i_n_g_2^'' + Quick substitution. Repeat the previous command, replacing + _s_t_r_i_n_g_1 with _s_t_r_i_n_g_2. Equivalent to ``!!:s^_s_t_r_i_n_g_1^_s_t_r_i_n_g_2^'' (see MMooddiiffiieerrss below). !!## The entire command line typed so far. WWoorrdd DDeessiiggnnaattoorrss - Word designators are used to select desired words from the event. A :: - separates the event specification from the word designator. It may be - omitted if the word designator begins with a ^^, $$, **, --, or %%. Words - are numbered from the beginning of the line, with the first word being - denoted by 0 (zero). Words are inserted into the current line sepa- + Word designators are used to select desired words from the event. A :: + separates the event specification from the word designator. It may be + omitted if the word designator begins with a ^^, $$, **, --, or %%. Words + are numbered from the beginning of the line, with the first word being + denoted by 0 (zero). Words are inserted into the current line sepa- rated by single spaces. 00 ((zzeerroo)) The zeroth word. For the shell, this is the command word. _n The _nth word. ^^ The first argument. That is, word 1. - $$ The last word. This is usually the last argument, but will ex- + $$ The last word. This is usually the last argument, but will ex- pand to the zeroth word if there is only one word in the line. - %% The first word matched by the most recent `?_s_t_r_i_n_g?' search, if - the search string begins with a character that is part of a + %% The first word matched by the most recent `?_s_t_r_i_n_g?' search, if + the search string begins with a character that is part of a word. _x--_y A range of words; `-_y' abbreviates `0-_y'. - ** All of the words but the zeroth. This is a synonym for `_1_-_$'. - It is not an error to use ** if there is just one word in the + ** All of the words but the zeroth. This is a synonym for `_1_-_$'. + It is not an error to use ** if there is just one word in the event; the empty string is returned in that case. xx** Abbreviates _x_-_$. xx-- Abbreviates _x_-_$ like xx**, but omits the last word. If xx is miss- ing, it defaults to 0. - If a word designator is supplied without an event specification, the + If a word designator is supplied without an event specification, the previous command is used as the event. MMooddiiffiieerrss - After the optional word designator, there may appear a sequence of one + After the optional word designator, there may appear a sequence of one or more of the following modifiers, each preceded by a `:'. These mod- ify, or edit, the word or words selected from the history event. @@ -4533,24 +4542,24 @@ HHIISSTTOORRYY EEXXPPAANNSSIIOONN ee Remove all but the trailing suffix. pp Print the new command but do not execute it. qq Quote the substituted words, escaping further substitutions. - xx Quote the substituted words as with qq, but break into words at - bbllaannkkss and newlines. The qq and xx modifiers are mutually exclu- + xx Quote the substituted words as with qq, but break into words at + bbllaannkkss and newlines. The qq and xx modifiers are mutually exclu- sive; the last one supplied is used. ss//_o_l_d//_n_e_w// - Substitute _n_e_w for the first occurrence of _o_l_d in the event + Substitute _n_e_w for the first occurrence of _o_l_d in the event line. Any character may be used as the delimiter in place of /. - The final delimiter is optional if it is the last character of + The final delimiter is optional if it is the last character of the event line. The delimiter may be quoted in _o_l_d and _n_e_w with a single backslash. If & appears in _n_e_w, it is replaced by _o_l_d. - A single backslash will quote the &. If _o_l_d is null, it is set - to the last _o_l_d substituted, or, if no previous history substi- - tutions took place, the last _s_t_r_i_n_g in a !!??_s_t_r_i_n_g[[??]] search. + A single backslash will quote the &. If _o_l_d is null, it is set + to the last _o_l_d substituted, or, if no previous history substi- + tutions took place, the last _s_t_r_i_n_g in a !!??_s_t_r_i_n_g[[??]] search. If _n_e_w is null, each matching _o_l_d is deleted. && Repeat the previous substitution. gg Cause changes to be applied over the entire event line. This is - used in conjunction with `::ss' (e.g., `::ggss//_o_l_d//_n_e_w//') or `::&&'. - If used with `::ss', any delimiter can be used in place of /, and - the final delimiter is optional if it is the last character of + used in conjunction with `::ss' (e.g., `::ggss//_o_l_d//_n_e_w//') or `::&&'. + If used with `::ss', any delimiter can be used in place of /, and + the final delimiter is optional if it is the last character of the event line. An aa may be used as a synonym for gg. GG Apply the following `ss' or `&&' modifier once to each word in the event line. @@ -4559,56 +4568,56 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS Unless otherwise noted, each builtin command documented in this section as accepting options preceded by -- accepts ---- to signify the end of the options. The ::, ttrruuee, ffaallssee, and tteesstt/[[ builtins do not accept options - and do not treat ---- specially. The eexxiitt, llooggoouutt, rreettuurrnn, bbrreeaakk, ccoonn-- - ttiinnuuee, lleett, and sshhiifftt builtins accept and process arguments beginning - with -- without requiring ----. Other builtins that accept arguments but - are not specified as accepting options interpret arguments beginning - with -- as invalid options and require ---- to prevent this interpreta- + and do not treat ---- specially. The eexxiitt, llooggoouutt, rreettuurrnn, bbrreeaakk, ccoonn-- + ttiinnuuee, lleett, and sshhiifftt builtins accept and process arguments beginning + with -- without requiring ----. Other builtins that accept arguments but + are not specified as accepting options interpret arguments beginning + with -- as invalid options and require ---- to prevent this interpreta- tion. :: [_a_r_g_u_m_e_n_t_s] - No effect; the command does nothing beyond expanding _a_r_g_u_m_e_n_t_s + No effect; the command does nothing beyond expanding _a_r_g_u_m_e_n_t_s and performing any specified redirections. The return status is zero. .. _f_i_l_e_n_a_m_e [_a_r_g_u_m_e_n_t_s] ssoouurrccee _f_i_l_e_n_a_m_e [_a_r_g_u_m_e_n_t_s] Read and execute commands from _f_i_l_e_n_a_m_e in the current shell en- - vironment and return the exit status of the last command exe- - cuted from _f_i_l_e_n_a_m_e. If _f_i_l_e_n_a_m_e does not contain a slash, - filenames in PPAATTHH are used to find the directory containing + vironment and return the exit status of the last command exe- + cuted from _f_i_l_e_n_a_m_e. If _f_i_l_e_n_a_m_e does not contain a slash, + filenames in PPAATTHH are used to find the directory containing _f_i_l_e_n_a_m_e, but _f_i_l_e_n_a_m_e does not need to be executable. The file - searched for in PPAATTHH need not be executable. When bbaasshh is not - in _p_o_s_i_x _m_o_d_e, it searches the current directory if no file is - found in PPAATTHH. If the ssoouurrcceeppaatthh option to the sshhoopptt builtin - command is turned off, the PPAATTHH is not searched. If any _a_r_g_u_- - _m_e_n_t_s are supplied, they become the positional parameters when - _f_i_l_e_n_a_m_e is executed. Otherwise the positional parameters are - unchanged. If the --TT option is enabled, .. inherits any trap on + searched for in PPAATTHH need not be executable. When bbaasshh is not + in _p_o_s_i_x _m_o_d_e, it searches the current directory if no file is + found in PPAATTHH. If the ssoouurrcceeppaatthh option to the sshhoopptt builtin + command is turned off, the PPAATTHH is not searched. If any _a_r_g_u_- + _m_e_n_t_s are supplied, they become the positional parameters when + _f_i_l_e_n_a_m_e is executed. Otherwise the positional parameters are + unchanged. If the --TT option is enabled, .. inherits any trap on DDEEBBUUGG; if it is not, any DDEEBBUUGG trap string is saved and restored - around the call to .., and .. unsets the DDEEBBUUGG trap while it exe- + around the call to .., and .. unsets the DDEEBBUUGG trap while it exe- cutes. If --TT is not set, and the sourced file changes the DDEEBBUUGG - trap, the new value is retained when .. completes. The return - status is the status of the last command exited within the + trap, the new value is retained when .. completes. The return + status is the status of the last command exited within the script (0 if no commands are executed), and false if _f_i_l_e_n_a_m_e is not found or cannot be read. aalliiaass [--pp] [_n_a_m_e[=_v_a_l_u_e] ...] AAlliiaass with no arguments or with the --pp option prints the list of - aliases in the form aalliiaass _n_a_m_e=_v_a_l_u_e on standard output. When - arguments are supplied, an alias is defined for each _n_a_m_e whose - _v_a_l_u_e is given. A trailing space in _v_a_l_u_e causes the next word + aliases in the form aalliiaass _n_a_m_e=_v_a_l_u_e on standard output. When + arguments are supplied, an alias is defined for each _n_a_m_e whose + _v_a_l_u_e is given. A trailing space in _v_a_l_u_e causes the next word to be checked for alias substitution when the alias is expanded. - For each _n_a_m_e in the argument list for which no _v_a_l_u_e is sup- - plied, the name and value of the alias is printed. AAlliiaass re- - turns true unless a _n_a_m_e is given for which no alias has been + For each _n_a_m_e in the argument list for which no _v_a_l_u_e is sup- + plied, the name and value of the alias is printed. AAlliiaass re- + turns true unless a _n_a_m_e is given for which no alias has been defined. bbgg [_j_o_b_s_p_e_c ...] - Resume each suspended job _j_o_b_s_p_e_c in the background, as if it + Resume each suspended job _j_o_b_s_p_e_c in the background, as if it had been started with &&. If _j_o_b_s_p_e_c is not present, the shell's - notion of the _c_u_r_r_e_n_t _j_o_b is used. bbgg _j_o_b_s_p_e_c returns 0 unless - run when job control is disabled or, when run with job control - enabled, any specified _j_o_b_s_p_e_c was not found or was started + notion of the _c_u_r_r_e_n_t _j_o_b is used. bbgg _j_o_b_s_p_e_c returns 0 unless + run when job control is disabled or, when run with job control + enabled, any specified _j_o_b_s_p_e_c was not found or was started without job control. bbiinndd [--mm _k_e_y_m_a_p] [--llppssvvPPSSVVXX] @@ -4618,30 +4627,30 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS bbiinndd [--mm _k_e_y_m_a_p] _k_e_y_s_e_q:_f_u_n_c_t_i_o_n_-_n_a_m_e bbiinndd [--mm _k_e_y_m_a_p] _k_e_y_s_e_q:_r_e_a_d_l_i_n_e_-_c_o_m_m_a_n_d bbiinndd _r_e_a_d_l_i_n_e_-_c_o_m_m_a_n_d_-_l_i_n_e - Display current rreeaaddlliinnee key and function bindings, bind a key - sequence to a rreeaaddlliinnee function or macro, or set a rreeaaddlliinnee + Display current rreeaaddlliinnee key and function bindings, bind a key + sequence to a rreeaaddlliinnee function or macro, or set a rreeaaddlliinnee variable. Each non-option argument is a command as it would ap- - pear in a rreeaaddlliinnee initialization file such as _._i_n_p_u_t_r_c, but - each binding or command must be passed as a separate argument; - e.g., '"\C-x\C-r": re-read-init-file'. Options, if supplied, + pear in a rreeaaddlliinnee initialization file such as _._i_n_p_u_t_r_c, but + each binding or command must be passed as a separate argument; + e.g., '"\C-x\C-r": re-read-init-file'. Options, if supplied, have the following meanings: --mm _k_e_y_m_a_p Use _k_e_y_m_a_p as the keymap to be affected by the subsequent bindings. Acceptable _k_e_y_m_a_p names are _e_m_a_c_s_, _e_m_a_c_s_-_s_t_a_n_- - _d_a_r_d_, _e_m_a_c_s_-_m_e_t_a_, _e_m_a_c_s_-_c_t_l_x_, _v_i_, _v_i_-_m_o_v_e_, _v_i_-_c_o_m_m_a_n_d, - and _v_i_-_i_n_s_e_r_t. _v_i is equivalent to _v_i_-_c_o_m_m_a_n_d (_v_i_-_m_o_v_e - is also a synonym); _e_m_a_c_s is equivalent to _e_m_a_c_s_-_s_t_a_n_- + _d_a_r_d_, _e_m_a_c_s_-_m_e_t_a_, _e_m_a_c_s_-_c_t_l_x_, _v_i_, _v_i_-_m_o_v_e_, _v_i_-_c_o_m_m_a_n_d, + and _v_i_-_i_n_s_e_r_t. _v_i is equivalent to _v_i_-_c_o_m_m_a_n_d (_v_i_-_m_o_v_e + is also a synonym); _e_m_a_c_s is equivalent to _e_m_a_c_s_-_s_t_a_n_- _d_a_r_d. --ll List the names of all rreeaaddlliinnee functions. - --pp Display rreeaaddlliinnee function names and bindings in such a + --pp Display rreeaaddlliinnee function names and bindings in such a way that they can be re-read. --PP List current rreeaaddlliinnee function names and bindings. - --ss Display rreeaaddlliinnee key sequences bound to macros and the - strings they output in such a way that they can be re- + --ss Display rreeaaddlliinnee key sequences bound to macros and the + strings they output in such a way that they can be re- read. - --SS Display rreeaaddlliinnee key sequences bound to macros and the + --SS Display rreeaaddlliinnee key sequences bound to macros and the strings they output. - --vv Display rreeaaddlliinnee variable names and values in such a way + --vv Display rreeaaddlliinnee variable names and values in such a way that they can be re-read. --VV List current rreeaaddlliinnee variable names and values. --ff _f_i_l_e_n_a_m_e @@ -4655,202 +4664,202 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS --xx _k_e_y_s_e_q[[:: ]]_s_h_e_l_l_-_c_o_m_m_a_n_d Cause _s_h_e_l_l_-_c_o_m_m_a_n_d to be executed whenever _k_e_y_s_e_q is en- tered. The separator between _k_e_y_s_e_q and _s_h_e_l_l_-_c_o_m_m_a_n_d is - either whitespace or a colon optionally followed by - whitespace. If the separator is whitespace, _s_h_e_l_l_-_c_o_m_- - _m_a_n_d must be enclosed in double quotes and rreeaaddlliinnee ex- - pands any of its special backslash-escapes in _s_h_e_l_l_-_c_o_m_- - _m_a_n_d before saving it. If the separator is a colon, any - enclosing double quotes are optional, and rreeaaddlliinnee does - not expand the command string before saving it. Since - the entire key binding expression must be a single argu- - ment, it should be enclosed in quotes. When _s_h_e_l_l_-_c_o_m_- - _m_a_n_d is executed, the shell sets the RREEAADDLLIINNEE__LLIINNEE vari- - able to the contents of the rreeaaddlliinnee line buffer and the + either whitespace or a colon optionally followed by + whitespace. If the separator is whitespace, _s_h_e_l_l_-_c_o_m_- + _m_a_n_d must be enclosed in double quotes and rreeaaddlliinnee ex- + pands any of its special backslash-escapes in _s_h_e_l_l_-_c_o_m_- + _m_a_n_d before saving it. If the separator is a colon, any + enclosing double quotes are optional, and rreeaaddlliinnee does + not expand the command string before saving it. Since + the entire key binding expression must be a single argu- + ment, it should be enclosed in quotes. When _s_h_e_l_l_-_c_o_m_- + _m_a_n_d is executed, the shell sets the RREEAADDLLIINNEE__LLIINNEE vari- + able to the contents of the rreeaaddlliinnee line buffer and the RREEAADDLLIINNEE__PPOOIINNTT and RREEAADDLLIINNEE__MMAARRKK variables to the current - location of the insertion point and the saved insertion - point (the mark), respectively. The shell assigns any - numeric argument the user supplied to the RREEAADDLLIINNEE__AARRGGUU-- - MMEENNTT variable. If there was no argument, that variable + location of the insertion point and the saved insertion + point (the mark), respectively. The shell assigns any + numeric argument the user supplied to the RREEAADDLLIINNEE__AARRGGUU-- + MMEENNTT variable. If there was no argument, that variable is not set. If the executed command changes the value of - any of RREEAADDLLIINNEE__LLIINNEE, RREEAADDLLIINNEE__PPOOIINNTT, or RREEAADDLLIINNEE__MMAARRKK, + any of RREEAADDLLIINNEE__LLIINNEE, RREEAADDLLIINNEE__PPOOIINNTT, or RREEAADDLLIINNEE__MMAARRKK, those new values will be reflected in the editing state. - --XX List all key sequences bound to shell commands and the + --XX List all key sequences bound to shell commands and the associated commands in a format that can be reused as in- put. - The return value is 0 unless an unrecognized option is given or + The return value is 0 unless an unrecognized option is given or an error occurred. bbrreeaakk [_n] - Exit from within a ffoorr, wwhhiillee, uunnttiill, or sseelleecctt loop. If _n is - specified, break _n levels. _n must be >= 1. If _n is greater - than the number of enclosing loops, all enclosing loops are ex- - ited. The return value is 0 unless _n is not greater than or + Exit from within a ffoorr, wwhhiillee, uunnttiill, or sseelleecctt loop. If _n is + specified, break _n levels. _n must be >= 1. If _n is greater + than the number of enclosing loops, all enclosing loops are ex- + ited. The return value is 0 unless _n is not greater than or equal to 1. bbuuiillttiinn _s_h_e_l_l_-_b_u_i_l_t_i_n [_a_r_g_u_m_e_n_t_s] - Execute the specified shell builtin, passing it _a_r_g_u_m_e_n_t_s, and + Execute the specified shell builtin, passing it _a_r_g_u_m_e_n_t_s, and return its exit status. This is useful when defining a function - whose name is the same as a shell builtin, retaining the func- + whose name is the same as a shell builtin, retaining the func- tionality of the builtin within the function. The ccdd builtin is - commonly redefined this way. The return status is false if + commonly redefined this way. The return status is false if _s_h_e_l_l_-_b_u_i_l_t_i_n is not a shell builtin command. ccaalllleerr [_e_x_p_r] Returns the context of any active subroutine call (a shell func- tion or a script executed with the .. or ssoouurrccee builtins). With- out _e_x_p_r, ccaalllleerr displays the line number and source filename of - the current subroutine call. If a non-negative integer is sup- + the current subroutine call. If a non-negative integer is sup- plied as _e_x_p_r, ccaalllleerr displays the line number, subroutine name, - and source file corresponding to that position in the current - execution call stack. This extra information may be used, for - example, to print a stack trace. The current frame is frame 0. - The return value is 0 unless the shell is not executing a sub- - routine call or _e_x_p_r does not correspond to a valid position in + and source file corresponding to that position in the current + execution call stack. This extra information may be used, for + example, to print a stack trace. The current frame is frame 0. + The return value is 0 unless the shell is not executing a sub- + routine call or _e_x_p_r does not correspond to a valid position in the call stack. ccdd [--LL|[--PP [--ee]]] [-@] [_d_i_r] - Change the current directory to _d_i_r. if _d_i_r is not supplied, - the value of the HHOOMMEE shell variable is the default. The vari- + Change the current directory to _d_i_r. if _d_i_r is not supplied, + the value of the HHOOMMEE shell variable is the default. The vari- able CCDDPPAATTHH defines the search path for the directory containing - _d_i_r: each directory name in CCDDPPAATTHH is searched for _d_i_r. Alter- - native directory names in CCDDPPAATTHH are separated by a colon (:). - A null directory name in CCDDPPAATTHH is the same as the current di- - rectory, i.e., ``..''. If _d_i_r begins with a slash (/), then CCDD-- - PPAATTHH is not used. The --PP option causes ccdd to use the physical + _d_i_r: each directory name in CCDDPPAATTHH is searched for _d_i_r. Alter- + native directory names in CCDDPPAATTHH are separated by a colon (:). + A null directory name in CCDDPPAATTHH is the same as the current di- + rectory, i.e., ``..''. If _d_i_r begins with a slash (/), then CCDD-- + PPAATTHH is not used. The --PP option causes ccdd to use the physical directory structure by resolving symbolic links while traversing - _d_i_r and before processing instances of _._. in _d_i_r (see also the + _d_i_r and before processing instances of _._. in _d_i_r (see also the --PP option to the sseett builtin command); the --LL option forces sym- - bolic links to be followed by resolving the link after process- - ing instances of _._. in _d_i_r. If _._. appears in _d_i_r, it is pro- - cessed by removing the immediately previous pathname component - from _d_i_r, back to a slash or the beginning of _d_i_r. If the --ee - option is supplied with --PP, and the current working directory - cannot be successfully determined after a successful directory - change, ccdd will return an unsuccessful status. On systems that + bolic links to be followed by resolving the link after process- + ing instances of _._. in _d_i_r. If _._. appears in _d_i_r, it is pro- + cessed by removing the immediately previous pathname component + from _d_i_r, back to a slash or the beginning of _d_i_r. If the --ee + option is supplied with --PP, and the current working directory + cannot be successfully determined after a successful directory + change, ccdd will return an unsuccessful status. On systems that support it, the --@@ option presents the extended attributes asso- - ciated with a file as a directory. An argument of -- is con- - verted to $$OOLLDDPPWWDD before the directory change is attempted. If - a non-empty directory name from CCDDPPAATTHH is used, or if -- is the - first argument, and the directory change is successful, the ab- - solute pathname of the new working directory is written to the + ciated with a file as a directory. An argument of -- is con- + verted to $$OOLLDDPPWWDD before the directory change is attempted. If + a non-empty directory name from CCDDPPAATTHH is used, or if -- is the + first argument, and the directory change is successful, the ab- + solute pathname of the new working directory is written to the standard output. If the directory change is successful, ccdd sets - the value of the PPWWDD environment variable to the new directory - name, and sets the OOLLDDPPWWDD environment variable to the value of - the current working directory before the change. The return - value is true if the directory was successfully changed; false + the value of the PPWWDD environment variable to the new directory + name, and sets the OOLLDDPPWWDD environment variable to the value of + the current working directory before the change. The return + value is true if the directory was successfully changed; false otherwise. ccoommmmaanndd [--ppVVvv] _c_o_m_m_a_n_d [_a_r_g ...] - Run _c_o_m_m_a_n_d with _a_r_g_s suppressing the normal shell function + Run _c_o_m_m_a_n_d with _a_r_g_s suppressing the normal shell function lookup. Only builtin commands or commands found in the PPAATTHH are - executed. If the --pp option is given, the search for _c_o_m_m_a_n_d is - performed using a default value for PPAATTHH that is guaranteed to - find all of the standard utilities. If either the --VV or --vv op- - tion is supplied, a description of _c_o_m_m_a_n_d is printed. The --vv - option causes a single word indicating the command or filename + executed. If the --pp option is given, the search for _c_o_m_m_a_n_d is + performed using a default value for PPAATTHH that is guaranteed to + find all of the standard utilities. If either the --VV or --vv op- + tion is supplied, a description of _c_o_m_m_a_n_d is printed. The --vv + option causes a single word indicating the command or filename used to invoke _c_o_m_m_a_n_d to be displayed; the --VV option produces a - more verbose description. If the --VV or --vv option is supplied, - the exit status is 0 if _c_o_m_m_a_n_d was found, and 1 if not. If + more verbose description. If the --VV or --vv option is supplied, + the exit status is 0 if _c_o_m_m_a_n_d was found, and 1 if not. If neither option is supplied and an error occurred or _c_o_m_m_a_n_d can- - not be found, the exit status is 127. Otherwise, the exit sta- + not be found, the exit status is 127. Otherwise, the exit sta- tus of the ccoommmmaanndd builtin is the exit status of _c_o_m_m_a_n_d. ccoommppggeenn [--VV _v_a_r_n_a_m_e] [_o_p_t_i_o_n] [_w_o_r_d] - Generate possible completion matches for _w_o_r_d according to the - _o_p_t_i_o_ns, which may be any option accepted by the ccoommpplleettee + Generate possible completion matches for _w_o_r_d according to the + _o_p_t_i_o_ns, which may be any option accepted by the ccoommpplleettee builtin with the exceptions of --pp, --rr, --DD, --EE, and --II, and write - the matches to the standard output. If the --VV option is sup- + the matches to the standard output. If the --VV option is sup- plied, ccoommppggeenn stores the generated completions into the indexed - array variable _v_a_r_n_a_m_e instead of writing them to the standard - output. When using the --FF or --CC options, the various shell - variables set by the programmable completion facilities, while + array variable _v_a_r_n_a_m_e instead of writing them to the standard + output. When using the --FF or --CC options, the various shell + variables set by the programmable completion facilities, while available, will not have useful values. The matches will be generated in the same way as if the program- mable completion code had generated them directly from a comple- - tion specification with the same flags. If _w_o_r_d is specified, + tion specification with the same flags. If _w_o_r_d is specified, only those completions matching _w_o_r_d will be displayed. - The return value is true unless an invalid option is supplied, + The return value is true unless an invalid option is supplied, or no matches were generated. ccoommpplleettee [--aabbccddeeffggjjkkssuuvv] [--oo _c_o_m_p_-_o_p_t_i_o_n] [--DDEEII] [--AA _a_c_t_i_o_n] [--GG _g_l_o_b_p_a_t] [--WW _w_o_r_d_l_i_s_t] [--FF _f_u_n_c_t_i_o_n] [--CC _c_o_m_m_a_n_d] [--XX _f_i_l_t_e_r_p_a_t] [--PP _p_r_e_f_i_x] [--SS _s_u_f_f_i_x] _n_a_m_e [_n_a_m_e _._._.] ccoommpplleettee --pprr [--DDEEII] [_n_a_m_e ...] - Specify how arguments to each _n_a_m_e should be completed. If the - --pp option is supplied, or if no options are supplied, existing - completion specifications are printed in a way that allows them + Specify how arguments to each _n_a_m_e should be completed. If the + --pp option is supplied, or if no options are supplied, existing + completion specifications are printed in a way that allows them to be reused as input. The --rr option removes a completion spec- - ification for each _n_a_m_e, or, if no _n_a_m_es are supplied, all com- + ification for each _n_a_m_e, or, if no _n_a_m_es are supplied, all com- pletion specifications. The --DD option indicates that other sup- - plied options and actions should apply to the ``default'' com- - mand completion; that is, completion attempted on a command for - which no completion has previously been defined. The --EE option - indicates that other supplied options and actions should apply - to ``empty'' command completion; that is, completion attempted - on a blank line. The --II option indicates that other supplied - options and actions should apply to completion on the initial - non-assignment word on the line, or after a command delimiter - such as ;; or ||, which is usually command name completion. If - multiple options are supplied, the --DD option takes precedence + plied options and actions should apply to the ``default'' com- + mand completion; that is, completion attempted on a command for + which no completion has previously been defined. The --EE option + indicates that other supplied options and actions should apply + to ``empty'' command completion; that is, completion attempted + on a blank line. The --II option indicates that other supplied + options and actions should apply to completion on the initial + non-assignment word on the line, or after a command delimiter + such as ;; or ||, which is usually command name completion. If + multiple options are supplied, the --DD option takes precedence over --EE, and both take precedence over --II. If any of --DD, --EE, or - --II are supplied, any other _n_a_m_e arguments are ignored; these + --II are supplied, any other _n_a_m_e arguments are ignored; these completions only apply to the case specified by the option. - The process of applying these completion specifications when - word completion is attempted is described above under PPrrooggrraamm-- + The process of applying these completion specifications when + word completion is attempted is described above under PPrrooggrraamm-- mmaabbllee CCoommpplleettiioonn. - Other options, if specified, have the following meanings. The - arguments to the --GG, --WW, and --XX options (and, if necessary, the - --PP and --SS options) should be quoted to protect them from expan- + Other options, if specified, have the following meanings. The + arguments to the --GG, --WW, and --XX options (and, if necessary, the + --PP and --SS options) should be quoted to protect them from expan- sion before the ccoommpplleettee builtin is invoked. --oo _c_o_m_p_-_o_p_t_i_o_n - The _c_o_m_p_-_o_p_t_i_o_n controls several aspects of the comp- - spec's behavior beyond the simple generation of comple- + The _c_o_m_p_-_o_p_t_i_o_n controls several aspects of the comp- + spec's behavior beyond the simple generation of comple- tions. _c_o_m_p_-_o_p_t_i_o_n may be one of: bbaasshhddeeffaauulltt Perform the rest of the default bbaasshh completions if the compspec generates no matches. - ddeeffaauulltt Use readline's default filename completion if + ddeeffaauulltt Use readline's default filename completion if the compspec generates no matches. ddiirrnnaammeess - Perform directory name completion if the comp- + Perform directory name completion if the comp- spec generates no matches. ffiilleennaammeess - Tell readline that the compspec generates file- - names, so it can perform any filename-specific - processing (like adding a slash to directory - names, quoting special characters, or suppress- - ing trailing spaces). Intended to be used with + Tell readline that the compspec generates file- + names, so it can perform any filename-specific + processing (like adding a slash to directory + names, quoting special characters, or suppress- + ing trailing spaces). Intended to be used with shell functions. ffuullllqquuoottee - Tell readline to quote all the completed words + Tell readline to quote all the completed words even if they are not filenames. - nnooqquuoottee Tell readline not to quote the completed words - if they are filenames (quoting filenames is the + nnooqquuoottee Tell readline not to quote the completed words + if they are filenames (quoting filenames is the default). - nnoossoorrtt Tell readline not to sort the list of possible + nnoossoorrtt Tell readline not to sort the list of possible completions alphabetically. - nnoossppaaccee Tell readline not to append a space (the de- - fault) to words completed at the end of the + nnoossppaaccee Tell readline not to append a space (the de- + fault) to words completed at the end of the line. pplluussddiirrss - After any matches defined by the compspec are + After any matches defined by the compspec are generated, directory name completion is at- tempted and any matches are added to the results of the other actions. --AA _a_c_t_i_o_n - The _a_c_t_i_o_n may be one of the following to generate a + The _a_c_t_i_o_n may be one of the following to generate a list of possible completions: aalliiaass Alias names. May also be specified as --aa. aarrrraayyvvaarr Array variable names. bbiinnddiinngg RReeaaddlliinnee key binding names. - bbuuiillttiinn Names of shell builtin commands. May also be + bbuuiillttiinn Names of shell builtin commands. May also be specified as --bb. ccoommmmaanndd Command names. May also be specified as --cc. ddiirreeccttoorryy @@ -4858,7 +4867,7 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS ddiissaabblleedd Names of disabled shell builtins. eennaabblleedd Names of enabled shell builtins. - eexxppoorrtt Names of exported shell variables. May also be + eexxppoorrtt Names of exported shell variables. May also be specified as --ee. ffiillee File names. May also be specified as --ff. ffuunnccttiioonn @@ -4867,17 +4876,17 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS hheellppttooppiicc Help topics as accepted by the hheellpp builtin. hhoossttnnaammee - Hostnames, as taken from the file specified by + Hostnames, as taken from the file specified by the HHOOSSTTFFIILLEE shell variable. - jjoobb Job names, if job control is active. May also + jjoobb Job names, if job control is active. May also be specified as --jj. - kkeeyywwoorrdd Shell reserved words. May also be specified as + kkeeyywwoorrdd Shell reserved words. May also be specified as --kk. rruunnnniinngg Names of running jobs, if job control is active. sseerrvviiccee Service names. May also be specified as --ss. - sseettoopptt Valid arguments for the --oo option to the sseett + sseettoopptt Valid arguments for the --oo option to the sseett builtin. - sshhoopptt Shell option names as accepted by the sshhoopptt + sshhoopptt Shell option names as accepted by the sshhoopptt builtin. ssiiggnnaall Signal names. ssttooppppeedd Names of stopped jobs, if job control is active. @@ -4886,198 +4895,198 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS Names of all shell variables. May also be spec- ified as --vv. --CC _c_o_m_m_a_n_d - _c_o_m_m_a_n_d is executed in a subshell environment, and its - output is used as the possible completions. Arguments + _c_o_m_m_a_n_d is executed in a subshell environment, and its + output is used as the possible completions. Arguments are passed as with the --FF option. --FF _f_u_n_c_t_i_o_n - The shell function _f_u_n_c_t_i_o_n is executed in the current - shell environment. When the function is executed, the + The shell function _f_u_n_c_t_i_o_n is executed in the current + shell environment. When the function is executed, the first argument ($$11) is the name of the command whose ar- guments are being completed, the second argument ($$22) is the word being completed, and the third argument ($$33) is - the word preceding the word being completed on the cur- - rent command line. When it finishes, the possible com- - pletions are retrieved from the value of the CCOOMMPPRREEPPLLYY + the word preceding the word being completed on the cur- + rent command line. When it finishes, the possible com- + pletions are retrieved from the value of the CCOOMMPPRREEPPLLYY array variable. --GG _g_l_o_b_p_a_t - The pathname expansion pattern _g_l_o_b_p_a_t is expanded to + The pathname expansion pattern _g_l_o_b_p_a_t is expanded to generate the possible completions. --PP _p_r_e_f_i_x - _p_r_e_f_i_x is added at the beginning of each possible com- + _p_r_e_f_i_x is added at the beginning of each possible com- pletion after all other options have been applied. --SS _s_u_f_f_i_x _s_u_f_f_i_x is appended to each possible completion after all other options have been applied. --WW _w_o_r_d_l_i_s_t - The _w_o_r_d_l_i_s_t is split using the characters in the IIFFSS - special variable as delimiters, and each resultant word - is expanded. Shell quoting is honored within _w_o_r_d_l_i_s_t, + The _w_o_r_d_l_i_s_t is split using the characters in the IIFFSS + special variable as delimiters, and each resultant word + is expanded. Shell quoting is honored within _w_o_r_d_l_i_s_t, in order to provide a mechanism for the words to contain - shell metacharacters or characters in the value of IIFFSS. - The possible completions are the members of the resul- + shell metacharacters or characters in the value of IIFFSS. + The possible completions are the members of the resul- tant list which match the word being completed. --XX _f_i_l_t_e_r_p_a_t - _f_i_l_t_e_r_p_a_t is a pattern as used for pathname expansion. + _f_i_l_t_e_r_p_a_t is a pattern as used for pathname expansion. It is applied to the list of possible completions gener- - ated by the preceding options and arguments, and each - completion matching _f_i_l_t_e_r_p_a_t is removed from the list. - A leading !! in _f_i_l_t_e_r_p_a_t negates the pattern; in this + ated by the preceding options and arguments, and each + completion matching _f_i_l_t_e_r_p_a_t is removed from the list. + A leading !! in _f_i_l_t_e_r_p_a_t negates the pattern; in this case, any completion not matching _f_i_l_t_e_r_p_a_t is removed. - The return value is true unless an invalid option is supplied, + The return value is true unless an invalid option is supplied, an option other than --pp, --rr, --DD, --EE, or --II is supplied without a - _n_a_m_e argument, an attempt is made to remove a completion speci- + _n_a_m_e argument, an attempt is made to remove a completion speci- fication for a _n_a_m_e for which no specification exists, or an er- ror occurs adding a completion specification. ccoommppoopptt [--oo _o_p_t_i_o_n] [--DDEEII] [++oo _o_p_t_i_o_n] [_n_a_m_e] - Modify completion options for each _n_a_m_e according to the _o_p_- + Modify completion options for each _n_a_m_e according to the _o_p_- _t_i_o_ns, or for the currently-executing completion if no _n_a_m_es are - supplied. If no _o_p_t_i_o_ns are given, display the completion op- - tions for each _n_a_m_e or the current completion. The possible - values of _o_p_t_i_o_n are those valid for the ccoommpplleettee builtin de- - scribed above. The --DD option indicates that other supplied op- - tions should apply to the ``default'' command completion; that - is, completion attempted on a command for which no completion + supplied. If no _o_p_t_i_o_ns are given, display the completion op- + tions for each _n_a_m_e or the current completion. The possible + values of _o_p_t_i_o_n are those valid for the ccoommpplleettee builtin de- + scribed above. The --DD option indicates that other supplied op- + tions should apply to the ``default'' command completion; that + is, completion attempted on a command for which no completion has previously been defined. The --EE option indicates that other - supplied options should apply to ``empty'' command completion; - that is, completion attempted on a blank line. The --II option + supplied options should apply to ``empty'' command completion; + that is, completion attempted on a blank line. The --II option indicates that other supplied options should apply to completion - on the initial non-assignment word on the line, or after a com- - mand delimiter such as ;; or ||, which is usually command name + on the initial non-assignment word on the line, or after a com- + mand delimiter such as ;; or ||, which is usually command name completion. - The return value is true unless an invalid option is supplied, + The return value is true unless an invalid option is supplied, an attempt is made to modify the options for a _n_a_m_e for which no completion specification exists, or an output error occurs. ccoonnttiinnuuee [_n] Resume the next iteration of the enclosing ffoorr, wwhhiillee, uunnttiill, or - sseelleecctt loop. If _n is specified, resume at the _nth enclosing - loop. _n must be >= 1. If _n is greater than the number of en- - closing loops, the last enclosing loop (the ``top-level'' loop) - is resumed. The return value is 0 unless _n is not greater than + sseelleecctt loop. If _n is specified, resume at the _nth enclosing + loop. _n must be >= 1. If _n is greater than the number of en- + closing loops, the last enclosing loop (the ``top-level'' loop) + is resumed. The return value is 0 unless _n is not greater than or equal to 1. ddeeccllaarree [--aaAAffFFggiiIIllnnrrttuuxx] [--pp] [_n_a_m_e[=_v_a_l_u_e] ...] ttyyppeesseett [--aaAAffFFggiiIIllnnrrttuuxx] [--pp] [_n_a_m_e[=_v_a_l_u_e] ...] - Declare variables and/or give them attributes. If no _n_a_m_es are - given then display the values of variables. The --pp option will + Declare variables and/or give them attributes. If no _n_a_m_es are + given then display the values of variables. The --pp option will display the attributes and values of each _n_a_m_e. When --pp is used - with _n_a_m_e arguments, additional options, other than --ff and --FF, - are ignored. When --pp is supplied without _n_a_m_e arguments, it - will display the attributes and values of all variables having + with _n_a_m_e arguments, additional options, other than --ff and --FF, + are ignored. When --pp is supplied without _n_a_m_e arguments, it + will display the attributes and values of all variables having the attributes specified by the additional options. If no other - options are supplied with --pp, ddeeccllaarree will display the at- - tributes and values of all shell variables. The --ff option will + options are supplied with --pp, ddeeccllaarree will display the at- + tributes and values of all shell variables. The --ff option will restrict the display to shell functions. The --FF option inhibits - the display of function definitions; only the function name and + the display of function definitions; only the function name and attributes are printed. If the eexxttddeebbuugg shell option is enabled - using sshhoopptt, the source file name and line number where each - _n_a_m_e is defined are displayed as well. The --FF option implies + using sshhoopptt, the source file name and line number where each + _n_a_m_e is defined are displayed as well. The --FF option implies --ff. The --gg option forces variables to be created or modified at the global scope, even when ddeeccllaarree is executed in a shell func- - tion. It is ignored in all other cases. The --II option causes - local variables to inherit the attributes (except the _n_a_m_e_r_e_f + tion. It is ignored in all other cases. The --II option causes + local variables to inherit the attributes (except the _n_a_m_e_r_e_f attribute) and value of any existing variable with the same _n_a_m_e - at a surrounding scope. If there is no existing variable, the + at a surrounding scope. If there is no existing variable, the local variable is initially unset. The following options can be - used to restrict output to variables with the specified attri- + used to restrict output to variables with the specified attri- bute or to give variables attributes: - --aa Each _n_a_m_e is an indexed array variable (see AArrrraayyss + --aa Each _n_a_m_e is an indexed array variable (see AArrrraayyss above). - --AA Each _n_a_m_e is an associative array variable (see AArrrraayyss + --AA Each _n_a_m_e is an associative array variable (see AArrrraayyss above). --ff Use function names only. --ii The variable is treated as an integer; arithmetic evalua- - tion (see AARRIITTHHMMEETTIICC EEVVAALLUUAATTIIOONN above) is performed when + tion (see AARRIITTHHMMEETTIICC EEVVAALLUUAATTIIOONN above) is performed when the variable is assigned a value. - --ll When the variable is assigned a value, all upper-case - characters are converted to lower-case. The upper-case + --ll When the variable is assigned a value, all upper-case + characters are converted to lower-case. The upper-case attribute is disabled. - --nn Give each _n_a_m_e the _n_a_m_e_r_e_f attribute, making it a name - reference to another variable. That other variable is - defined by the value of _n_a_m_e. All references, assign- - ments, and attribute modifications to _n_a_m_e, except those - using or changing the --nn attribute itself, are performed - on the variable referenced by _n_a_m_e's value. The nameref + --nn Give each _n_a_m_e the _n_a_m_e_r_e_f attribute, making it a name + reference to another variable. That other variable is + defined by the value of _n_a_m_e. All references, assign- + ments, and attribute modifications to _n_a_m_e, except those + using or changing the --nn attribute itself, are performed + on the variable referenced by _n_a_m_e's value. The nameref attribute cannot be applied to array variables. --rr Make _n_a_m_es readonly. These names cannot then be assigned values by subsequent assignment statements or unset. --tt Give each _n_a_m_e the _t_r_a_c_e attribute. Traced functions in- - herit the DDEEBBUUGG and RREETTUURRNN traps from the calling shell. + herit the DDEEBBUUGG and RREETTUURRNN traps from the calling shell. The trace attribute has no special meaning for variables. - --uu When the variable is assigned a value, all lower-case - characters are converted to upper-case. The lower-case + --uu When the variable is assigned a value, all lower-case + characters are converted to upper-case. The lower-case attribute is disabled. - --xx Mark _n_a_m_es for export to subsequent commands via the en- + --xx Mark _n_a_m_es for export to subsequent commands via the en- vironment. - Using `+' instead of `-' turns off the attribute instead, with - the exceptions that ++aa and ++AA may not be used to destroy array - variables and ++rr will not remove the readonly attribute. When + Using `+' instead of `-' turns off the attribute instead, with + the exceptions that ++aa and ++AA may not be used to destroy array + variables and ++rr will not remove the readonly attribute. When used in a function, ddeeccllaarree and ttyyppeesseett make each _n_a_m_e local, as - with the llooccaall command, unless the --gg option is supplied. If a - variable name is followed by =_v_a_l_u_e, the value of the variable - is set to _v_a_l_u_e. When using --aa or --AA and the compound assign- - ment syntax to create array variables, additional attributes do - not take effect until subsequent assignments. The return value + with the llooccaall command, unless the --gg option is supplied. If a + variable name is followed by =_v_a_l_u_e, the value of the variable + is set to _v_a_l_u_e. When using --aa or --AA and the compound assign- + ment syntax to create array variables, additional attributes do + not take effect until subsequent assignments. The return value is 0 unless an invalid option is encountered, an attempt is made to define a function using ``-f foo=bar'', an attempt is made to assign a value to a readonly variable, an attempt is made to as- sign a value to an array variable without using the compound as- - signment syntax (see AArrrraayyss above), one of the _n_a_m_e_s is not a - valid shell variable name, an attempt is made to turn off read- - only status for a readonly variable, an attempt is made to turn + signment syntax (see AArrrraayyss above), one of the _n_a_m_e_s is not a + valid shell variable name, an attempt is made to turn off read- + only status for a readonly variable, an attempt is made to turn off array status for an array variable, or an attempt is made to display a non-existent function with --ff. ddiirrss [[--ccllppvv]] [[++_n]] [[--_n]] - Without options, displays the list of currently remembered di- - rectories. The default display is on a single line with direc- - tory names separated by spaces. Directories are added to the - list with the ppuusshhdd command; the ppooppdd command removes entries + Without options, displays the list of currently remembered di- + rectories. The default display is on a single line with direc- + tory names separated by spaces. Directories are added to the + list with the ppuusshhdd command; the ppooppdd command removes entries from the list. The current directory is always the first direc- tory in the stack. - --cc Clears the directory stack by deleting all of the en- + --cc Clears the directory stack by deleting all of the en- tries. - --ll Produces a listing using full pathnames; the default + --ll Produces a listing using full pathnames; the default listing format uses a tilde to denote the home directory. --pp Print the directory stack with one entry per line. - --vv Print the directory stack with one entry per line, pre- + --vv Print the directory stack with one entry per line, pre- fixing each entry with its index in the stack. ++_n Displays the _nth entry counting from the left of the list shown by ddiirrss when invoked without options, starting with zero. - --_n Displays the _nth entry counting from the right of the + --_n Displays the _nth entry counting from the right of the list shown by ddiirrss when invoked without options, starting with zero. - The return value is 0 unless an invalid option is supplied or _n + The return value is 0 unless an invalid option is supplied or _n indexes beyond the end of the directory stack. ddiissoowwnn [--aarr] [--hh] [_j_o_b_s_p_e_c ... | _p_i_d ... ] - Without options, remove each _j_o_b_s_p_e_c from the table of active - jobs. If _j_o_b_s_p_e_c is not present, and neither the --aa nor the --rr - option is supplied, the _c_u_r_r_e_n_t _j_o_b is used. If the --hh option - is given, each _j_o_b_s_p_e_c is not removed from the table, but is - marked so that SSIIGGHHUUPP is not sent to the job if the shell re- + Without options, remove each _j_o_b_s_p_e_c from the table of active + jobs. If _j_o_b_s_p_e_c is not present, and neither the --aa nor the --rr + option is supplied, the _c_u_r_r_e_n_t _j_o_b is used. If the --hh option + is given, each _j_o_b_s_p_e_c is not removed from the table, but is + marked so that SSIIGGHHUUPP is not sent to the job if the shell re- ceives a SSIIGGHHUUPP. If no _j_o_b_s_p_e_c is supplied, the --aa option means - to remove or mark all jobs; the --rr option without a _j_o_b_s_p_e_c ar- + to remove or mark all jobs; the --rr option without a _j_o_b_s_p_e_c ar- gument restricts operation to running jobs. The return value is 0 unless a _j_o_b_s_p_e_c does not specify a valid job. eecchhoo [--nneeEE] [_a_r_g ...] - Output the _a_r_gs, separated by spaces, followed by a newline. - The return status is 0 unless a write error occurs. If --nn is + Output the _a_r_gs, separated by spaces, followed by a newline. + The return status is 0 unless a write error occurs. If --nn is specified, the trailing newline is suppressed. If the --ee option - is given, interpretation of the following backslash-escaped - characters is enabled. The --EE option disables the interpreta- - tion of these escape characters, even on systems where they are - interpreted by default. The xxppgg__eecchhoo shell option may be used - to dynamically determine whether or not eecchhoo interprets any op- + is given, interpretation of the following backslash-escaped + characters is enabled. The --EE option disables the interpreta- + tion of these escape characters, even on systems where they are + interpreted by default. The xxppgg__eecchhoo shell option may be used + to dynamically determine whether or not eecchhoo interprets any op- tions and expands these escape characters by default. eecchhoo does - not interpret ---- to mean the end of options. eecchhoo interprets + not interpret ---- to mean the end of options. eecchhoo interprets the following escape sequences: \\aa alert (bell) \\bb backspace @@ -5090,203 +5099,203 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS \\tt horizontal tab \\vv vertical tab \\\\ backslash - \\00_n_n_n the eight-bit character whose value is the octal value + \\00_n_n_n the eight-bit character whose value is the octal value _n_n_n (zero to three octal digits) - \\xx_H_H the eight-bit character whose value is the hexadecimal + \\xx_H_H the eight-bit character whose value is the hexadecimal value _H_H (one or two hex digits) - \\uu_H_H_H_H the Unicode (ISO/IEC 10646) character whose value is the + \\uu_H_H_H_H the Unicode (ISO/IEC 10646) character whose value is the hexadecimal value _H_H_H_H (one to four hex digits) \\UU_H_H_H_H_H_H_H_H - the Unicode (ISO/IEC 10646) character whose value is the + the Unicode (ISO/IEC 10646) character whose value is the hexadecimal value _H_H_H_H_H_H_H_H (one to eight hex digits) eennaabbllee [--aa] [--ddnnppss] [--ff _f_i_l_e_n_a_m_e] [_n_a_m_e ...] - Enable and disable builtin shell commands. Disabling a builtin + Enable and disable builtin shell commands. Disabling a builtin allows a disk command which has the same name as a shell builtin - to be executed without specifying a full pathname, even though - the shell normally searches for builtins before disk commands. - If --nn is used, each _n_a_m_e is disabled; otherwise, _n_a_m_e_s are en- - abled. For example, to use the tteesstt binary found via the PPAATTHH - instead of the shell builtin version, run ``enable -n test''. - The --ff option means to load the new builtin command _n_a_m_e from + to be executed without specifying a full pathname, even though + the shell normally searches for builtins before disk commands. + If --nn is used, each _n_a_m_e is disabled; otherwise, _n_a_m_e_s are en- + abled. For example, to use the tteesstt binary found via the PPAATTHH + instead of the shell builtin version, run ``enable -n test''. + The --ff option means to load the new builtin command _n_a_m_e from shared object _f_i_l_e_n_a_m_e, on systems that support dynamic loading. BBaasshh will use the value of the BBAASSHH__LLOOAADDAABBLLEESS__PPAATTHH variable as a colon-separated list of directories in which to search for _f_i_l_e_- - _n_a_m_e. The default is system-dependent. The --dd option will - delete a builtin previously loaded with --ff. If no _n_a_m_e argu- - ments are given, or if the --pp option is supplied, a list of - shell builtins is printed. With no other option arguments, the + _n_a_m_e. The default is system-dependent. The --dd option will + delete a builtin previously loaded with --ff. If no _n_a_m_e argu- + ments are given, or if the --pp option is supplied, a list of + shell builtins is printed. With no other option arguments, the list consists of all enabled shell builtins. If --nn is supplied, only disabled builtins are printed. If --aa is supplied, the list - printed includes all builtins, with an indication of whether or - not each is enabled. If --ss is supplied, the output is re- - stricted to the POSIX _s_p_e_c_i_a_l builtins. If no options are sup- - plied and a _n_a_m_e is not a shell builtin, eennaabbllee will attempt to - load _n_a_m_e from a shared object named _n_a_m_e, as if the command - were ``enable -f _n_a_m_e _n_a_m_e . The return value is 0 unless a - _n_a_m_e is not a shell builtin or there is an error loading a new + printed includes all builtins, with an indication of whether or + not each is enabled. If --ss is supplied, the output is re- + stricted to the POSIX _s_p_e_c_i_a_l builtins. If no options are sup- + plied and a _n_a_m_e is not a shell builtin, eennaabbllee will attempt to + load _n_a_m_e from a shared object named _n_a_m_e, as if the command + were ``enable -f _n_a_m_e _n_a_m_e . The return value is 0 unless a + _n_a_m_e is not a shell builtin or there is an error loading a new builtin from a shared object. eevvaall [_a_r_g ...] - The _a_r_gs are read and concatenated together into a single com- - mand. This command is then read and executed by the shell, and - its exit status is returned as the value of eevvaall. If there are + The _a_r_gs are read and concatenated together into a single com- + mand. This command is then read and executed by the shell, and + its exit status is returned as the value of eevvaall. If there are no _a_r_g_s, or only null arguments, eevvaall returns 0. eexxeecc [--ccll] [--aa _n_a_m_e] [_c_o_m_m_a_n_d [_a_r_g_u_m_e_n_t_s]] - If _c_o_m_m_a_n_d is specified, it replaces the shell. No new process - is created. The _a_r_g_u_m_e_n_t_s become the arguments to _c_o_m_m_a_n_d. If + If _c_o_m_m_a_n_d is specified, it replaces the shell. No new process + is created. The _a_r_g_u_m_e_n_t_s become the arguments to _c_o_m_m_a_n_d. If the --ll option is supplied, the shell places a dash at the begin- ning of the zeroth argument passed to _c_o_m_m_a_n_d. This is what _l_o_- - _g_i_n(1) does. The --cc option causes _c_o_m_m_a_n_d to be executed with - an empty environment. If --aa is supplied, the shell passes _n_a_m_e + _g_i_n(1) does. The --cc option causes _c_o_m_m_a_n_d to be executed with + an empty environment. If --aa is supplied, the shell passes _n_a_m_e as the zeroth argument to the executed command. If _c_o_m_m_a_n_d can- - not be executed for some reason, a non-interactive shell exits, - unless the eexxeeccffaaiill shell option is enabled. In that case, it - returns failure. An interactive shell returns failure if the - file cannot be executed. A subshell exits unconditionally if - eexxeecc fails. If _c_o_m_m_a_n_d is not specified, any redirections take - effect in the current shell, and the return status is 0. If + not be executed for some reason, a non-interactive shell exits, + unless the eexxeeccffaaiill shell option is enabled. In that case, it + returns failure. An interactive shell returns failure if the + file cannot be executed. A subshell exits unconditionally if + eexxeecc fails. If _c_o_m_m_a_n_d is not specified, any redirections take + effect in the current shell, and the return status is 0. If there is a redirection error, the return status is 1. eexxiitt [_n] - Cause the shell to exit with a status of _n. If _n is omitted, + Cause the shell to exit with a status of _n. If _n is omitted, the exit status is that of the last command executed. A trap on EEXXIITT is executed before the shell terminates. eexxppoorrtt [--ffnn] [_n_a_m_e[=_w_o_r_d]] ... eexxppoorrtt --pp - The supplied _n_a_m_e_s are marked for automatic export to the envi- - ronment of subsequently executed commands. If the --ff option is - given, the _n_a_m_e_s refer to functions. If no _n_a_m_e_s are given, or - if the --pp option is supplied, a list of names of all exported - variables is printed. The --nn option causes the export property + The supplied _n_a_m_e_s are marked for automatic export to the envi- + ronment of subsequently executed commands. If the --ff option is + given, the _n_a_m_e_s refer to functions. If no _n_a_m_e_s are given, or + if the --pp option is supplied, a list of names of all exported + variables is printed. The --nn option causes the export property to be removed from each _n_a_m_e. If a variable name is followed by =_w_o_r_d, the value of the variable is set to _w_o_r_d. eexxppoorrtt returns an exit status of 0 unless an invalid option is encountered, one - of the _n_a_m_e_s is not a valid shell variable name, or --ff is sup- + of the _n_a_m_e_s is not a valid shell variable name, or --ff is sup- plied with a _n_a_m_e that is not a function. ffaallssee Does nothing, returns a non-zero status. ffcc [--ee _e_n_a_m_e] [--llnnrr] [_f_i_r_s_t] [_l_a_s_t] ffcc --ss [_p_a_t=_r_e_p] [_c_m_d] - The first form selects a range of commands from _f_i_r_s_t to _l_a_s_t - from the history list and displays or edits and re-executes - them. _F_i_r_s_t and _l_a_s_t may be specified as a string (to locate - the last command beginning with that string) or as a number (an - index into the history list, where a negative number is used as - an offset from the current command number). When listing, a - _f_i_r_s_t or _l_a_s_t of 0 is equivalent to -1 and -0 is equivalent to - the current command (usually the ffcc command); otherwise 0 is - equivalent to -1 and -0 is invalid. If _l_a_s_t is not specified, - it is set to the current command for listing (so that ``fc -l - -10'' prints the last 10 commands) and to _f_i_r_s_t otherwise. If - _f_i_r_s_t is not specified, it is set to the previous command for + The first form selects a range of commands from _f_i_r_s_t to _l_a_s_t + from the history list and displays or edits and re-executes + them. _F_i_r_s_t and _l_a_s_t may be specified as a string (to locate + the last command beginning with that string) or as a number (an + index into the history list, where a negative number is used as + an offset from the current command number). When listing, a + _f_i_r_s_t or _l_a_s_t of 0 is equivalent to -1 and -0 is equivalent to + the current command (usually the ffcc command); otherwise 0 is + equivalent to -1 and -0 is invalid. If _l_a_s_t is not specified, + it is set to the current command for listing (so that ``fc -l + -10'' prints the last 10 commands) and to _f_i_r_s_t otherwise. If + _f_i_r_s_t is not specified, it is set to the previous command for editing and -16 for listing. - The --nn option suppresses the command numbers when listing. The - --rr option reverses the order of the commands. If the --ll option - is given, the commands are listed on standard output. Other- - wise, the editor given by _e_n_a_m_e is invoked on a file containing - those commands. If _e_n_a_m_e is not given, the value of the FFCCEEDDIITT - variable is used, and the value of EEDDIITTOORR if FFCCEEDDIITT is not set. - If neither variable is set, _v_i is used. When editing is com- + The --nn option suppresses the command numbers when listing. The + --rr option reverses the order of the commands. If the --ll option + is given, the commands are listed on standard output. Other- + wise, the editor given by _e_n_a_m_e is invoked on a file containing + those commands. If _e_n_a_m_e is not given, the value of the FFCCEEDDIITT + variable is used, and the value of EEDDIITTOORR if FFCCEEDDIITT is not set. + If neither variable is set, _v_i is used. When editing is com- plete, the edited commands are echoed and executed. - In the second form, _c_o_m_m_a_n_d is re-executed after each instance - of _p_a_t is replaced by _r_e_p. _C_o_m_m_a_n_d is interpreted the same as - _f_i_r_s_t above. A useful alias to use with this is ``r="fc -s"'', - so that typing ``r cc'' runs the last command beginning with + In the second form, _c_o_m_m_a_n_d is re-executed after each instance + of _p_a_t is replaced by _r_e_p. _C_o_m_m_a_n_d is interpreted the same as + _f_i_r_s_t above. A useful alias to use with this is ``r="fc -s"'', + so that typing ``r cc'' runs the last command beginning with ``cc'' and typing ``r'' re-executes the last command. - If the first form is used, the return value is 0 unless an in- - valid option is encountered or _f_i_r_s_t or _l_a_s_t specify history - lines out of range. If the --ee option is supplied, the return + If the first form is used, the return value is 0 unless an in- + valid option is encountered or _f_i_r_s_t or _l_a_s_t specify history + lines out of range. If the --ee option is supplied, the return value is the value of the last command executed or failure if an error occurs with the temporary file of commands. If the second - form is used, the return status is that of the command re-exe- - cuted, unless _c_m_d does not specify a valid history line, in + form is used, the return status is that of the command re-exe- + cuted, unless _c_m_d does not specify a valid history line, in which case ffcc returns failure. ffgg [_j_o_b_s_p_e_c] - Resume _j_o_b_s_p_e_c in the foreground, and make it the current job. + Resume _j_o_b_s_p_e_c in the foreground, and make it the current job. If _j_o_b_s_p_e_c is not present, the shell's notion of the _c_u_r_r_e_n_t _j_o_b - is used. The return value is that of the command placed into - the foreground, or failure if run when job control is disabled + is used. The return value is that of the command placed into + the foreground, or failure if run when job control is disabled or, when run with job control enabled, if _j_o_b_s_p_e_c does not spec- - ify a valid job or _j_o_b_s_p_e_c specifies a job that was started + ify a valid job or _j_o_b_s_p_e_c specifies a job that was started without job control. ggeettooppttss _o_p_t_s_t_r_i_n_g _n_a_m_e [_a_r_g _._._.] - ggeettooppttss is used by shell procedures to parse positional parame- - ters. _o_p_t_s_t_r_i_n_g contains the option characters to be recog- - nized; if a character is followed by a colon, the option is ex- + ggeettooppttss is used by shell procedures to parse positional parame- + ters. _o_p_t_s_t_r_i_n_g contains the option characters to be recog- + nized; if a character is followed by a colon, the option is ex- pected to have an argument, which should be separated from it by - white space. The colon and question mark characters may not be - used as option characters. Each time it is invoked, ggeettooppttss - places the next option in the shell variable _n_a_m_e, initializing + white space. The colon and question mark characters may not be + used as option characters. Each time it is invoked, ggeettooppttss + places the next option in the shell variable _n_a_m_e, initializing _n_a_m_e if it does not exist, and the index of the next argument to be processed into the variable OOPPTTIINNDD. OOPPTTIINNDD is initialized to 1 each time the shell or a shell script is invoked. When an op- tion requires an argument, ggeettooppttss places that argument into the variable OOPPTTAARRGG. The shell does not reset OOPPTTIINNDD automatically; - it must be manually reset between multiple calls to ggeettooppttss - within the same shell invocation if a new set of parameters is + it must be manually reset between multiple calls to ggeettooppttss + within the same shell invocation if a new set of parameters is to be used. When the end of options is encountered, ggeettooppttss exits with a re- turn value greater than zero. OOPPTTIINNDD is set to the index of the first non-option argument, and _n_a_m_e is set to ?. - ggeettooppttss normally parses the positional parameters, but if more - arguments are supplied as _a_r_g values, ggeettooppttss parses those in- + ggeettooppttss normally parses the positional parameters, but if more + arguments are supplied as _a_r_g values, ggeettooppttss parses those in- stead. - ggeettooppttss can report errors in two ways. If the first character - of _o_p_t_s_t_r_i_n_g is a colon, _s_i_l_e_n_t error reporting is used. In - normal operation, diagnostic messages are printed when invalid - options or missing option arguments are encountered. If the - variable OOPPTTEERRRR is set to 0, no error messages will be dis- + ggeettooppttss can report errors in two ways. If the first character + of _o_p_t_s_t_r_i_n_g is a colon, _s_i_l_e_n_t error reporting is used. In + normal operation, diagnostic messages are printed when invalid + options or missing option arguments are encountered. If the + variable OOPPTTEERRRR is set to 0, no error messages will be dis- played, even if the first character of _o_p_t_s_t_r_i_n_g is not a colon. If an invalid option is seen, ggeettooppttss places ? into _n_a_m_e and, if - not silent, prints an error message and unsets OOPPTTAARRGG. If - ggeettooppttss is silent, the option character found is placed in OOPP-- + not silent, prints an error message and unsets OOPPTTAARRGG. If + ggeettooppttss is silent, the option character found is placed in OOPP-- TTAARRGG and no diagnostic message is printed. - If a required argument is not found, and ggeettooppttss is not silent, - a question mark (??) is placed in _n_a_m_e, OOPPTTAARRGG is unset, and a - diagnostic message is printed. If ggeettooppttss is silent, then a - colon (::) is placed in _n_a_m_e and OOPPTTAARRGG is set to the option + If a required argument is not found, and ggeettooppttss is not silent, + a question mark (??) is placed in _n_a_m_e, OOPPTTAARRGG is unset, and a + diagnostic message is printed. If ggeettooppttss is silent, then a + colon (::) is placed in _n_a_m_e and OOPPTTAARRGG is set to the option character found. - ggeettooppttss returns true if an option, specified or unspecified, is + ggeettooppttss returns true if an option, specified or unspecified, is found. It returns false if the end of options is encountered or an error occurs. hhaasshh [--llrr] [--pp _f_i_l_e_n_a_m_e] [--ddtt] [_n_a_m_e] Each time hhaasshh is invoked, the full pathname of the command _n_a_m_e - is determined by searching the directories in $$PPAATTHH and remem- + is determined by searching the directories in $$PPAATTHH and remem- bered. Any previously-remembered pathname is discarded. If the --pp option is supplied, no path search is performed, and _f_i_l_e_n_a_m_e - is used as the full filename of the command. The --rr option - causes the shell to forget all remembered locations. Assigning - to the PPAATTHH variable also clears all hashed filenames. The --dd - option causes the shell to forget the remembered location of - each _n_a_m_e. If the --tt option is supplied, the full pathname to - which each _n_a_m_e corresponds is printed. If multiple _n_a_m_e argu- - ments are supplied with --tt, the _n_a_m_e is printed before the - hashed full pathname. The --ll option causes output to be dis- + is used as the full filename of the command. The --rr option + causes the shell to forget all remembered locations. Assigning + to the PPAATTHH variable also clears all hashed filenames. The --dd + option causes the shell to forget the remembered location of + each _n_a_m_e. If the --tt option is supplied, the full pathname to + which each _n_a_m_e corresponds is printed. If multiple _n_a_m_e argu- + ments are supplied with --tt, the _n_a_m_e is printed before the + hashed full pathname. The --ll option causes output to be dis- played in a format that may be reused as input. If no arguments - are given, or if only --ll is supplied, information about remem- - bered commands is printed. The return status is true unless a + are given, or if only --ll is supplied, information about remem- + bered commands is printed. The return status is true unless a _n_a_m_e is not found or an invalid option is supplied. hheellpp [--ddmmss] [_p_a_t_t_e_r_n] - Display helpful information about builtin commands. If _p_a_t_t_e_r_n - is specified, hheellpp gives detailed help on all commands matching - _p_a_t_t_e_r_n; otherwise help for all the builtins and shell control + Display helpful information about builtin commands. If _p_a_t_t_e_r_n + is specified, hheellpp gives detailed help on all commands matching + _p_a_t_t_e_r_n; otherwise help for all the builtins and shell control structures is printed. --dd Display a short description of each _p_a_t_t_e_r_n --mm Display the description of each _p_a_t_t_e_r_n in a manpage-like @@ -5304,55 +5313,55 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS hhiissttoorryy --ss _a_r_g [_a_r_g _._._.] With no options, display the command history list with line num- bers. Lines listed with a ** have been modified. An argument of - _n lists only the last _n lines. If the shell variable HHIISSTTTTIIMMEE-- - FFOORRMMAATT is set and not null, it is used as a format string for - _s_t_r_f_t_i_m_e(3) to display the time stamp associated with each dis- - played history entry. No intervening blank is printed between - the formatted time stamp and the history line. If _f_i_l_e_n_a_m_e is - supplied, it is used as the name of the history file; if not, - the value of HHIISSTTFFIILLEE is used. If _f_i_l_e_n_a_m_e is not supplied and - HHIISSTTFFIILLEE is unset or null, the --aa,, --nn,, --rr,, and --ww options have + _n lists only the last _n lines. If the shell variable HHIISSTTTTIIMMEE-- + FFOORRMMAATT is set and not null, it is used as a format string for + _s_t_r_f_t_i_m_e(3) to display the time stamp associated with each dis- + played history entry. No intervening blank is printed between + the formatted time stamp and the history line. If _f_i_l_e_n_a_m_e is + supplied, it is used as the name of the history file; if not, + the value of HHIISSTTFFIILLEE is used. If _f_i_l_e_n_a_m_e is not supplied and + HHIISSTTFFIILLEE is unset or null, the --aa,, --nn,, --rr,, and --ww options have no effect. Options, if supplied, have the following meanings: --cc Clear the history list by deleting all the entries. --dd _o_f_f_s_e_t - Delete the history entry at position _o_f_f_s_e_t. If _o_f_f_s_e_t + Delete the history entry at position _o_f_f_s_e_t. If _o_f_f_s_e_t is negative, it is interpreted as relative to one greater than the last history position, so negative indices count - back from the end of the history, and an index of -1 + back from the end of the history, and an index of -1 refers to the current hhiissttoorryy --dd command. --dd _s_t_a_r_t-_e_n_d - Delete the range of history entries between positions - _s_t_a_r_t and _e_n_d, inclusive. Positive and negative values + Delete the range of history entries between positions + _s_t_a_r_t and _e_n_d, inclusive. Positive and negative values for _s_t_a_r_t and _e_n_d are interpreted as described above. - --aa Append the ``new'' history lines to the history file. - These are history lines entered since the beginning of + --aa Append the ``new'' history lines to the history file. + These are history lines entered since the beginning of the current bbaasshh session, but not already appended to the history file. - --nn Read the history lines not already read from the history - file into the current history list. These are lines ap- - pended to the history file since the beginning of the + --nn Read the history lines not already read from the history + file into the current history list. These are lines ap- + pended to the history file since the beginning of the current bbaasshh session. - --rr Read the contents of the history file and append them to + --rr Read the contents of the history file and append them to the current history list. --ww Write the current history list to the history file, over- writing the history file's contents. - --pp Perform history substitution on the following _a_r_g_s and - display the result on the standard output. Does not - store the results in the history list. Each _a_r_g must be + --pp Perform history substitution on the following _a_r_g_s and + display the result on the standard output. Does not + store the results in the history list. Each _a_r_g must be quoted to disable normal history expansion. - --ss Store the _a_r_g_s in the history list as a single entry. - The last command in the history list is removed before + --ss Store the _a_r_g_s in the history list as a single entry. + The last command in the history list is removed before the _a_r_g_s are added. - If the HHIISSTTTTIIMMEEFFOORRMMAATT variable is set, the time stamp informa- - tion associated with each history entry is written to the his- - tory file, marked with the history comment character. When the - history file is read, lines beginning with the history comment - character followed immediately by a digit are interpreted as + If the HHIISSTTTTIIMMEEFFOORRMMAATT variable is set, the time stamp informa- + tion associated with each history entry is written to the his- + tory file, marked with the history comment character. When the + history file is read, lines beginning with the history comment + character followed immediately by a digit are interpreted as timestamps for the following history entry. The return value is 0 unless an invalid option is encountered, an error occurs while - reading or writing the history file, an invalid _o_f_f_s_e_t or range - is supplied as an argument to --dd, or the history expansion sup- + reading or writing the history file, an invalid _o_f_f_s_e_t or range + is supplied as an argument to --dd, or the history expansion sup- plied as an argument to --pp fails. jjoobbss [--llnnpprrss] [ _j_o_b_s_p_e_c ... ] @@ -5360,15 +5369,15 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS The first form lists the active jobs. The options have the fol- lowing meanings: --ll List process IDs in addition to the normal information. - --nn Display information only about jobs that have changed + --nn Display information only about jobs that have changed status since the user was last notified of their status. - --pp List only the process ID of the job's process group + --pp List only the process ID of the job's process group leader. --rr Display only running jobs. --ss Display only stopped jobs. - If _j_o_b_s_p_e_c is given, output is restricted to information about - that job. The return status is 0 unless an invalid option is + If _j_o_b_s_p_e_c is given, output is restricted to information about + that job. The return status is 0 unless an invalid option is encountered or an invalid _j_o_b_s_p_e_c is supplied. If the --xx option is supplied, jjoobbss replaces any _j_o_b_s_p_e_c found in @@ -5377,247 +5386,253 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS kkiillll [--ss _s_i_g_s_p_e_c | --nn _s_i_g_n_u_m | --_s_i_g_s_p_e_c] [_p_i_d | _j_o_b_s_p_e_c] ... kkiillll --ll|--LL [_s_i_g_s_p_e_c | _e_x_i_t___s_t_a_t_u_s] - Send the signal named by _s_i_g_s_p_e_c or _s_i_g_n_u_m to the processes - named by _p_i_d or _j_o_b_s_p_e_c. _s_i_g_s_p_e_c is either a case-insensitive - signal name such as SSIIGGKKIILLLL (with or without the SSIIGG prefix) or - a signal number; _s_i_g_n_u_m is a signal number. If _s_i_g_s_p_e_c is not - present, then SSIIGGTTEERRMM is assumed. An argument of --ll lists the - signal names. If any arguments are supplied when --ll is given, - the names of the signals corresponding to the arguments are + Send the signal named by _s_i_g_s_p_e_c or _s_i_g_n_u_m to the processes + named by _p_i_d or _j_o_b_s_p_e_c. _s_i_g_s_p_e_c is either a case-insensitive + signal name such as SSIIGGKKIILLLL (with or without the SSIIGG prefix) or + a signal number; _s_i_g_n_u_m is a signal number. If _s_i_g_s_p_e_c is not + present, then SSIIGGTTEERRMM is assumed. An argument of --ll lists the + signal names. If any arguments are supplied when --ll is given, + the names of the signals corresponding to the arguments are listed, and the return status is 0. The _e_x_i_t___s_t_a_t_u_s argument to - --ll is a number specifying either a signal number or the exit - status of a process terminated by a signal. The --LL option is - equivalent to --ll. kkiillll returns true if at least one signal was + --ll is a number specifying either a signal number or the exit + status of a process terminated by a signal. The --LL option is + equivalent to --ll. kkiillll returns true if at least one signal was successfully sent, or false if an error occurs or an invalid op- tion is encountered. lleett _a_r_g [_a_r_g ...] Each _a_r_g is an arithmetic expression to be evaluated (see AARRIITTHH-- - MMEETTIICC EEVVAALLUUAATTIIOONN above). If the last _a_r_g evaluates to 0, lleett + MMEETTIICC EEVVAALLUUAATTIIOONN above). If the last _a_r_g evaluates to 0, lleett returns 1; 0 is returned otherwise. llooccaall [_o_p_t_i_o_n] [_n_a_m_e[=_v_a_l_u_e] ... | - ] - For each argument, a local variable named _n_a_m_e is created, and - assigned _v_a_l_u_e. The _o_p_t_i_o_n can be any of the options accepted + For each argument, a local variable named _n_a_m_e is created, and + assigned _v_a_l_u_e. The _o_p_t_i_o_n can be any of the options accepted by ddeeccllaarree. When llooccaall is used within a function, it causes the - variable _n_a_m_e to have a visible scope restricted to that func- - tion and its children. If _n_a_m_e is -, the set of shell options - is made local to the function in which llooccaall is invoked: shell - options changed using the sseett builtin inside the function after + variable _n_a_m_e to have a visible scope restricted to that func- + tion and its children. If _n_a_m_e is -, the set of shell options + is made local to the function in which llooccaall is invoked: shell + options changed using the sseett builtin inside the function after the call to llooccaall are restored to their original values when the function returns. The restore is effected as if a series of sseett - commands were executed to restore the values that were in place - before the function. With no operands, llooccaall writes a list of - local variables to the standard output. It is an error to use + commands were executed to restore the values that were in place + before the function. With no operands, llooccaall writes a list of + local variables to the standard output. It is an error to use llooccaall when not within a function. The return status is 0 unless - llooccaall is used outside a function, an invalid _n_a_m_e is supplied, + llooccaall is used outside a function, an invalid _n_a_m_e is supplied, or _n_a_m_e is a readonly variable. llooggoouutt Exit a login shell. - mmaappffiillee [--dd _d_e_l_i_m] [--nn _c_o_u_n_t] [--OO _o_r_i_g_i_n] [--ss _c_o_u_n_t] [--tt] [--uu _f_d] [--CC + mmaappffiillee [--dd _d_e_l_i_m] [--nn _c_o_u_n_t] [--OO _o_r_i_g_i_n] [--ss _c_o_u_n_t] [--tt] [--uu _f_d] [--CC _c_a_l_l_b_a_c_k] [--cc _q_u_a_n_t_u_m] [_a_r_r_a_y] rreeaaddaarrrraayy [--dd _d_e_l_i_m] [--nn _c_o_u_n_t] [--OO _o_r_i_g_i_n] [--ss _c_o_u_n_t] [--tt] [--uu _f_d] [--CC _c_a_l_l_b_a_c_k] [--cc _q_u_a_n_t_u_m] [_a_r_r_a_y] - Read lines from the standard input into the indexed array vari- - able _a_r_r_a_y, or from file descriptor _f_d if the --uu option is sup- - plied. The variable MMAAPPFFIILLEE is the default _a_r_r_a_y. Options, if + Read lines from the standard input into the indexed array vari- + able _a_r_r_a_y, or from file descriptor _f_d if the --uu option is sup- + plied. The variable MMAAPPFFIILLEE is the default _a_r_r_a_y. Options, if supplied, have the following meanings: - --dd The first character of _d_e_l_i_m is used to terminate each - input line, rather than newline. If _d_e_l_i_m is the empty + --dd The first character of _d_e_l_i_m is used to terminate each + input line, rather than newline. If _d_e_l_i_m is the empty string, mmaappffiillee will terminate a line when it reads a NUL character. - --nn Copy at most _c_o_u_n_t lines. If _c_o_u_n_t is 0, all lines are + --nn Copy at most _c_o_u_n_t lines. If _c_o_u_n_t is 0, all lines are copied. - --OO Begin assigning to _a_r_r_a_y at index _o_r_i_g_i_n. The default + --OO Begin assigning to _a_r_r_a_y at index _o_r_i_g_i_n. The default index is 0. --ss Discard the first _c_o_u_n_t lines read. - --tt Remove a trailing _d_e_l_i_m (default newline) from each line + --tt Remove a trailing _d_e_l_i_m (default newline) from each line read. - --uu Read lines from file descriptor _f_d instead of the stan- + --uu Read lines from file descriptor _f_d instead of the stan- dard input. - --CC Evaluate _c_a_l_l_b_a_c_k each time _q_u_a_n_t_u_m lines are read. The + --CC Evaluate _c_a_l_l_b_a_c_k each time _q_u_a_n_t_u_m lines are read. The --cc option specifies _q_u_a_n_t_u_m. - --cc Specify the number of lines read between each call to + --cc Specify the number of lines read between each call to _c_a_l_l_b_a_c_k. - If --CC is specified without --cc, the default quantum is 5000. + If --CC is specified without --cc, the default quantum is 5000. When _c_a_l_l_b_a_c_k is evaluated, it is supplied the index of the next array element to be assigned and the line to be assigned to that - element as additional arguments. _c_a_l_l_b_a_c_k is evaluated after + element as additional arguments. _c_a_l_l_b_a_c_k is evaluated after the line is read but before the array element is assigned. - If not supplied with an explicit origin, mmaappffiillee will clear _a_r_- + If not supplied with an explicit origin, mmaappffiillee will clear _a_r_- _r_a_y before assigning to it. - mmaappffiillee returns successfully unless an invalid option or option - argument is supplied, _a_r_r_a_y is invalid or unassignable, or if + mmaappffiillee returns successfully unless an invalid option or option + argument is supplied, _a_r_r_a_y is invalid or unassignable, or if _a_r_r_a_y is not an indexed array. ppooppdd [-nn] [+_n] [-_n] Removes entries from the directory stack. The elements are num- - bered from 0 starting at the first directory listed by ddiirrss. - With no arguments, ppooppdd removes the top directory from the + bered from 0 starting at the first directory listed by ddiirrss. + With no arguments, ppooppdd removes the top directory from the stack, and changes to the new top directory. Arguments, if sup- plied, have the following meanings: - --nn Suppresses the normal change of directory when removing + --nn Suppresses the normal change of directory when removing directories from the stack, so that only the stack is ma- nipulated. - ++_n Removes the _nth entry counting from the left of the list - shown by ddiirrss, starting with zero, from the stack. For - example: ``popd +0'' removes the first directory, ``popd + ++_n Removes the _nth entry counting from the left of the list + shown by ddiirrss, starting with zero, from the stack. For + example: ``popd +0'' removes the first directory, ``popd +1'' the second. --_n Removes the _nth entry counting from the right of the list - shown by ddiirrss, starting with zero. For example: ``popd - -0'' removes the last directory, ``popd -1'' the next to + shown by ddiirrss, starting with zero. For example: ``popd + -0'' removes the last directory, ``popd -1'' the next to last. - If the top element of the directory stack is modified, and the - _-_n option was not supplied, ppooppdd uses the ccdd builtin to change + If the top element of the directory stack is modified, and the + _-_n option was not supplied, ppooppdd uses the ccdd builtin to change to the directory at the top of the stack. If the ccdd fails, ppooppdd returns a non-zero value. - Otherwise, ppooppdd returns false if an invalid option is encoun- + Otherwise, ppooppdd returns false if an invalid option is encoun- tered, the directory stack is empty, or a non-existent directory stack entry is specified. - If the ppooppdd command is successful, bash runs ddiirrss to show the - final contents of the directory stack, and the return status is + If the ppooppdd command is successful, bash runs ddiirrss to show the + final contents of the directory stack, and the return status is 0. pprriinnttff [--vv _v_a_r] _f_o_r_m_a_t [_a_r_g_u_m_e_n_t_s] - Write the formatted _a_r_g_u_m_e_n_t_s to the standard output under the - control of the _f_o_r_m_a_t. The --vv option causes the output to be - assigned to the variable _v_a_r rather than being printed to the + Write the formatted _a_r_g_u_m_e_n_t_s to the standard output under the + control of the _f_o_r_m_a_t. The --vv option causes the output to be + assigned to the variable _v_a_r rather than being printed to the standard output. - The _f_o_r_m_a_t is a character string which contains three types of - objects: plain characters, which are simply copied to standard - output, character escape sequences, which are converted and - copied to the standard output, and format specifications, each - of which causes printing of the next successive _a_r_g_u_m_e_n_t. In + The _f_o_r_m_a_t is a character string which contains three types of + objects: plain characters, which are simply copied to standard + output, character escape sequences, which are converted and + copied to the standard output, and format specifications, each + of which causes printing of the next successive _a_r_g_u_m_e_n_t. In addition to the standard _p_r_i_n_t_f(3) format characters ccssnnddiioouuxxXXee-- EEffFFggGGaaAA, pprriinnttff interprets the following additional format spec- ifiers: %%bb causes pprriinnttff to expand backslash escape sequences in the corresponding _a_r_g_u_m_e_n_t in the same way as eecchhoo --ee. - %%qq causes pprriinnttff to output the corresponding _a_r_g_u_m_e_n_t in a - format that can be reused as shell input. %%qq and %%QQ use - the $$'''' quoting style if any characters in the argument - string require it, and backslash quoting otherwise. If - the format string uses the _p_r_i_n_t_f alternate form, these + %%qq causes pprriinnttff to output the corresponding _a_r_g_u_m_e_n_t in a + format that can be reused as shell input. %%qq and %%QQ use + the $$'''' quoting style if any characters in the argument + string require it, and backslash quoting otherwise. If + the format string uses the _p_r_i_n_t_f alternate form, these two formats quote the argument string using single quotes. - %%QQ like %%qq, but applies any supplied precision to the _a_r_g_u_- + %%QQ like %%qq, but applies any supplied precision to the _a_r_g_u_- _m_e_n_t before quoting it. %%((_d_a_t_e_f_m_t))TT - causes pprriinnttff to output the date-time string resulting - from using _d_a_t_e_f_m_t as a format string for _s_t_r_f_t_i_m_e(3). + causes pprriinnttff to output the date-time string resulting + from using _d_a_t_e_f_m_t as a format string for _s_t_r_f_t_i_m_e(3). The corresponding _a_r_g_u_m_e_n_t is an integer representing the - number of seconds since the epoch. Two special argument - values may be used: -1 represents the current time, and - -2 represents the time the shell was invoked. If no ar- + number of seconds since the epoch. Two special argument + values may be used: -1 represents the current time, and + -2 represents the time the shell was invoked. If no ar- gument is specified, conversion behaves as if -1 had been - given. This is an exception to the usual pprriinnttff behav- + given. This is an exception to the usual pprriinnttff behav- ior. The %b, %q, and %T format specifiers all use the field width and precision arguments from the format specification and write that - many bytes from (or use that wide a field for) the expanded ar- - gument, which usually contains more characters than the origi- + many bytes from (or use that wide a field for) the expanded ar- + gument, which usually contains more characters than the origi- nal. The %n format specifier accepts a corresponding argument that is treated as a shell variable name. - The %s and %c format specifiers accept an l (long) modifier, + The %s and %c format specifiers accept an l (long) modifier, which forces them to convert the argument string to a wide-char- acter string and apply any supplied field width and precision in terms of characters, not bytes. - Arguments to non-string format specifiers are treated as C con- + Arguments to non-string format specifiers are treated as C con- stants, except that a leading plus or minus sign is allowed, and - if the leading character is a single or double quote, the value + if the leading character is a single or double quote, the value is the ASCII value of the following character. - The _f_o_r_m_a_t is reused as necessary to consume all of the _a_r_g_u_- + The _f_o_r_m_a_t is reused as necessary to consume all of the _a_r_g_u_- _m_e_n_t_s. If the _f_o_r_m_a_t requires more _a_r_g_u_m_e_n_t_s than are supplied, - the extra format specifications behave as if a zero value or - null string, as appropriate, had been supplied. The return - value is zero on success, non-zero if an invalid option is sup- + the extra format specifications behave as if a zero value or + null string, as appropriate, had been supplied. The return + value is zero on success, non-zero if an invalid option is sup- plied or a write or assignment error occurs. ppuusshhdd [--nn] [+_n] [-_n] ppuusshhdd [--nn] [_d_i_r] - Adds a directory to the top of the directory stack, or rotates - the stack, making the new top of the stack the current working - directory. With no arguments, ppuusshhdd exchanges the top two ele- - ments of the directory stack. Arguments, if supplied, have the + Adds a directory to the top of the directory stack, or rotates + the stack, making the new top of the stack the current working + directory. With no arguments, ppuusshhdd exchanges the top two ele- + ments of the directory stack. Arguments, if supplied, have the following meanings: - --nn Suppresses the normal change of directory when rotating - or adding directories to the stack, so that only the + --nn Suppresses the normal change of directory when rotating + or adding directories to the stack, so that only the stack is manipulated. - ++_n Rotates the stack so that the _nth directory (counting - from the left of the list shown by ddiirrss, starting with + ++_n Rotates the stack so that the _nth directory (counting + from the left of the list shown by ddiirrss, starting with zero) is at the top. - --_n Rotates the stack so that the _nth directory (counting - from the right of the list shown by ddiirrss, starting with + --_n Rotates the stack so that the _nth directory (counting + from the right of the list shown by ddiirrss, starting with zero) is at the top. _d_i_r Adds _d_i_r to the directory stack at the top After the stack has been modified, if the --nn option was not sup- - plied, ppuusshhdd uses the ccdd builtin to change to the directory at + plied, ppuusshhdd uses the ccdd builtin to change to the directory at the top of the stack. If the ccdd fails, ppuusshhdd returns a non-zero value. - Otherwise, if no arguments are supplied, ppuusshhdd returns 0 unless - the directory stack is empty. When rotating the directory - stack, ppuusshhdd returns 0 unless the directory stack is empty or a + Otherwise, if no arguments are supplied, ppuusshhdd returns 0 unless + the directory stack is empty. When rotating the directory + stack, ppuusshhdd returns 0 unless the directory stack is empty or a non-existent directory stack element is specified. - If the ppuusshhdd command is successful, bash runs ddiirrss to show the + If the ppuusshhdd command is successful, bash runs ddiirrss to show the final contents of the directory stack. ppwwdd [--LLPP] - Print the absolute pathname of the current working directory. + Print the absolute pathname of the current working directory. The pathname printed contains no symbolic links if the --PP option is supplied or the --oo pphhyyssiiccaall option to the sseett builtin command - is enabled. If the --LL option is used, the pathname printed may - contain symbolic links. The return status is 0 unless an error + is enabled. If the --LL option is used, the pathname printed may + contain symbolic links. The return status is 0 unless an error occurs while reading the name of the current directory or an in- valid option is supplied. - rreeaadd [--eerrss] [--aa _a_n_a_m_e] [--dd _d_e_l_i_m] [--ii _t_e_x_t] [--nn _n_c_h_a_r_s] [--NN _n_c_h_a_r_s] [--pp - _p_r_o_m_p_t] [--tt _t_i_m_e_o_u_t] [--uu _f_d] [_n_a_m_e ...] - One line is read from the standard input, or from the file de- + rreeaadd [--EEeerrss] [--aa _a_n_a_m_e] [--dd _d_e_l_i_m] [--ii _t_e_x_t] [--nn _n_c_h_a_r_s] [--NN _n_c_h_a_r_s] + [--pp _p_r_o_m_p_t] [--tt _t_i_m_e_o_u_t] [--uu _f_d] [_n_a_m_e ...] + One line is read from the standard input, or from the file de- scriptor _f_d supplied as an argument to the --uu option, split into - words as described above under WWoorrdd SSpplliittttiinngg, and the first - word is assigned to the first _n_a_m_e, the second word to the sec- - ond _n_a_m_e, and so on. If there are more words than names, the + words as described above under WWoorrdd SSpplliittttiinngg, and the first + word is assigned to the first _n_a_m_e, the second word to the sec- + ond _n_a_m_e, and so on. If there are more words than names, the remaining words and their intervening delimiters are assigned to - the last _n_a_m_e. If there are fewer words read from the input - stream than names, the remaining names are assigned empty val- - ues. The characters in IIFFSS are used to split the line into - words using the same rules the shell uses for expansion (de- - scribed above under WWoorrdd SSpplliittttiinngg). The backslash character + the last _n_a_m_e. If there are fewer words read from the input + stream than names, the remaining names are assigned empty val- + ues. The characters in IIFFSS are used to split the line into + words using the same rules the shell uses for expansion (de- + scribed above under WWoorrdd SSpplliittttiinngg). The backslash character (\\) may be used to remove any special meaning for the next char- - acter read and for line continuation. Options, if supplied, + acter read and for line continuation. Options, if supplied, have the following meanings: --aa _a_n_a_m_e The words are assigned to sequential indices of the array variable _a_n_a_m_e, starting at 0. _a_n_a_m_e is unset before any - new values are assigned. Other _n_a_m_e arguments are ig- + new values are assigned. Other _n_a_m_e arguments are ig- nored. --dd _d_e_l_i_m The first character of _d_e_l_i_m is used to terminate the in- - put line, rather than newline. If _d_e_l_i_m is the empty - string, rreeaadd will terminate a line when it reads a NUL + put line, rather than newline. If _d_e_l_i_m is the empty + string, rreeaadd will terminate a line when it reads a NUL character. - --ee If the standard input is coming from a terminal, rreeaaddlliinnee - (see RREEAADDLLIINNEE above) is used to obtain the line. Read- - line uses the current (or default, if line editing was - not previously active) editing settings, but uses read- - line's default filename completion. + --ee If the standard input is coming from a terminal, rreeaadd + uses rreeaaddlliinnee (see RREEAADDLLIINNEE above) to obtain the line. + Readline uses the current (or default, if line editing + was not previously active) editing settings, but uses + readline's default filename completion. + --EE If the standard input is coming from a terminal, rreeaadd + uses rreeaaddlliinnee (see RREEAADDLLIINNEE above) to obtain the line. + Readline uses the current (or default, if line editing + was not previously active) editing settings, but uses + bash's default completion, including programmable comple- + tion. --ii _t_e_x_t If rreeaaddlliinnee is being used to read the line, _t_e_x_t is placed into the editing buffer before editing begins. @@ -6820,4 +6835,4 @@ BBUUGGSS -GNU Bash 5.3 2023 August 2 BASH(1) +GNU Bash 5.3 2023 August 15 BASH(1) diff --git a/doc/bash.1 b/doc/bash.1 index 1ffa08f0..592fc082 100644 --- a/doc/bash.1 +++ b/doc/bash.1 @@ -5,14 +5,14 @@ .\" Case Western Reserve University .\" chet.ramey@case.edu .\" -.\" Last Change: Thu Aug 10 10:49:52 EDT 2023 +.\" Last Change: Tue Aug 15 16:02:58 EDT 2023 .\" .\" bash_builtins, strip all but Built-Ins section .\" avoid a warning about an undefined register .\" .if !rzY .nr zY 0 .if \n(zZ=1 .ig zZ .if \n(zY=1 .ig zY -.TH BASH 1 "2023 August 10" "GNU Bash 5.3" +.TH BASH 1 "2023 August 15" "GNU Bash 5.3" .\" .\" There's some problem with having a `@' .\" in a tagged paragraph with the BSD man macros. @@ -7552,13 +7552,13 @@ The second is to select portions of that line for inclusion into the current one. The line selected from the history is the \fIevent\fP, and the portions of that line that are acted upon are \fIwords\fP. +The line is broken into words in the same fashion as when reading input, +so that several \fImetacharacter\fP-separated words surrounded by +quotes are considered one word. The \fIevent designator\fP selects the event, the optional \fIword designator\fP selects words from the event, and various optional \fImodifiers\fP are available to manipulate the selected words. -The line is broken into words in the same fashion as when reading input, -so that several \fImetacharacter\fP-separated words surrounded by -quotes are considered one word. .PP History expansions are introduced by the appearance of the history expansion character, which is \^\fB!\fP\^ by default. @@ -9777,7 +9777,7 @@ The return status is 0 unless an error occurs while reading the name of the current directory or an invalid option is supplied. .TP -\fBread\fP [\fB\-ers\fP] [\fB\-a\fP \fIaname\fP] [\fB\-d\fP \fIdelim\fP] [\fB\-i\fP \fItext\fP] [\fB\-n\fP \fInchars\fP] [\fB\-N\fP \fInchars\fP] [\fB\-p\fP \fIprompt\fP] [\fB\-t\fP \fItimeout\fP] [\fB\-u\fP \fIfd\fP] [\fIname\fP ...] +\fBread\fP [\fB\-Eers\fP] [\fB\-a\fP \fIaname\fP] [\fB\-d\fP \fIdelim\fP] [\fB\-i\fP \fItext\fP] [\fB\-n\fP \fInchars\fP] [\fB\-N\fP \fInchars\fP] [\fB\-p\fP \fIprompt\fP] [\fB\-t\fP \fItimeout\fP] [\fB\-u\fP \fIfd\fP] [\fIname\fP ...] One line is read from the standard input, or from the file descriptor \fIfd\fP supplied as an argument to the \fB\-u\fP option, split into words as described @@ -9827,16 +9827,32 @@ when it reads a NUL character. .B \-e If the standard input is coming from a terminal, +\fBread\fP uses .B readline (see .SM .B READLINE .ie \n(zZ=1 in \fIbash(1)\fP) .el above) -is used to obtain the line. +to obtain the line. Readline uses the current (or default, if line editing was not previously active) editing settings, but uses readline's default filename completion. .TP +.B \-E +If the standard input +is coming from a terminal, +\fBread\fP uses +.B readline +(see +.SM +.B READLINE +.ie \n(zZ=1 in \fIbash(1)\fP) +.el above) +to obtain the line. +Readline uses the current (or default, if line editing was not previously +active) editing settings, but uses bash's default completion, including +programmable completion. +.TP .B \-i \fItext\fP If .B readline diff --git a/doc/bash.html b/doc/bash.html index ca5c8c39..124463bd 100644 --- a/doc/bash.html +++ b/doc/bash.html @@ -3,7 +3,7 @@ -
BASH(1)2023 August 2BASH(1) +BASH(1)2023 August 15BASH(1)

Index @@ -9548,12 +9548,20 @@ The second is to select portions of that line for inclusion into the current one. The line selected from the history is the event, and the portions of that line that are acted upon are words. -Various modifiers are available to manipulate the selected words. The line is broken into words in the same fashion as when reading input, so that several metacharacter-separated words surrounded by quotes are considered one word. +The event designator selects the event, the optional +word designator selects words from the event, and +various optional modifiers are available to manipulate the +selected words. +

+ History expansions are introduced by the appearance of the history expansion character, which is ! by default. +History expansions may appear anywhere in the input, but do not nest. +

+ Only backslash (\) and single quotes can quote the history expansion character, but the history expansion character is also treated as quoted if it immediately precedes the closing double quote @@ -9562,10 +9570,8 @@ in a double-quoted string. Several characters inhibit history expansion if found immediately following the history expansion character, even if it is unquoted: -space, tab, newline, carriage return, -=, ;, &, and |. -If the extglob shell option is enabled, ( will also -inhibit expansion. +space, tab, newline, carriage return, =, +and the other shell metacharacters defined above.

Several shell options settable with the @@ -9632,6 +9638,10 @@ writing the history file. An event designator is a reference to a command line entry in the history list. +The event designator +consists of the portion of the word beginning with the history +expansion character and ending with the word designator if present, +or the end of the word. Unless the reference is absolute, events are relative to the current position in the history list.

@@ -12268,7 +12278,7 @@ option is used, the pathname printed may contain symbolic links. The return status is 0 unless an error occurs while reading the name of the current directory or an invalid option is supplied. -

read [-ers] [-a aname] [-d delim] [-i text] [-n nchars] [-N nchars] [-p prompt] [-t timeout] [-u fd] [name ...]
+
read [-Eers] [-a aname] [-d delim] [-i text] [-n nchars] [-N nchars] [-p prompt] [-t timeout] [-u fd] [name ...]
One line is read from the standard input, or from the file descriptor fd supplied as an argument to the -u option, split into words as described @@ -12328,6 +12338,7 @@ when it reads a NUL character.
If the standard input is coming from a terminal, +read uses readline (see @@ -12336,9 +12347,27 @@ is coming from a terminal, above) -is used to obtain the line. +to obtain the line. Readline uses the current (or default, if line editing was not previously active) editing settings, but uses readline's default filename completion. +
-E + +
+If the standard input +is coming from a terminal, +read uses +readline + +(see +READLINE + + + +above) +to obtain the line. +Readline uses the current (or default, if line editing was not previously +active) editing settings, but uses bash's default completion, including +programmable completion.
-i text
@@ -15086,7 +15115,7 @@ There may be only one active coprocess at a time.
-
GNU Bash 5.32023 August 2BASH(1) +GNU Bash 5.32023 August 15BASH(1)
@@ -15192,7 +15221,7 @@ There may be only one active coprocess at a time.
BUGS
-This document was created by man2html from /usr/local/src/bash/bash-20230808/doc/bash.1.
-Time: 09 August 2023 10:01:14 EDT +This document was created by man2html from /usr/local/src/bash/bash-20230812/doc/bash.1.
+Time: 15 August 2023 16:12:02 EDT diff --git a/doc/bash.info b/doc/bash.info index 6635fee7..f033ee96 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.3, 2 August 2023). +Bash shell (version 5.3, 15 August 2023). - This is Edition 5.3, last updated 2 August 2023, of 'The GNU Bash + This is Edition 5.3, last updated 15 August 2023, of 'The GNU Bash Reference Manual', for 'Bash', Version 5.3. Copyright (C) 1988-2023 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.3, 2 August 2023). The Bash home page is +Bash shell (version 5.3, 15 August 2023). The Bash home page is . - This is Edition 5.3, last updated 2 August 2023, of 'The GNU Bash + This is Edition 5.3, last updated 15 August 2023, of 'The GNU Bash Reference Manual', for 'Bash', Version 5.3. Bash contains features that appear in other popular shells, and some @@ -4263,7 +4263,7 @@ standard. assignment error occurs. 'read' - read [-ers] [-a ANAME] [-d DELIM] [-i TEXT] [-n NCHARS] + read [-Eers] [-a ANAME] [-d DELIM] [-i TEXT] [-n NCHARS] [-N NCHARS] [-p PROMPT] [-t TIMEOUT] [-u FD] [NAME ...] One line is read from the standard input, or from the file @@ -4299,6 +4299,12 @@ standard. was not previously active) editing settings, but uses Readline's default filename completion. + '-E' + Readline (*note Command Line Editing::) is used to obtain the + line. Readline uses the current (or default, if line editing + was not previously active) editing settings, but uses Bash's + default completion, including programmable completion. + '-i TEXT' If Readline is being used to read the line, TEXT is placed into the editing buffer before editing begins. @@ -10414,13 +10420,19 @@ functions about quoting still in effect from previous lines. History expansion takes place in two parts. The first is to determine which line from the history list should be used during substitution. The second is to select portions of that line for -inclusion into the current one. The line selected from the history is -called the "event", and the portions of that line that are acted upon -are called "words". Various "modifiers" are available to manipulate the -selected words. The line is broken into words in the same fashion that -Bash does, so that several words surrounded by quotes are considered one -word. History expansions are introduced by the appearance of the -history expansion character, which is '!' by default. +inclusion into the current one. + + The line selected from the history is called the "event", and the +portions of that line that are acted upon are called "words". The line +is broken into words in the same fashion that Bash does, so that several +words surrounded by quotes are considered one word. The "event +designator" selects the event, the optional "word designator" selects +words from the event, and various optional "modifiers" are available to +manipulate the selected words. + + History expansions are introduced by the appearance of the history +expansion character, which is '!' by default. History expansions may +appear anywhere in the input, but do not nest. History expansion implements shell-like quoting conventions: a backslash can be used to remove the special handling for the next @@ -10468,12 +10480,15 @@ File: bash.info, Node: Event Designators, Next: Word Designators, Up: History An event designator is a reference to a command line entry in the history list. Unless the reference is absolute, events are relative to -the current position in the history list. +the current position in the history list. The event designator consists +of the portion of the word beginning with the history expansion +character, and ending with the word designator if one is present, or the +end of the word. '!' Start a history substitution, except when followed by a space, tab, - the end of the line, '=', ';', '&', '|', or '(' (when the 'extglob' - shell option is enabled using the 'shopt' builtin). + the end of the line, '=', or the rest of the shell metacharacters + defined above (*note Definitions::). '!N' Refer to command line N. @@ -11433,13 +11448,13 @@ the baseline reference. variable as a default if no non-option arguments are supplied. The Bash 'read' builtin also accepts a prompt string with the '-p' option and will use Readline to obtain the line when given the '-e' - option. The 'read' builtin also has additional options to control - input: the '-s' option will turn off echoing of input characters as - they are read, the '-t' option will allow 'read' to time out if - input does not arrive within a specified number of seconds, the - '-n' option will allow reading only a specified number of - characters rather than a full line, and the '-d' option will read - until a particular character rather than newline. + or '-E' options. The 'read' builtin also has additional options to + control input: the '-s' option will turn off echoing of input + characters as they are read, the '-t' option will allow 'read' to + time out if input does not arrive within a specified number of + seconds, the '-n' option will allow reading only a specified number + of characters rather than a full line, and the '-d' option will + read until a particular character rather than newline. * The 'return' builtin may be used to abort execution of scripts executed with the '.' or 'source' builtins (*note Bourne Shell @@ -12148,7 +12163,7 @@ D.1 Index of Shell Builtin Commands * pwd: Bourne Shell Builtins. (line 218) * read: Bash Builtins. (line 513) -* readarray: Bash Builtins. (line 610) +* readarray: Bash Builtins. (line 616) * readonly: Bourne Shell Builtins. (line 228) * return: Bourne Shell Builtins. @@ -12157,7 +12172,7 @@ D.1 Index of Shell Builtin Commands * shift: Bourne Shell Builtins. (line 268) * shopt: The Shopt Builtin. (line 9) -* source: Bash Builtins. (line 619) +* source: Bash Builtins. (line 625) * suspend: Job Control Builtins. (line 116) * test: Bourne Shell Builtins. @@ -12168,12 +12183,12 @@ D.1 Index of Shell Builtin Commands (line 389) * true: Bourne Shell Builtins. (line 451) -* type: Bash Builtins. (line 624) -* typeset: Bash Builtins. (line 662) -* ulimit: Bash Builtins. (line 668) +* type: Bash Builtins. (line 630) +* typeset: Bash Builtins. (line 668) +* ulimit: Bash Builtins. (line 674) * umask: Bourne Shell Builtins. (line 456) -* unalias: Bash Builtins. (line 774) +* unalias: Bash Builtins. (line 780) * unset: Bourne Shell Builtins. (line 474) * wait: Job Control Builtins. @@ -12759,7 +12774,7 @@ D.5 Concept Index * functions, shell: Shell Functions. (line 6) * history builtins: Bash History Builtins. (line 6) -* history events: Event Designators. (line 8) +* history events: Event Designators. (line 11) * history expansion: History Interaction. (line 6) * history list: Bash History Facilities. (line 6) @@ -12849,138 +12864,138 @@ D.5 Concept Index  Tag Table: -Node: Top888 -Node: Introduction2799 -Node: What is Bash?3012 -Node: What is a shell?4123 -Node: Definitions6658 -Node: Basic Shell Features9606 -Node: Shell Syntax10822 -Node: Shell Operation11845 -Node: Quoting13135 -Node: Escape Character14436 -Node: Single Quotes14918 -Node: Double Quotes15263 -Node: ANSI-C Quoting16538 -Node: Locale Translation17847 -Node: Creating Internationalized Scripts19155 -Node: Comments23269 -Node: Shell Commands23884 -Node: Reserved Words24819 -Node: Simple Commands25572 -Node: Pipelines26223 -Node: Lists29206 -Node: Compound Commands30998 -Node: Looping Constructs32007 -Node: Conditional Constructs34499 -Node: Command Grouping48984 -Node: Coprocesses50459 -Node: GNU Parallel53119 -Node: Shell Functions54033 -Node: Shell Parameters61915 -Node: Positional Parameters66300 -Node: Special Parameters67199 -Node: Shell Expansions70410 -Node: Brace Expansion72495 -Node: Tilde Expansion75226 -Node: Shell Parameter Expansion77844 -Node: Command Substitution96434 -Node: Arithmetic Expansion99895 -Node: Process Substitution100860 -Node: Word Splitting101977 -Node: Filename Expansion104022 -Node: Pattern Matching106952 -Node: Quote Removal111951 -Node: Redirections112243 -Node: Executing Commands121933 -Node: Simple Command Expansion122600 -Node: Command Search and Execution124707 -Node: Command Execution Environment127091 -Node: Environment130123 -Node: Exit Status131783 -Node: Signals133564 -Node: Shell Scripts137010 -Node: Shell Builtin Commands140034 -Node: Bourne Shell Builtins142069 -Node: Bash Builtins165202 -Node: Modifying Shell Behavior197845 -Node: The Set Builtin198187 -Node: The Shopt Builtin209158 -Node: Special Builtins225293 -Node: Shell Variables226269 -Node: Bourne Shell Variables226703 -Node: Bash Variables228804 -Node: Bash Features263860 -Node: Invoking Bash264870 -Node: Bash Startup Files270906 -Node: Interactive Shells276034 -Node: What is an Interactive Shell?276442 -Node: Is this Shell Interactive?277088 -Node: Interactive Shell Behavior277900 -Node: Bash Conditional Expressions281526 -Node: Shell Arithmetic286165 -Node: Aliases289123 -Node: Arrays292014 -Node: The Directory Stack298572 -Node: Directory Stack Builtins299353 -Node: Controlling the Prompt303610 -Node: The Restricted Shell306572 -Node: Bash POSIX Mode309179 -Node: Shell Compatibility Mode325337 -Node: Job Control333578 -Node: Job Control Basics334035 -Node: Job Control Builtins339034 -Node: Job Control Variables344826 -Node: Command Line Editing345979 -Node: Introduction and Notation347647 -Node: Readline Interaction349267 -Node: Readline Bare Essentials350455 -Node: Readline Movement Commands352241 -Node: Readline Killing Commands353198 -Node: Readline Arguments355116 -Node: Searching356157 -Node: Readline Init File358340 -Node: Readline Init File Syntax359598 -Node: Conditional Init Constructs383620 -Node: Sample Init File387813 -Node: Bindable Readline Commands390934 -Node: Commands For Moving392135 -Node: Commands For History394183 -Node: Commands For Text399174 -Node: Commands For Killing403149 -Node: Numeric Arguments405850 -Node: Commands For Completion406986 -Node: Keyboard Macros411174 -Node: Miscellaneous Commands411859 -Node: Readline vi Mode417894 -Node: Programmable Completion418798 -Node: Programmable Completion Builtins426575 -Node: A Programmable Completion Example437692 -Node: Using History Interactively442937 -Node: Bash History Facilities443618 -Node: Bash History Builtins446626 -Node: History Interaction451714 -Node: Event Designators455331 -Node: Word Designators456698 -Node: Modifiers458560 -Node: Installing Bash460365 -Node: Basic Installation461499 -Node: Compilers and Options465218 -Node: Compiling For Multiple Architectures465956 -Node: Installation Names467645 -Node: Specifying the System Type469751 -Node: Sharing Defaults470465 -Node: Operation Controls471135 -Node: Optional Features472090 -Node: Reporting Bugs483306 -Node: Major Differences From The Bourne Shell484637 -Node: GNU Free Documentation License501483 -Node: Indexes526657 -Node: Builtin Index527108 -Node: Reserved Word Index534206 -Node: Variable Index536651 -Node: Function Index553782 -Node: Concept Index567500 +Node: Top890 +Node: Introduction2803 +Node: What is Bash?3016 +Node: What is a shell?4127 +Node: Definitions6662 +Node: Basic Shell Features9610 +Node: Shell Syntax10826 +Node: Shell Operation11849 +Node: Quoting13139 +Node: Escape Character14440 +Node: Single Quotes14922 +Node: Double Quotes15267 +Node: ANSI-C Quoting16542 +Node: Locale Translation17851 +Node: Creating Internationalized Scripts19159 +Node: Comments23273 +Node: Shell Commands23888 +Node: Reserved Words24823 +Node: Simple Commands25576 +Node: Pipelines26227 +Node: Lists29210 +Node: Compound Commands31002 +Node: Looping Constructs32011 +Node: Conditional Constructs34503 +Node: Command Grouping48988 +Node: Coprocesses50463 +Node: GNU Parallel53123 +Node: Shell Functions54037 +Node: Shell Parameters61919 +Node: Positional Parameters66304 +Node: Special Parameters67203 +Node: Shell Expansions70414 +Node: Brace Expansion72499 +Node: Tilde Expansion75230 +Node: Shell Parameter Expansion77848 +Node: Command Substitution96438 +Node: Arithmetic Expansion99899 +Node: Process Substitution100864 +Node: Word Splitting101981 +Node: Filename Expansion104026 +Node: Pattern Matching106956 +Node: Quote Removal111955 +Node: Redirections112247 +Node: Executing Commands121937 +Node: Simple Command Expansion122604 +Node: Command Search and Execution124711 +Node: Command Execution Environment127095 +Node: Environment130127 +Node: Exit Status131787 +Node: Signals133568 +Node: Shell Scripts137014 +Node: Shell Builtin Commands140038 +Node: Bourne Shell Builtins142073 +Node: Bash Builtins165206 +Node: Modifying Shell Behavior198141 +Node: The Set Builtin198483 +Node: The Shopt Builtin209454 +Node: Special Builtins225589 +Node: Shell Variables226565 +Node: Bourne Shell Variables226999 +Node: Bash Variables229100 +Node: Bash Features264156 +Node: Invoking Bash265166 +Node: Bash Startup Files271202 +Node: Interactive Shells276330 +Node: What is an Interactive Shell?276738 +Node: Is this Shell Interactive?277384 +Node: Interactive Shell Behavior278196 +Node: Bash Conditional Expressions281822 +Node: Shell Arithmetic286461 +Node: Aliases289419 +Node: Arrays292310 +Node: The Directory Stack298868 +Node: Directory Stack Builtins299649 +Node: Controlling the Prompt303906 +Node: The Restricted Shell306868 +Node: Bash POSIX Mode309475 +Node: Shell Compatibility Mode325633 +Node: Job Control333874 +Node: Job Control Basics334331 +Node: Job Control Builtins339330 +Node: Job Control Variables345122 +Node: Command Line Editing346275 +Node: Introduction and Notation347943 +Node: Readline Interaction349563 +Node: Readline Bare Essentials350751 +Node: Readline Movement Commands352537 +Node: Readline Killing Commands353494 +Node: Readline Arguments355412 +Node: Searching356453 +Node: Readline Init File358636 +Node: Readline Init File Syntax359894 +Node: Conditional Init Constructs383916 +Node: Sample Init File388109 +Node: Bindable Readline Commands391230 +Node: Commands For Moving392431 +Node: Commands For History394479 +Node: Commands For Text399470 +Node: Commands For Killing403445 +Node: Numeric Arguments406146 +Node: Commands For Completion407282 +Node: Keyboard Macros411470 +Node: Miscellaneous Commands412155 +Node: Readline vi Mode418190 +Node: Programmable Completion419094 +Node: Programmable Completion Builtins426871 +Node: A Programmable Completion Example437988 +Node: Using History Interactively443233 +Node: Bash History Facilities443914 +Node: Bash History Builtins446922 +Node: History Interaction452010 +Node: Event Designators455820 +Node: Word Designators457355 +Node: Modifiers459217 +Node: Installing Bash461022 +Node: Basic Installation462156 +Node: Compilers and Options465875 +Node: Compiling For Multiple Architectures466613 +Node: Installation Names468302 +Node: Specifying the System Type470408 +Node: Sharing Defaults471122 +Node: Operation Controls471792 +Node: Optional Features472747 +Node: Reporting Bugs483963 +Node: Major Differences From The Bourne Shell485294 +Node: GNU Free Documentation License502149 +Node: Indexes527323 +Node: Builtin Index527774 +Node: Reserved Word Index534872 +Node: Variable Index537317 +Node: Function Index554448 +Node: Concept Index568166  End Tag Table diff --git a/doc/bash.pdf b/doc/bash.pdf index 59b2ab8f..2650bd0e 100644 Binary files a/doc/bash.pdf and b/doc/bash.pdf differ diff --git a/doc/bashref.aux b/doc/bashref.aux index b71f20a6..5da57de6 100644 --- a/doc/bashref.aux +++ b/doc/bashref.aux @@ -158,8 +158,8 @@ @xrdef{Modifying Shell Behavior-snt}{Section@tie 4.3} @xrdef{The Set Builtin-title}{The Set Builtin} @xrdef{The Set Builtin-snt}{Section@tie 4.3.1} -@xrdef{Modifying Shell Behavior-pg}{68} -@xrdef{The Set Builtin-pg}{68} +@xrdef{Modifying Shell Behavior-pg}{69} +@xrdef{The Set Builtin-pg}{69} @xrdef{The Shopt Builtin-title}{The Shopt Builtin} @xrdef{The Shopt Builtin-snt}{Section@tie 4.3.2} @xrdef{The Shopt Builtin-pg}{73} @@ -172,72 +172,72 @@ @xrdef{Bourne Shell Variables-snt}{Section@tie 5.1} @xrdef{Bash Variables-title}{Bash Variables} @xrdef{Bash Variables-snt}{Section@tie 5.2} -@xrdef{Shell Variables-pg}{80} -@xrdef{Bourne Shell Variables-pg}{80} -@xrdef{Bash Variables-pg}{80} +@xrdef{Shell Variables-pg}{81} +@xrdef{Bourne Shell Variables-pg}{81} +@xrdef{Bash Variables-pg}{81} @xrdef{Bash Features-title}{Bash Features} @xrdef{Bash Features-snt}{Chapter@tie 6} @xrdef{Invoking Bash-title}{Invoking Bash} @xrdef{Invoking Bash-snt}{Section@tie 6.1} -@xrdef{Bash Features-pg}{93} -@xrdef{Invoking Bash-pg}{93} +@xrdef{Bash Features-pg}{94} +@xrdef{Invoking Bash-pg}{94} @xrdef{Bash Startup Files-title}{Bash Startup Files} @xrdef{Bash Startup Files-snt}{Section@tie 6.2} -@xrdef{Bash Startup Files-pg}{95} +@xrdef{Bash Startup Files-pg}{96} @xrdef{Interactive Shells-title}{Interactive Shells} @xrdef{Interactive Shells-snt}{Section@tie 6.3} @xrdef{What is an Interactive Shell?-title}{What is an Interactive Shell?} @xrdef{What is an Interactive Shell?-snt}{Section@tie 6.3.1} -@xrdef{Interactive Shells-pg}{96} +@xrdef{Interactive Shells-pg}{97} @xrdef{Is this Shell Interactive?-title}{Is this Shell Interactive?} @xrdef{Is this Shell Interactive?-snt}{Section@tie 6.3.2} @xrdef{Interactive Shell Behavior-title}{Interactive Shell Behavior} @xrdef{Interactive Shell Behavior-snt}{Section@tie 6.3.3} -@xrdef{What is an Interactive Shell?-pg}{97} -@xrdef{Is this Shell Interactive?-pg}{97} -@xrdef{Interactive Shell Behavior-pg}{97} +@xrdef{What is an Interactive Shell?-pg}{98} +@xrdef{Is this Shell Interactive?-pg}{98} +@xrdef{Interactive Shell Behavior-pg}{98} @xrdef{Bash Conditional Expressions-title}{Bash Conditional Expressions} @xrdef{Bash Conditional Expressions-snt}{Section@tie 6.4} -@xrdef{Bash Conditional Expressions-pg}{98} +@xrdef{Bash Conditional Expressions-pg}{99} @xrdef{Shell Arithmetic-title}{Shell Arithmetic} @xrdef{Shell Arithmetic-snt}{Section@tie 6.5} -@xrdef{Shell Arithmetic-pg}{100} +@xrdef{Shell Arithmetic-pg}{101} @xrdef{Aliases-title}{Aliases} @xrdef{Aliases-snt}{Section@tie 6.6} @xrdef{Arrays-title}{Arrays} @xrdef{Arrays-snt}{Section@tie 6.7} -@xrdef{Aliases-pg}{102} -@xrdef{Arrays-pg}{102} +@xrdef{Aliases-pg}{103} +@xrdef{Arrays-pg}{103} @xrdef{The Directory Stack-title}{The Directory Stack} @xrdef{The Directory Stack-snt}{Section@tie 6.8} -@xrdef{The Directory Stack-pg}{104} +@xrdef{The Directory Stack-pg}{105} @xrdef{Directory Stack Builtins-title}{Directory Stack Builtins} @xrdef{Directory Stack Builtins-snt}{Section@tie 6.8.1} -@xrdef{Directory Stack Builtins-pg}{105} +@xrdef{Directory Stack Builtins-pg}{106} @xrdef{Controlling the Prompt-title}{Controlling the Prompt} @xrdef{Controlling the Prompt-snt}{Section@tie 6.9} -@xrdef{Controlling the Prompt-pg}{106} +@xrdef{Controlling the Prompt-pg}{107} @xrdef{The Restricted Shell-title}{The Restricted Shell} @xrdef{The Restricted Shell-snt}{Section@tie 6.10} @xrdef{Bash POSIX Mode-title}{Bash and POSIX} @xrdef{Bash POSIX Mode-snt}{Section@tie 6.11} -@xrdef{The Restricted Shell-pg}{108} -@xrdef{Bash POSIX Mode-pg}{108} +@xrdef{The Restricted Shell-pg}{109} +@xrdef{Bash POSIX Mode-pg}{109} @xrdef{Shell Compatibility Mode-title}{Shell Compatibility Mode} @xrdef{Shell Compatibility Mode-snt}{Section@tie 6.12} -@xrdef{Shell Compatibility Mode-pg}{113} +@xrdef{Shell Compatibility Mode-pg}{114} @xrdef{Job Control-title}{Job Control} @xrdef{Job Control-snt}{Chapter@tie 7} @xrdef{Job Control Basics-title}{Job Control Basics} @xrdef{Job Control Basics-snt}{Section@tie 7.1} -@xrdef{Job Control-pg}{117} -@xrdef{Job Control Basics-pg}{117} +@xrdef{Job Control-pg}{118} +@xrdef{Job Control Basics-pg}{118} @xrdef{Job Control Builtins-title}{Job Control Builtins} @xrdef{Job Control Builtins-snt}{Section@tie 7.2} -@xrdef{Job Control Builtins-pg}{118} +@xrdef{Job Control Builtins-pg}{119} @xrdef{Job Control Variables-title}{Job Control Variables} @xrdef{Job Control Variables-snt}{Section@tie 7.3} -@xrdef{Job Control Variables-pg}{120} +@xrdef{Job Control Variables-pg}{121} @xrdef{Command Line Editing-title}{Command Line Editing} @xrdef{Command Line Editing-snt}{Chapter@tie 8} @xrdef{Introduction and Notation-title}{Introduction to Line Editing} @@ -246,145 +246,145 @@ @xrdef{Readline Interaction-snt}{Section@tie 8.2} @xrdef{Readline Bare Essentials-title}{Readline Bare Essentials} @xrdef{Readline Bare Essentials-snt}{Section@tie 8.2.1} -@xrdef{Command Line Editing-pg}{121} -@xrdef{Introduction and Notation-pg}{121} -@xrdef{Readline Interaction-pg}{121} +@xrdef{Command Line Editing-pg}{122} +@xrdef{Introduction and Notation-pg}{122} +@xrdef{Readline Interaction-pg}{122} @xrdef{Readline Movement Commands-title}{Readline Movement Commands} @xrdef{Readline Movement Commands-snt}{Section@tie 8.2.2} @xrdef{Readline Killing Commands-title}{Readline Killing Commands} @xrdef{Readline Killing Commands-snt}{Section@tie 8.2.3} -@xrdef{Readline Bare Essentials-pg}{122} -@xrdef{Readline Movement Commands-pg}{122} +@xrdef{Readline Bare Essentials-pg}{123} +@xrdef{Readline Movement Commands-pg}{123} @xrdef{Readline Arguments-title}{Readline Arguments} @xrdef{Readline Arguments-snt}{Section@tie 8.2.4} @xrdef{Searching-title}{Searching for Commands in the History} @xrdef{Searching-snt}{Section@tie 8.2.5} -@xrdef{Readline Killing Commands-pg}{123} -@xrdef{Readline Arguments-pg}{123} -@xrdef{Searching-pg}{123} +@xrdef{Readline Killing Commands-pg}{124} +@xrdef{Readline Arguments-pg}{124} +@xrdef{Searching-pg}{124} @xrdef{Readline Init File-title}{Readline Init File} @xrdef{Readline Init File-snt}{Section@tie 8.3} @xrdef{Readline Init File Syntax-title}{Readline Init File Syntax} @xrdef{Readline Init File Syntax-snt}{Section@tie 8.3.1} -@xrdef{Readline Init File-pg}{124} -@xrdef{Readline Init File Syntax-pg}{124} +@xrdef{Readline Init File-pg}{125} +@xrdef{Readline Init File Syntax-pg}{125} @xrdef{Conditional Init Constructs-title}{Conditional Init Constructs} @xrdef{Conditional Init Constructs-snt}{Section@tie 8.3.2} -@xrdef{Conditional Init Constructs-pg}{133} +@xrdef{Conditional Init Constructs-pg}{134} @xrdef{Sample Init File-title}{Sample Init File} @xrdef{Sample Init File-snt}{Section@tie 8.3.3} -@xrdef{Sample Init File-pg}{135} +@xrdef{Sample Init File-pg}{136} @xrdef{Bindable Readline Commands-title}{Bindable Readline Commands} @xrdef{Bindable Readline Commands-snt}{Section@tie 8.4} @xrdef{Commands For Moving-title}{Commands For Moving} @xrdef{Commands For Moving-snt}{Section@tie 8.4.1} -@xrdef{Bindable Readline Commands-pg}{138} -@xrdef{Commands For Moving-pg}{138} +@xrdef{Bindable Readline Commands-pg}{139} +@xrdef{Commands For Moving-pg}{139} @xrdef{Commands For History-title}{Commands For Manipulating The History} @xrdef{Commands For History-snt}{Section@tie 8.4.2} -@xrdef{Commands For History-pg}{139} +@xrdef{Commands For History-pg}{140} @xrdef{Commands For Text-title}{Commands For Changing Text} @xrdef{Commands For Text-snt}{Section@tie 8.4.3} -@xrdef{Commands For Text-pg}{141} +@xrdef{Commands For Text-pg}{142} @xrdef{Commands For Killing-title}{Killing And Yanking} @xrdef{Commands For Killing-snt}{Section@tie 8.4.4} -@xrdef{Commands For Killing-pg}{142} +@xrdef{Commands For Killing-pg}{143} @xrdef{Numeric Arguments-title}{Specifying Numeric Arguments} @xrdef{Numeric Arguments-snt}{Section@tie 8.4.5} -@xrdef{Numeric Arguments-pg}{143} +@xrdef{Numeric Arguments-pg}{144} @xrdef{Commands For Completion-title}{Letting Readline Type For You} @xrdef{Commands For Completion-snt}{Section@tie 8.4.6} -@xrdef{Commands For Completion-pg}{144} +@xrdef{Commands For Completion-pg}{145} @xrdef{Keyboard Macros-title}{Keyboard Macros} @xrdef{Keyboard Macros-snt}{Section@tie 8.4.7} -@xrdef{Keyboard Macros-pg}{145} +@xrdef{Keyboard Macros-pg}{146} @xrdef{Miscellaneous Commands-title}{Some Miscellaneous Commands} @xrdef{Miscellaneous Commands-snt}{Section@tie 8.4.8} -@xrdef{Miscellaneous Commands-pg}{146} +@xrdef{Miscellaneous Commands-pg}{147} @xrdef{Readline vi Mode-title}{Readline vi Mode} @xrdef{Readline vi Mode-snt}{Section@tie 8.5} @xrdef{Programmable Completion-title}{Programmable Completion} @xrdef{Programmable Completion-snt}{Section@tie 8.6} -@xrdef{Readline vi Mode-pg}{148} -@xrdef{Programmable Completion-pg}{148} +@xrdef{Readline vi Mode-pg}{149} +@xrdef{Programmable Completion-pg}{149} @xrdef{Programmable Completion Builtins-title}{Programmable Completion Builtins} @xrdef{Programmable Completion Builtins-snt}{Section@tie 8.7} -@xrdef{Programmable Completion Builtins-pg}{151} +@xrdef{Programmable Completion Builtins-pg}{152} @xrdef{A Programmable Completion Example-title}{A Programmable Completion Example} @xrdef{A Programmable Completion Example-snt}{Section@tie 8.8} -@xrdef{A Programmable Completion Example-pg}{155} +@xrdef{A Programmable Completion Example-pg}{156} @xrdef{Using History Interactively-title}{Using History Interactively} @xrdef{Using History Interactively-snt}{Chapter@tie 9} @xrdef{Bash History Facilities-title}{Bash History Facilities} @xrdef{Bash History Facilities-snt}{Section@tie 9.1} @xrdef{Bash History Builtins-title}{Bash History Builtins} @xrdef{Bash History Builtins-snt}{Section@tie 9.2} -@xrdef{Using History Interactively-pg}{158} -@xrdef{Bash History Facilities-pg}{158} -@xrdef{Bash History Builtins-pg}{158} +@xrdef{Using History Interactively-pg}{159} +@xrdef{Bash History Facilities-pg}{159} +@xrdef{Bash History Builtins-pg}{159} @xrdef{History Interaction-title}{History Expansion} @xrdef{History Interaction-snt}{Section@tie 9.3} -@xrdef{History Interaction-pg}{160} +@xrdef{History Interaction-pg}{161} @xrdef{Event Designators-title}{Event Designators} @xrdef{Event Designators-snt}{Section@tie 9.3.1} -@xrdef{Event Designators-pg}{161} +@xrdef{Event Designators-pg}{162} @xrdef{Word Designators-title}{Word Designators} @xrdef{Word Designators-snt}{Section@tie 9.3.2} +@xrdef{Word Designators-pg}{163} @xrdef{Modifiers-title}{Modifiers} @xrdef{Modifiers-snt}{Section@tie 9.3.3} -@xrdef{Word Designators-pg}{162} -@xrdef{Modifiers-pg}{162} +@xrdef{Modifiers-pg}{164} @xrdef{Installing Bash-title}{Installing Bash} @xrdef{Installing Bash-snt}{Chapter@tie 10} @xrdef{Basic Installation-title}{Basic Installation} @xrdef{Basic Installation-snt}{Section@tie 10.1} -@xrdef{Installing Bash-pg}{164} -@xrdef{Basic Installation-pg}{164} +@xrdef{Installing Bash-pg}{165} +@xrdef{Basic Installation-pg}{165} @xrdef{Compilers and Options-title}{Compilers and Options} @xrdef{Compilers and Options-snt}{Section@tie 10.2} @xrdef{Compiling For Multiple Architectures-title}{Compiling For Multiple Architectures} @xrdef{Compiling For Multiple Architectures-snt}{Section@tie 10.3} @xrdef{Installation Names-title}{Installation Names} @xrdef{Installation Names-snt}{Section@tie 10.4} -@xrdef{Compilers and Options-pg}{165} -@xrdef{Compiling For Multiple Architectures-pg}{165} +@xrdef{Compilers and Options-pg}{166} +@xrdef{Compiling For Multiple Architectures-pg}{166} @xrdef{Specifying the System Type-title}{Specifying the System Type} @xrdef{Specifying the System Type-snt}{Section@tie 10.5} @xrdef{Sharing Defaults-title}{Sharing Defaults} @xrdef{Sharing Defaults-snt}{Section@tie 10.6} @xrdef{Operation Controls-title}{Operation Controls} @xrdef{Operation Controls-snt}{Section@tie 10.7} -@xrdef{Installation Names-pg}{166} -@xrdef{Specifying the System Type-pg}{166} -@xrdef{Sharing Defaults-pg}{166} +@xrdef{Installation Names-pg}{167} +@xrdef{Specifying the System Type-pg}{167} +@xrdef{Sharing Defaults-pg}{167} @xrdef{Optional Features-title}{Optional Features} @xrdef{Optional Features-snt}{Section@tie 10.8} -@xrdef{Operation Controls-pg}{167} -@xrdef{Optional Features-pg}{167} +@xrdef{Operation Controls-pg}{168} +@xrdef{Optional Features-pg}{168} @xrdef{Reporting Bugs-title}{Reporting Bugs} @xrdef{Reporting Bugs-snt}{Appendix@tie @char65{}} -@xrdef{Reporting Bugs-pg}{173} +@xrdef{Reporting Bugs-pg}{174} @xrdef{Major Differences From The Bourne Shell-title}{Major Differences From The Bourne Shell} @xrdef{Major Differences From The Bourne Shell-snt}{Appendix@tie @char66{}} -@xrdef{Major Differences From The Bourne Shell-pg}{174} +@xrdef{Major Differences From The Bourne Shell-pg}{175} @xrdef{GNU Free Documentation License-title}{GNU Free Documentation License} @xrdef{GNU Free Documentation License-snt}{Appendix@tie @char67{}} -@xrdef{GNU Free Documentation License-pg}{180} +@xrdef{GNU Free Documentation License-pg}{181} @xrdef{Indexes-title}{Indexes} @xrdef{Indexes-snt}{Appendix@tie @char68{}} @xrdef{Builtin Index-title}{Index of Shell Builtin Commands} @xrdef{Builtin Index-snt}{Section@tie @char68.1} -@xrdef{Indexes-pg}{188} -@xrdef{Builtin Index-pg}{188} +@xrdef{Indexes-pg}{189} +@xrdef{Builtin Index-pg}{189} @xrdef{Reserved Word Index-title}{Index of Shell Reserved Words} @xrdef{Reserved Word Index-snt}{Section@tie @char68.2} @xrdef{Variable Index-title}{Parameter and Variable Index} @xrdef{Variable Index-snt}{Section@tie @char68.3} -@xrdef{Reserved Word Index-pg}{189} -@xrdef{Variable Index-pg}{190} +@xrdef{Reserved Word Index-pg}{190} +@xrdef{Variable Index-pg}{191} @xrdef{Function Index-title}{Function Index} @xrdef{Function Index-snt}{Section@tie @char68.4} -@xrdef{Function Index-pg}{192} +@xrdef{Function Index-pg}{193} @xrdef{Concept Index-title}{Concept Index} @xrdef{Concept Index-snt}{Section@tie @char68.5} -@xrdef{Concept Index-pg}{194} +@xrdef{Concept Index-pg}{195} diff --git a/doc/bashref.bt b/doc/bashref.bt index 90ded793..29c9dd85 100644 --- a/doc/bashref.bt +++ b/doc/bashref.bt @@ -23,39 +23,39 @@ \entry{unset}{57}{\code {unset}} \entry{alias}{57}{\code {alias}} \entry{bind}{57}{\code {bind}} -\entry{builtin}{58}{\code {builtin}} +\entry{builtin}{59}{\code {builtin}} \entry{caller}{59}{\code {caller}} \entry{command}{59}{\code {command}} \entry{declare}{59}{\code {declare}} \entry{echo}{61}{\code {echo}} \entry{enable}{62}{\code {enable}} \entry{help}{62}{\code {help}} -\entry{let}{62}{\code {let}} +\entry{let}{63}{\code {let}} \entry{local}{63}{\code {local}} \entry{logout}{63}{\code {logout}} \entry{mapfile}{63}{\code {mapfile}} \entry{printf}{64}{\code {printf}} \entry{read}{65}{\code {read}} \entry{readarray}{66}{\code {readarray}} -\entry{source}{66}{\code {source}} -\entry{type}{66}{\code {type}} +\entry{source}{67}{\code {source}} +\entry{type}{67}{\code {type}} \entry{typeset}{67}{\code {typeset}} \entry{ulimit}{67}{\code {ulimit}} -\entry{unalias}{68}{\code {unalias}} -\entry{set}{68}{\code {set}} +\entry{unalias}{69}{\code {unalias}} +\entry{set}{69}{\code {set}} \entry{shopt}{73}{\code {shopt}} -\entry{dirs}{105}{\code {dirs}} -\entry{popd}{105}{\code {popd}} -\entry{pushd}{105}{\code {pushd}} -\entry{bg}{118}{\code {bg}} -\entry{fg}{118}{\code {fg}} -\entry{jobs}{118}{\code {jobs}} -\entry{kill}{119}{\code {kill}} -\entry{wait}{119}{\code {wait}} -\entry{disown}{120}{\code {disown}} -\entry{suspend}{120}{\code {suspend}} -\entry{compgen}{151}{\code {compgen}} -\entry{complete}{151}{\code {complete}} -\entry{compopt}{154}{\code {compopt}} -\entry{fc}{159}{\code {fc}} -\entry{history}{159}{\code {history}} +\entry{dirs}{106}{\code {dirs}} +\entry{popd}{106}{\code {popd}} +\entry{pushd}{106}{\code {pushd}} +\entry{bg}{119}{\code {bg}} +\entry{fg}{119}{\code {fg}} +\entry{jobs}{119}{\code {jobs}} +\entry{kill}{120}{\code {kill}} +\entry{wait}{120}{\code {wait}} +\entry{disown}{121}{\code {disown}} +\entry{suspend}{121}{\code {suspend}} +\entry{compgen}{152}{\code {compgen}} +\entry{complete}{152}{\code {complete}} +\entry{compopt}{155}{\code {compopt}} +\entry{fc}{160}{\code {fc}} +\entry{history}{160}{\code {history}} diff --git a/doc/bashref.bts b/doc/bashref.bts index 7e92df69..b7139044 100644 --- a/doc/bashref.bts +++ b/doc/bashref.bts @@ -7,22 +7,22 @@ \initial {A} \entry{\code {alias}}{57} \initial {B} -\entry{\code {bg}}{118} +\entry{\code {bg}}{119} \entry{\code {bind}}{57} \entry{\code {break}}{50} -\entry{\code {builtin}}{58} +\entry{\code {builtin}}{59} \initial {C} \entry{\code {caller}}{59} \entry{\code {cd}}{50} \entry{\code {command}}{59} -\entry{\code {compgen}}{151} -\entry{\code {complete}}{151} -\entry{\code {compopt}}{154} +\entry{\code {compgen}}{152} +\entry{\code {complete}}{152} +\entry{\code {compopt}}{155} \entry{\code {continue}}{50} \initial {D} \entry{\code {declare}}{59} -\entry{\code {dirs}}{105} -\entry{\code {disown}}{120} +\entry{\code {dirs}}{106} +\entry{\code {disown}}{121} \initial {E} \entry{\code {echo}}{61} \entry{\code {enable}}{62} @@ -32,28 +32,28 @@ \entry{\code {export}}{51} \initial {F} \entry{\code {false}}{51} -\entry{\code {fc}}{159} -\entry{\code {fg}}{118} +\entry{\code {fc}}{160} +\entry{\code {fg}}{119} \initial {G} \entry{\code {getopts}}{51} \initial {H} \entry{\code {hash}}{52} \entry{\code {help}}{62} -\entry{\code {history}}{159} +\entry{\code {history}}{160} \initial {J} -\entry{\code {jobs}}{118} +\entry{\code {jobs}}{119} \initial {K} -\entry{\code {kill}}{119} +\entry{\code {kill}}{120} \initial {L} -\entry{\code {let}}{62} +\entry{\code {let}}{63} \entry{\code {local}}{63} \entry{\code {logout}}{63} \initial {M} \entry{\code {mapfile}}{63} \initial {P} -\entry{\code {popd}}{105} +\entry{\code {popd}}{106} \entry{\code {printf}}{64} -\entry{\code {pushd}}{105} +\entry{\code {pushd}}{106} \entry{\code {pwd}}{52} \initial {R} \entry{\code {read}}{65} @@ -61,22 +61,22 @@ \entry{\code {readonly}}{53} \entry{\code {return}}{53} \initial {S} -\entry{\code {set}}{68} +\entry{\code {set}}{69} \entry{\code {shift}}{53} \entry{\code {shopt}}{73} -\entry{\code {source}}{66} -\entry{\code {suspend}}{120} +\entry{\code {source}}{67} +\entry{\code {suspend}}{121} \initial {T} \entry{\code {test}}{53} \entry{\code {times}}{55} \entry{\code {trap}}{55} \entry{\code {true}}{56} -\entry{\code {type}}{66} +\entry{\code {type}}{67} \entry{\code {typeset}}{67} \initial {U} \entry{\code {ulimit}}{67} \entry{\code {umask}}{56} -\entry{\code {unalias}}{68} +\entry{\code {unalias}}{69} \entry{\code {unset}}{57} \initial {W} -\entry{\code {wait}}{119} +\entry{\code {wait}}{120} diff --git a/doc/bashref.cp b/doc/bashref.cp index b51b8d82..29e37b6e 100644 --- a/doc/bashref.cp +++ b/doc/bashref.cp @@ -75,55 +75,55 @@ \entry{signal handling}{46}{signal handling} \entry{shell script}{47}{shell script} \entry{special builtin}{79}{special builtin} -\entry{login shell}{95}{login shell} -\entry{interactive shell}{95}{interactive shell} -\entry{startup files}{95}{startup files} +\entry{login shell}{96}{login shell} \entry{interactive shell}{96}{interactive shell} -\entry{shell, interactive}{96}{shell, interactive} -\entry{expressions, conditional}{98}{expressions, conditional} -\entry{arithmetic, shell}{100}{arithmetic, shell} -\entry{shell arithmetic}{100}{shell arithmetic} -\entry{expressions, arithmetic}{100}{expressions, arithmetic} -\entry{evaluation, arithmetic}{100}{evaluation, arithmetic} -\entry{arithmetic evaluation}{100}{arithmetic evaluation} -\entry{arithmetic operators}{100}{arithmetic operators} -\entry{unary arithmetic operators}{100}{unary arithmetic operators} -\entry{binary arithmetic operators}{100}{binary arithmetic operators} -\entry{conditional arithmetic operator}{100}{conditional arithmetic operator} -\entry{bitwise arithmetic operators}{100}{bitwise arithmetic operators} -\entry{alias expansion}{102}{alias expansion} -\entry{arrays}{102}{arrays} -\entry{directory stack}{104}{directory stack} -\entry{prompting}{106}{prompting} -\entry{restricted shell}{108}{restricted shell} -\entry{POSIX description}{108}{POSIX description} -\entry{POSIX Mode}{109}{POSIX Mode} -\entry{Compatibility Level}{113}{Compatibility Level} -\entry{Compatibility Mode}{113}{Compatibility Mode} -\entry{job control}{117}{job control} -\entry{foreground}{117}{foreground} -\entry{background}{117}{background} -\entry{suspending jobs}{117}{suspending jobs} -\entry{Readline, how to use}{120}{Readline, how to use} -\entry{interaction, readline}{121}{interaction, readline} -\entry{notation, readline}{122}{notation, readline} -\entry{command editing}{122}{command editing} -\entry{editing command lines}{122}{editing command lines} -\entry{killing text}{123}{killing text} -\entry{yanking text}{123}{yanking text} -\entry{kill ring}{123}{kill ring} -\entry{initialization file, readline}{124}{initialization file, readline} -\entry{variables, readline}{125}{variables, readline} -\entry{programmable completion}{148}{programmable completion} -\entry{completion builtins}{151}{completion builtins} -\entry{History, how to use}{157}{History, how to use} -\entry{command history}{158}{command history} -\entry{history list}{158}{history list} -\entry{history builtins}{158}{history builtins} -\entry{history expansion}{160}{history expansion} -\entry{event designators}{161}{event designators} -\entry{history events}{161}{history events} -\entry{installation}{164}{installation} -\entry{configuration}{164}{configuration} -\entry{Bash installation}{164}{Bash installation} -\entry{Bash configuration}{164}{Bash configuration} +\entry{startup files}{96}{startup files} +\entry{interactive shell}{97}{interactive shell} +\entry{shell, interactive}{97}{shell, interactive} +\entry{expressions, conditional}{99}{expressions, conditional} +\entry{arithmetic, shell}{101}{arithmetic, shell} +\entry{shell arithmetic}{101}{shell arithmetic} +\entry{expressions, arithmetic}{101}{expressions, arithmetic} +\entry{evaluation, arithmetic}{101}{evaluation, arithmetic} +\entry{arithmetic evaluation}{101}{arithmetic evaluation} +\entry{arithmetic operators}{101}{arithmetic operators} +\entry{unary arithmetic operators}{101}{unary arithmetic operators} +\entry{binary arithmetic operators}{101}{binary arithmetic operators} +\entry{conditional arithmetic operator}{101}{conditional arithmetic operator} +\entry{bitwise arithmetic operators}{101}{bitwise arithmetic operators} +\entry{alias expansion}{103}{alias expansion} +\entry{arrays}{103}{arrays} +\entry{directory stack}{105}{directory stack} +\entry{prompting}{107}{prompting} +\entry{restricted shell}{109}{restricted shell} +\entry{POSIX description}{109}{POSIX description} +\entry{POSIX Mode}{110}{POSIX Mode} +\entry{Compatibility Level}{114}{Compatibility Level} +\entry{Compatibility Mode}{114}{Compatibility Mode} +\entry{job control}{118}{job control} +\entry{foreground}{118}{foreground} +\entry{background}{118}{background} +\entry{suspending jobs}{118}{suspending jobs} +\entry{Readline, how to use}{121}{Readline, how to use} +\entry{interaction, readline}{122}{interaction, readline} +\entry{notation, readline}{123}{notation, readline} +\entry{command editing}{123}{command editing} +\entry{editing command lines}{123}{editing command lines} +\entry{killing text}{124}{killing text} +\entry{yanking text}{124}{yanking text} +\entry{kill ring}{124}{kill ring} +\entry{initialization file, readline}{125}{initialization file, readline} +\entry{variables, readline}{126}{variables, readline} +\entry{programmable completion}{149}{programmable completion} +\entry{completion builtins}{152}{completion builtins} +\entry{History, how to use}{158}{History, how to use} +\entry{command history}{159}{command history} +\entry{history list}{159}{history list} +\entry{history builtins}{159}{history builtins} +\entry{history expansion}{161}{history expansion} +\entry{event designators}{162}{event designators} +\entry{history events}{162}{history events} +\entry{installation}{165}{installation} +\entry{configuration}{165}{configuration} +\entry{Bash installation}{165}{Bash installation} +\entry{Bash configuration}{165}{Bash configuration} diff --git a/doc/bashref.cps b/doc/bashref.cps index b3b11438..b4731a6a 100644 --- a/doc/bashref.cps +++ b/doc/bashref.cps @@ -1,24 +1,24 @@ \initial {A} -\entry{alias expansion}{102} -\entry{arithmetic evaluation}{100} +\entry{alias expansion}{103} +\entry{arithmetic evaluation}{101} \entry{arithmetic expansion}{35} -\entry{arithmetic operators}{100} -\entry{arithmetic, shell}{100} -\entry{arrays}{102} +\entry{arithmetic operators}{101} +\entry{arithmetic, shell}{101} +\entry{arrays}{103} \initial {B} -\entry{background}{117} -\entry{Bash configuration}{164} -\entry{Bash installation}{164} -\entry{binary arithmetic operators}{100} -\entry{bitwise arithmetic operators}{100} +\entry{background}{118} +\entry{Bash configuration}{165} +\entry{Bash installation}{165} +\entry{binary arithmetic operators}{101} +\entry{bitwise arithmetic operators}{101} \entry{Bourne shell}{5} \entry{brace expansion}{24} \entry{builtin}{3} \initial {C} -\entry{command editing}{122} +\entry{command editing}{123} \entry{command execution}{43} \entry{command expansion}{43} -\entry{command history}{158} +\entry{command history}{159} \entry{command search}{43} \entry{command substitution}{34} \entry{command timing}{10} @@ -31,20 +31,20 @@ \entry{commands, shell}{9} \entry{commands, simple}{9} \entry{comments, shell}{9} -\entry{Compatibility Level}{113} -\entry{Compatibility Mode}{113} -\entry{completion builtins}{151} -\entry{conditional arithmetic operator}{100} -\entry{configuration}{164} +\entry{Compatibility Level}{114} +\entry{Compatibility Mode}{114} +\entry{completion builtins}{152} +\entry{conditional arithmetic operator}{101} +\entry{configuration}{165} \entry{control operator}{3} \entry{coprocess}{18} \initial {D} -\entry{directory stack}{104} +\entry{directory stack}{105} \initial {E} -\entry{editing command lines}{122} +\entry{editing command lines}{123} \entry{environment}{45} -\entry{evaluation, arithmetic}{100} -\entry{event designators}{161} +\entry{evaluation, arithmetic}{101} +\entry{event designators}{162} \entry{execution environment}{44} \entry{exit status}{3, 45} \entry{expansion}{24} @@ -54,44 +54,44 @@ \entry{expansion, parameter}{26} \entry{expansion, pathname}{36} \entry{expansion, tilde}{25} -\entry{expressions, arithmetic}{100} -\entry{expressions, conditional}{98} +\entry{expressions, arithmetic}{101} +\entry{expressions, conditional}{99} \initial {F} \entry{field}{3} \entry{filename}{3} \entry{filename expansion}{36} -\entry{foreground}{117} +\entry{foreground}{118} \entry{functions, shell}{19} \initial {H} -\entry{history builtins}{158} -\entry{history events}{161} -\entry{history expansion}{160} -\entry{history list}{158} -\entry{History, how to use}{157} +\entry{history builtins}{159} +\entry{history events}{162} +\entry{history expansion}{161} +\entry{history list}{159} +\entry{History, how to use}{158} \initial {I} \entry{identifier}{3} -\entry{initialization file, readline}{124} -\entry{installation}{164} -\entry{interaction, readline}{121} -\entry{interactive shell}{95, 96} +\entry{initialization file, readline}{125} +\entry{installation}{165} +\entry{interaction, readline}{122} +\entry{interactive shell}{96, 97} \entry{internationalization}{7} \entry{internationalized scripts}{7} \initial {J} \entry{job}{3} -\entry{job control}{3, 117} +\entry{job control}{3, 118} \initial {K} -\entry{kill ring}{123} -\entry{killing text}{123} +\entry{kill ring}{124} +\entry{killing text}{124} \initial {L} \entry{localization}{7} -\entry{login shell}{95} +\entry{login shell}{96} \initial {M} \entry{matching, pattern}{37} \entry{metacharacter}{3} \initial {N} \entry{name}{3} \entry{native languages}{7} -\entry{notation, readline}{122} +\entry{notation, readline}{123} \initial {O} \entry{operator, shell}{3} \initial {P} @@ -103,46 +103,46 @@ \entry{pattern matching}{37} \entry{pipeline}{10} \entry{POSIX}{3} -\entry{POSIX description}{108} -\entry{POSIX Mode}{109} +\entry{POSIX description}{109} +\entry{POSIX Mode}{110} \entry{process group}{3} \entry{process group ID}{3} \entry{process substitution}{35} -\entry{programmable completion}{148} -\entry{prompting}{106} +\entry{programmable completion}{149} +\entry{prompting}{107} \initial {Q} \entry{quoting}{6} \entry{quoting, ANSI}{6} \initial {R} -\entry{Readline, how to use}{120} +\entry{Readline, how to use}{121} \entry{redirection}{39} \entry{reserved word}{3} \entry{reserved words}{9} -\entry{restricted shell}{108} +\entry{restricted shell}{109} \entry{return status}{4} \initial {S} -\entry{shell arithmetic}{100} +\entry{shell arithmetic}{101} \entry{shell function}{19} \entry{shell script}{47} \entry{shell variable}{21} -\entry{shell, interactive}{96} +\entry{shell, interactive}{97} \entry{signal}{4} \entry{signal handling}{46} \entry{special builtin}{4, 79} -\entry{startup files}{95} +\entry{startup files}{96} \entry{string translations}{7} -\entry{suspending jobs}{117} +\entry{suspending jobs}{118} \initial {T} \entry{tilde expansion}{25} \entry{token}{4} \entry{translation, native languages}{7} \initial {U} -\entry{unary arithmetic operators}{100} +\entry{unary arithmetic operators}{101} \initial {V} \entry{variable, shell}{21} -\entry{variables, readline}{125} +\entry{variables, readline}{126} \initial {W} \entry{word}{4} \entry{word splitting}{36} \initial {Y} -\entry{yanking text}{123} +\entry{yanking text}{124} diff --git a/doc/bashref.dvi b/doc/bashref.dvi index aac12e36..04fd4244 100644 Binary files a/doc/bashref.dvi and b/doc/bashref.dvi differ diff --git a/doc/bashref.fn b/doc/bashref.fn index 341a79c2..c8db4f78 100644 --- a/doc/bashref.fn +++ b/doc/bashref.fn @@ -1,114 +1,114 @@ -\entry{beginning-of-line (C-a)}{138}{\code {beginning-of-line (C-a)}} -\entry{end-of-line (C-e)}{138}{\code {end-of-line (C-e)}} -\entry{forward-char (C-f)}{138}{\code {forward-char (C-f)}} -\entry{backward-char (C-b)}{138}{\code {backward-char (C-b)}} -\entry{forward-word (M-f)}{138}{\code {forward-word (M-f)}} -\entry{backward-word (M-b)}{138}{\code {backward-word (M-b)}} -\entry{shell-forward-word (M-C-f)}{138}{\code {shell-forward-word (M-C-f)}} -\entry{shell-backward-word (M-C-b)}{138}{\code {shell-backward-word (M-C-b)}} -\entry{previous-screen-line ()}{138}{\code {previous-screen-line ()}} -\entry{next-screen-line ()}{139}{\code {next-screen-line ()}} -\entry{clear-display (M-C-l)}{139}{\code {clear-display (M-C-l)}} -\entry{clear-screen (C-l)}{139}{\code {clear-screen (C-l)}} -\entry{redraw-current-line ()}{139}{\code {redraw-current-line ()}} -\entry{accept-line (Newline or Return)}{139}{\code {accept-line (Newline or Return)}} -\entry{previous-history (C-p)}{139}{\code {previous-history (C-p)}} -\entry{next-history (C-n)}{139}{\code {next-history (C-n)}} -\entry{beginning-of-history (M-<)}{139}{\code {beginning-of-history (M-<)}} -\entry{end-of-history (M->)}{139}{\code {end-of-history (M->)}} -\entry{reverse-search-history (C-r)}{139}{\code {reverse-search-history (C-r)}} -\entry{forward-search-history (C-s)}{139}{\code {forward-search-history (C-s)}} -\entry{non-incremental-reverse-search-history (M-p)}{139}{\code {non-incremental-reverse-search-history (M-p)}} -\entry{non-incremental-forward-search-history (M-n)}{140}{\code {non-incremental-forward-search-history (M-n)}} -\entry{history-search-forward ()}{140}{\code {history-search-forward ()}} -\entry{history-search-backward ()}{140}{\code {history-search-backward ()}} -\entry{history-substring-search-forward ()}{140}{\code {history-substring-search-forward ()}} -\entry{history-substring-search-backward ()}{140}{\code {history-substring-search-backward ()}} -\entry{yank-nth-arg (M-C-y)}{140}{\code {yank-nth-arg (M-C-y)}} -\entry{yank-last-arg (M-. or M-_)}{140}{\code {yank-last-arg (M-. or M-_)}} -\entry{operate-and-get-next (C-o)}{140}{\code {operate-and-get-next (C-o)}} -\entry{fetch-history ()}{141}{\code {fetch-history ()}} -\entry{end-of-file (usually C-d)}{141}{\code {\i {end-of-file} (usually C-d)}} -\entry{delete-char (C-d)}{141}{\code {delete-char (C-d)}} -\entry{backward-delete-char (Rubout)}{141}{\code {backward-delete-char (Rubout)}} -\entry{forward-backward-delete-char ()}{141}{\code {forward-backward-delete-char ()}} -\entry{quoted-insert (C-q or C-v)}{141}{\code {quoted-insert (C-q or C-v)}} -\entry{self-insert (a, b, A, 1, !, ...{})}{141}{\code {self-insert (a, b, A, 1, !, \dots {})}} -\entry{bracketed-paste-begin ()}{141}{\code {bracketed-paste-begin ()}} -\entry{transpose-chars (C-t)}{141}{\code {transpose-chars (C-t)}} -\entry{transpose-words (M-t)}{142}{\code {transpose-words (M-t)}} -\entry{shell-transpose-words (M-C-t)}{142}{\code {shell-transpose-words (M-C-t)}} -\entry{upcase-word (M-u)}{142}{\code {upcase-word (M-u)}} -\entry{downcase-word (M-l)}{142}{\code {downcase-word (M-l)}} -\entry{capitalize-word (M-c)}{142}{\code {capitalize-word (M-c)}} -\entry{overwrite-mode ()}{142}{\code {overwrite-mode ()}} -\entry{kill-line (C-k)}{142}{\code {kill-line (C-k)}} -\entry{backward-kill-line (C-x Rubout)}{142}{\code {backward-kill-line (C-x Rubout)}} -\entry{unix-line-discard (C-u)}{142}{\code {unix-line-discard (C-u)}} -\entry{kill-whole-line ()}{142}{\code {kill-whole-line ()}} -\entry{kill-word (M-d)}{143}{\code {kill-word (M-d)}} -\entry{backward-kill-word (M-DEL)}{143}{\code {backward-kill-word (M-\key {DEL})}} -\entry{shell-kill-word (M-C-d)}{143}{\code {shell-kill-word (M-C-d)}} -\entry{shell-backward-kill-word ()}{143}{\code {shell-backward-kill-word ()}} -\entry{unix-word-rubout (C-w)}{143}{\code {unix-word-rubout (C-w)}} -\entry{unix-filename-rubout ()}{143}{\code {unix-filename-rubout ()}} -\entry{delete-horizontal-space ()}{143}{\code {delete-horizontal-space ()}} -\entry{kill-region ()}{143}{\code {kill-region ()}} -\entry{copy-region-as-kill ()}{143}{\code {copy-region-as-kill ()}} -\entry{copy-backward-word ()}{143}{\code {copy-backward-word ()}} -\entry{copy-forward-word ()}{143}{\code {copy-forward-word ()}} -\entry{yank (C-y)}{143}{\code {yank (C-y)}} -\entry{yank-pop (M-y)}{143}{\code {yank-pop (M-y)}} -\entry{digit-argument (M-0, M-1, ...{} M--)}{143}{\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}} -\entry{universal-argument ()}{144}{\code {universal-argument ()}} -\entry{complete (TAB)}{144}{\code {complete (\key {TAB})}} -\entry{possible-completions (M-?)}{144}{\code {possible-completions (M-?)}} -\entry{insert-completions (M-*)}{144}{\code {insert-completions (M-*)}} -\entry{menu-complete ()}{144}{\code {menu-complete ()}} -\entry{menu-complete-backward ()}{144}{\code {menu-complete-backward ()}} -\entry{delete-char-or-list ()}{144}{\code {delete-char-or-list ()}} -\entry{complete-filename (M-/)}{144}{\code {complete-filename (M-/)}} -\entry{possible-filename-completions (C-x /)}{145}{\code {possible-filename-completions (C-x /)}} -\entry{complete-username (M-~)}{145}{\code {complete-username (M-~)}} -\entry{possible-username-completions (C-x ~)}{145}{\code {possible-username-completions (C-x ~)}} -\entry{complete-variable (M-$)}{145}{\code {complete-variable (M-$)}} -\entry{possible-variable-completions (C-x $)}{145}{\code {possible-variable-completions (C-x $)}} -\entry{complete-hostname (M-@)}{145}{\code {complete-hostname (M-@)}} -\entry{possible-hostname-completions (C-x @)}{145}{\code {possible-hostname-completions (C-x @)}} -\entry{complete-command (M-!)}{145}{\code {complete-command (M-!)}} -\entry{possible-command-completions (C-x !)}{145}{\code {possible-command-completions (C-x !)}} -\entry{dynamic-complete-history (M-TAB)}{145}{\code {dynamic-complete-history (M-\key {TAB})}} -\entry{dabbrev-expand ()}{145}{\code {dabbrev-expand ()}} -\entry{complete-into-braces (M-{\indexlbrace })}{145}{\code {complete-into-braces (M-{\tt \char 123})}} -\entry{start-kbd-macro (C-x ()}{145}{\code {start-kbd-macro (C-x ()}} -\entry{end-kbd-macro (C-x ))}{145}{\code {end-kbd-macro (C-x ))}} -\entry{call-last-kbd-macro (C-x e)}{146}{\code {call-last-kbd-macro (C-x e)}} -\entry{print-last-kbd-macro ()}{146}{\code {print-last-kbd-macro ()}} -\entry{re-read-init-file (C-x C-r)}{146}{\code {re-read-init-file (C-x C-r)}} -\entry{abort (C-g)}{146}{\code {abort (C-g)}} -\entry{do-lowercase-version (M-A, M-B, M-x, ...{})}{146}{\code {do-lowercase-version (M-A, M-B, M-\var {x}, \dots {})}} -\entry{prefix-meta (ESC)}{146}{\code {prefix-meta (\key {ESC})}} -\entry{undo (C-_ or C-x C-u)}{146}{\code {undo (C-_ or C-x C-u)}} -\entry{revert-line (M-r)}{146}{\code {revert-line (M-r)}} -\entry{tilde-expand (M-&)}{146}{\code {tilde-expand (M-&)}} -\entry{set-mark (C-@)}{146}{\code {set-mark (C-@)}} -\entry{exchange-point-and-mark (C-x C-x)}{146}{\code {exchange-point-and-mark (C-x C-x)}} -\entry{character-search (C-])}{146}{\code {character-search (C-])}} -\entry{character-search-backward (M-C-])}{146}{\code {character-search-backward (M-C-])}} -\entry{skip-csi-sequence ()}{146}{\code {skip-csi-sequence ()}} -\entry{insert-comment (M-#)}{147}{\code {insert-comment (M-#)}} -\entry{dump-functions ()}{147}{\code {dump-functions ()}} -\entry{dump-variables ()}{147}{\code {dump-variables ()}} -\entry{dump-macros ()}{147}{\code {dump-macros ()}} -\entry{spell-correct-word (C-x s)}{147}{\code {spell-correct-word (C-x s)}} -\entry{glob-complete-word (M-g)}{147}{\code {glob-complete-word (M-g)}} -\entry{glob-expand-word (C-x *)}{147}{\code {glob-expand-word (C-x *)}} -\entry{glob-list-expansions (C-x g)}{147}{\code {glob-list-expansions (C-x g)}} -\entry{display-shell-version (C-x C-v)}{148}{\code {display-shell-version (C-x C-v)}} -\entry{shell-expand-line (M-C-e)}{148}{\code {shell-expand-line (M-C-e)}} -\entry{history-expand-line (M-^)}{148}{\code {history-expand-line (M-^)}} -\entry{magic-space ()}{148}{\code {magic-space ()}} -\entry{alias-expand-line ()}{148}{\code {alias-expand-line ()}} -\entry{history-and-alias-expand-line ()}{148}{\code {history-and-alias-expand-line ()}} -\entry{insert-last-argument (M-. or M-_)}{148}{\code {insert-last-argument (M-. or M-_)}} -\entry{edit-and-execute-command (C-x C-e)}{148}{\code {edit-and-execute-command (C-x C-e)}} +\entry{beginning-of-line (C-a)}{139}{\code {beginning-of-line (C-a)}} +\entry{end-of-line (C-e)}{139}{\code {end-of-line (C-e)}} +\entry{forward-char (C-f)}{139}{\code {forward-char (C-f)}} +\entry{backward-char (C-b)}{139}{\code {backward-char (C-b)}} +\entry{forward-word (M-f)}{139}{\code {forward-word (M-f)}} +\entry{backward-word (M-b)}{139}{\code {backward-word (M-b)}} +\entry{shell-forward-word (M-C-f)}{139}{\code {shell-forward-word (M-C-f)}} +\entry{shell-backward-word (M-C-b)}{139}{\code {shell-backward-word (M-C-b)}} +\entry{previous-screen-line ()}{139}{\code {previous-screen-line ()}} +\entry{next-screen-line ()}{140}{\code {next-screen-line ()}} +\entry{clear-display (M-C-l)}{140}{\code {clear-display (M-C-l)}} +\entry{clear-screen (C-l)}{140}{\code {clear-screen (C-l)}} +\entry{redraw-current-line ()}{140}{\code {redraw-current-line ()}} +\entry{accept-line (Newline or Return)}{140}{\code {accept-line (Newline or Return)}} +\entry{previous-history (C-p)}{140}{\code {previous-history (C-p)}} +\entry{next-history (C-n)}{140}{\code {next-history (C-n)}} +\entry{beginning-of-history (M-<)}{140}{\code {beginning-of-history (M-<)}} +\entry{end-of-history (M->)}{140}{\code {end-of-history (M->)}} +\entry{reverse-search-history (C-r)}{140}{\code {reverse-search-history (C-r)}} +\entry{forward-search-history (C-s)}{140}{\code {forward-search-history (C-s)}} +\entry{non-incremental-reverse-search-history (M-p)}{140}{\code {non-incremental-reverse-search-history (M-p)}} +\entry{non-incremental-forward-search-history (M-n)}{141}{\code {non-incremental-forward-search-history (M-n)}} +\entry{history-search-forward ()}{141}{\code {history-search-forward ()}} +\entry{history-search-backward ()}{141}{\code {history-search-backward ()}} +\entry{history-substring-search-forward ()}{141}{\code {history-substring-search-forward ()}} +\entry{history-substring-search-backward ()}{141}{\code {history-substring-search-backward ()}} +\entry{yank-nth-arg (M-C-y)}{141}{\code {yank-nth-arg (M-C-y)}} +\entry{yank-last-arg (M-. or M-_)}{141}{\code {yank-last-arg (M-. or M-_)}} +\entry{operate-and-get-next (C-o)}{141}{\code {operate-and-get-next (C-o)}} +\entry{fetch-history ()}{142}{\code {fetch-history ()}} +\entry{end-of-file (usually C-d)}{142}{\code {\i {end-of-file} (usually C-d)}} +\entry{delete-char (C-d)}{142}{\code {delete-char (C-d)}} +\entry{backward-delete-char (Rubout)}{142}{\code {backward-delete-char (Rubout)}} +\entry{forward-backward-delete-char ()}{142}{\code {forward-backward-delete-char ()}} +\entry{quoted-insert (C-q or C-v)}{142}{\code {quoted-insert (C-q or C-v)}} +\entry{self-insert (a, b, A, 1, !, ...{})}{142}{\code {self-insert (a, b, A, 1, !, \dots {})}} +\entry{bracketed-paste-begin ()}{142}{\code {bracketed-paste-begin ()}} +\entry{transpose-chars (C-t)}{142}{\code {transpose-chars (C-t)}} +\entry{transpose-words (M-t)}{143}{\code {transpose-words (M-t)}} +\entry{shell-transpose-words (M-C-t)}{143}{\code {shell-transpose-words (M-C-t)}} +\entry{upcase-word (M-u)}{143}{\code {upcase-word (M-u)}} +\entry{downcase-word (M-l)}{143}{\code {downcase-word (M-l)}} +\entry{capitalize-word (M-c)}{143}{\code {capitalize-word (M-c)}} +\entry{overwrite-mode ()}{143}{\code {overwrite-mode ()}} +\entry{kill-line (C-k)}{143}{\code {kill-line (C-k)}} +\entry{backward-kill-line (C-x Rubout)}{143}{\code {backward-kill-line (C-x Rubout)}} +\entry{unix-line-discard (C-u)}{143}{\code {unix-line-discard (C-u)}} +\entry{kill-whole-line ()}{143}{\code {kill-whole-line ()}} +\entry{kill-word (M-d)}{144}{\code {kill-word (M-d)}} +\entry{backward-kill-word (M-DEL)}{144}{\code {backward-kill-word (M-\key {DEL})}} +\entry{shell-kill-word (M-C-d)}{144}{\code {shell-kill-word (M-C-d)}} +\entry{shell-backward-kill-word ()}{144}{\code {shell-backward-kill-word ()}} +\entry{unix-word-rubout (C-w)}{144}{\code {unix-word-rubout (C-w)}} +\entry{unix-filename-rubout ()}{144}{\code {unix-filename-rubout ()}} +\entry{delete-horizontal-space ()}{144}{\code {delete-horizontal-space ()}} +\entry{kill-region ()}{144}{\code {kill-region ()}} +\entry{copy-region-as-kill ()}{144}{\code {copy-region-as-kill ()}} +\entry{copy-backward-word ()}{144}{\code {copy-backward-word ()}} +\entry{copy-forward-word ()}{144}{\code {copy-forward-word ()}} +\entry{yank (C-y)}{144}{\code {yank (C-y)}} +\entry{yank-pop (M-y)}{144}{\code {yank-pop (M-y)}} +\entry{digit-argument (M-0, M-1, ...{} M--)}{144}{\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}} +\entry{universal-argument ()}{145}{\code {universal-argument ()}} +\entry{complete (TAB)}{145}{\code {complete (\key {TAB})}} +\entry{possible-completions (M-?)}{145}{\code {possible-completions (M-?)}} +\entry{insert-completions (M-*)}{145}{\code {insert-completions (M-*)}} +\entry{menu-complete ()}{145}{\code {menu-complete ()}} +\entry{menu-complete-backward ()}{145}{\code {menu-complete-backward ()}} +\entry{delete-char-or-list ()}{145}{\code {delete-char-or-list ()}} +\entry{complete-filename (M-/)}{145}{\code {complete-filename (M-/)}} +\entry{possible-filename-completions (C-x /)}{146}{\code {possible-filename-completions (C-x /)}} +\entry{complete-username (M-~)}{146}{\code {complete-username (M-~)}} +\entry{possible-username-completions (C-x ~)}{146}{\code {possible-username-completions (C-x ~)}} +\entry{complete-variable (M-$)}{146}{\code {complete-variable (M-$)}} +\entry{possible-variable-completions (C-x $)}{146}{\code {possible-variable-completions (C-x $)}} +\entry{complete-hostname (M-@)}{146}{\code {complete-hostname (M-@)}} +\entry{possible-hostname-completions (C-x @)}{146}{\code {possible-hostname-completions (C-x @)}} +\entry{complete-command (M-!)}{146}{\code {complete-command (M-!)}} +\entry{possible-command-completions (C-x !)}{146}{\code {possible-command-completions (C-x !)}} +\entry{dynamic-complete-history (M-TAB)}{146}{\code {dynamic-complete-history (M-\key {TAB})}} +\entry{dabbrev-expand ()}{146}{\code {dabbrev-expand ()}} +\entry{complete-into-braces (M-{\indexlbrace })}{146}{\code {complete-into-braces (M-{\tt \char 123})}} +\entry{start-kbd-macro (C-x ()}{146}{\code {start-kbd-macro (C-x ()}} +\entry{end-kbd-macro (C-x ))}{146}{\code {end-kbd-macro (C-x ))}} +\entry{call-last-kbd-macro (C-x e)}{147}{\code {call-last-kbd-macro (C-x e)}} +\entry{print-last-kbd-macro ()}{147}{\code {print-last-kbd-macro ()}} +\entry{re-read-init-file (C-x C-r)}{147}{\code {re-read-init-file (C-x C-r)}} +\entry{abort (C-g)}{147}{\code {abort (C-g)}} +\entry{do-lowercase-version (M-A, M-B, M-x, ...{})}{147}{\code {do-lowercase-version (M-A, M-B, M-\var {x}, \dots {})}} +\entry{prefix-meta (ESC)}{147}{\code {prefix-meta (\key {ESC})}} +\entry{undo (C-_ or C-x C-u)}{147}{\code {undo (C-_ or C-x C-u)}} +\entry{revert-line (M-r)}{147}{\code {revert-line (M-r)}} +\entry{tilde-expand (M-&)}{147}{\code {tilde-expand (M-&)}} +\entry{set-mark (C-@)}{147}{\code {set-mark (C-@)}} +\entry{exchange-point-and-mark (C-x C-x)}{147}{\code {exchange-point-and-mark (C-x C-x)}} +\entry{character-search (C-])}{147}{\code {character-search (C-])}} +\entry{character-search-backward (M-C-])}{147}{\code {character-search-backward (M-C-])}} +\entry{skip-csi-sequence ()}{147}{\code {skip-csi-sequence ()}} +\entry{insert-comment (M-#)}{148}{\code {insert-comment (M-#)}} +\entry{dump-functions ()}{148}{\code {dump-functions ()}} +\entry{dump-variables ()}{148}{\code {dump-variables ()}} +\entry{dump-macros ()}{148}{\code {dump-macros ()}} +\entry{spell-correct-word (C-x s)}{148}{\code {spell-correct-word (C-x s)}} +\entry{glob-complete-word (M-g)}{148}{\code {glob-complete-word (M-g)}} +\entry{glob-expand-word (C-x *)}{148}{\code {glob-expand-word (C-x *)}} +\entry{glob-list-expansions (C-x g)}{148}{\code {glob-list-expansions (C-x g)}} +\entry{display-shell-version (C-x C-v)}{149}{\code {display-shell-version (C-x C-v)}} +\entry{shell-expand-line (M-C-e)}{149}{\code {shell-expand-line (M-C-e)}} +\entry{history-expand-line (M-^)}{149}{\code {history-expand-line (M-^)}} +\entry{magic-space ()}{149}{\code {magic-space ()}} +\entry{alias-expand-line ()}{149}{\code {alias-expand-line ()}} +\entry{history-and-alias-expand-line ()}{149}{\code {history-and-alias-expand-line ()}} +\entry{insert-last-argument (M-. or M-_)}{149}{\code {insert-last-argument (M-. or M-_)}} +\entry{edit-and-execute-command (C-x C-e)}{149}{\code {edit-and-execute-command (C-x C-e)}} diff --git a/doc/bashref.fns b/doc/bashref.fns index 748e3c0d..31720235 100644 --- a/doc/bashref.fns +++ b/doc/bashref.fns @@ -1,134 +1,134 @@ \initial {A} -\entry{\code {abort (C-g)}}{146} -\entry{\code {accept-line (Newline or Return)}}{139} -\entry{\code {alias-expand-line ()}}{148} +\entry{\code {abort (C-g)}}{147} +\entry{\code {accept-line (Newline or Return)}}{140} +\entry{\code {alias-expand-line ()}}{149} \initial {B} -\entry{\code {backward-char (C-b)}}{138} -\entry{\code {backward-delete-char (Rubout)}}{141} -\entry{\code {backward-kill-line (C-x Rubout)}}{142} -\entry{\code {backward-kill-word (M-\key {DEL})}}{143} -\entry{\code {backward-word (M-b)}}{138} -\entry{\code {beginning-of-history (M-<)}}{139} -\entry{\code {beginning-of-line (C-a)}}{138} -\entry{\code {bracketed-paste-begin ()}}{141} +\entry{\code {backward-char (C-b)}}{139} +\entry{\code {backward-delete-char (Rubout)}}{142} +\entry{\code {backward-kill-line (C-x Rubout)}}{143} +\entry{\code {backward-kill-word (M-\key {DEL})}}{144} +\entry{\code {backward-word (M-b)}}{139} +\entry{\code {beginning-of-history (M-<)}}{140} +\entry{\code {beginning-of-line (C-a)}}{139} +\entry{\code {bracketed-paste-begin ()}}{142} \initial {C} -\entry{\code {call-last-kbd-macro (C-x e)}}{146} -\entry{\code {capitalize-word (M-c)}}{142} -\entry{\code {character-search (C-])}}{146} -\entry{\code {character-search-backward (M-C-])}}{146} -\entry{\code {clear-display (M-C-l)}}{139} -\entry{\code {clear-screen (C-l)}}{139} -\entry{\code {complete (\key {TAB})}}{144} -\entry{\code {complete-command (M-!)}}{145} -\entry{\code {complete-filename (M-/)}}{144} -\entry{\code {complete-hostname (M-@)}}{145} -\entry{\code {complete-into-braces (M-{\tt \char 123})}}{145} -\entry{\code {complete-username (M-~)}}{145} -\entry{\code {complete-variable (M-$)}}{145} -\entry{\code {copy-backward-word ()}}{143} -\entry{\code {copy-forward-word ()}}{143} -\entry{\code {copy-region-as-kill ()}}{143} +\entry{\code {call-last-kbd-macro (C-x e)}}{147} +\entry{\code {capitalize-word (M-c)}}{143} +\entry{\code {character-search (C-])}}{147} +\entry{\code {character-search-backward (M-C-])}}{147} +\entry{\code {clear-display (M-C-l)}}{140} +\entry{\code {clear-screen (C-l)}}{140} +\entry{\code {complete (\key {TAB})}}{145} +\entry{\code {complete-command (M-!)}}{146} +\entry{\code {complete-filename (M-/)}}{145} +\entry{\code {complete-hostname (M-@)}}{146} +\entry{\code {complete-into-braces (M-{\tt \char 123})}}{146} +\entry{\code {complete-username (M-~)}}{146} +\entry{\code {complete-variable (M-$)}}{146} +\entry{\code {copy-backward-word ()}}{144} +\entry{\code {copy-forward-word ()}}{144} +\entry{\code {copy-region-as-kill ()}}{144} \initial {D} -\entry{\code {dabbrev-expand ()}}{145} -\entry{\code {delete-char (C-d)}}{141} -\entry{\code {delete-char-or-list ()}}{144} -\entry{\code {delete-horizontal-space ()}}{143} -\entry{\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}}{143} -\entry{\code {display-shell-version (C-x C-v)}}{148} -\entry{\code {do-lowercase-version (M-A, M-B, M-\var {x}, \dots {})}}{146} -\entry{\code {downcase-word (M-l)}}{142} -\entry{\code {dump-functions ()}}{147} -\entry{\code {dump-macros ()}}{147} -\entry{\code {dump-variables ()}}{147} -\entry{\code {dynamic-complete-history (M-\key {TAB})}}{145} +\entry{\code {dabbrev-expand ()}}{146} +\entry{\code {delete-char (C-d)}}{142} +\entry{\code {delete-char-or-list ()}}{145} +\entry{\code {delete-horizontal-space ()}}{144} +\entry{\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}}{144} +\entry{\code {display-shell-version (C-x C-v)}}{149} +\entry{\code {do-lowercase-version (M-A, M-B, M-\var {x}, \dots {})}}{147} +\entry{\code {downcase-word (M-l)}}{143} +\entry{\code {dump-functions ()}}{148} +\entry{\code {dump-macros ()}}{148} +\entry{\code {dump-variables ()}}{148} +\entry{\code {dynamic-complete-history (M-\key {TAB})}}{146} \initial {E} -\entry{\code {edit-and-execute-command (C-x C-e)}}{148} -\entry{\code {end-kbd-macro (C-x ))}}{145} -\entry{\code {\i {end-of-file} (usually C-d)}}{141} -\entry{\code {end-of-history (M->)}}{139} -\entry{\code {end-of-line (C-e)}}{138} -\entry{\code {exchange-point-and-mark (C-x C-x)}}{146} +\entry{\code {edit-and-execute-command (C-x C-e)}}{149} +\entry{\code {end-kbd-macro (C-x ))}}{146} +\entry{\code {\i {end-of-file} (usually C-d)}}{142} +\entry{\code {end-of-history (M->)}}{140} +\entry{\code {end-of-line (C-e)}}{139} +\entry{\code {exchange-point-and-mark (C-x C-x)}}{147} \initial {F} -\entry{\code {fetch-history ()}}{141} -\entry{\code {forward-backward-delete-char ()}}{141} -\entry{\code {forward-char (C-f)}}{138} -\entry{\code {forward-search-history (C-s)}}{139} -\entry{\code {forward-word (M-f)}}{138} +\entry{\code {fetch-history ()}}{142} +\entry{\code {forward-backward-delete-char ()}}{142} +\entry{\code {forward-char (C-f)}}{139} +\entry{\code {forward-search-history (C-s)}}{140} +\entry{\code {forward-word (M-f)}}{139} \initial {G} -\entry{\code {glob-complete-word (M-g)}}{147} -\entry{\code {glob-expand-word (C-x *)}}{147} -\entry{\code {glob-list-expansions (C-x g)}}{147} +\entry{\code {glob-complete-word (M-g)}}{148} +\entry{\code {glob-expand-word (C-x *)}}{148} +\entry{\code {glob-list-expansions (C-x g)}}{148} \initial {H} -\entry{\code {history-and-alias-expand-line ()}}{148} -\entry{\code {history-expand-line (M-^)}}{148} -\entry{\code {history-search-backward ()}}{140} -\entry{\code {history-search-forward ()}}{140} -\entry{\code {history-substring-search-backward ()}}{140} -\entry{\code {history-substring-search-forward ()}}{140} +\entry{\code {history-and-alias-expand-line ()}}{149} +\entry{\code {history-expand-line (M-^)}}{149} +\entry{\code {history-search-backward ()}}{141} +\entry{\code {history-search-forward ()}}{141} +\entry{\code {history-substring-search-backward ()}}{141} +\entry{\code {history-substring-search-forward ()}}{141} \initial {I} -\entry{\code {insert-comment (M-#)}}{147} -\entry{\code {insert-completions (M-*)}}{144} -\entry{\code {insert-last-argument (M-. or M-_)}}{148} +\entry{\code {insert-comment (M-#)}}{148} +\entry{\code {insert-completions (M-*)}}{145} +\entry{\code {insert-last-argument (M-. or M-_)}}{149} \initial {K} -\entry{\code {kill-line (C-k)}}{142} -\entry{\code {kill-region ()}}{143} -\entry{\code {kill-whole-line ()}}{142} -\entry{\code {kill-word (M-d)}}{143} +\entry{\code {kill-line (C-k)}}{143} +\entry{\code {kill-region ()}}{144} +\entry{\code {kill-whole-line ()}}{143} +\entry{\code {kill-word (M-d)}}{144} \initial {M} -\entry{\code {magic-space ()}}{148} -\entry{\code {menu-complete ()}}{144} -\entry{\code {menu-complete-backward ()}}{144} +\entry{\code {magic-space ()}}{149} +\entry{\code {menu-complete ()}}{145} +\entry{\code {menu-complete-backward ()}}{145} \initial {N} -\entry{\code {next-history (C-n)}}{139} -\entry{\code {next-screen-line ()}}{139} -\entry{\code {non-incremental-forward-search-history (M-n)}}{140} -\entry{\code {non-incremental-reverse-search-history (M-p)}}{139} +\entry{\code {next-history (C-n)}}{140} +\entry{\code {next-screen-line ()}}{140} +\entry{\code {non-incremental-forward-search-history (M-n)}}{141} +\entry{\code {non-incremental-reverse-search-history (M-p)}}{140} \initial {O} -\entry{\code {operate-and-get-next (C-o)}}{140} -\entry{\code {overwrite-mode ()}}{142} +\entry{\code {operate-and-get-next (C-o)}}{141} +\entry{\code {overwrite-mode ()}}{143} \initial {P} -\entry{\code {possible-command-completions (C-x !)}}{145} -\entry{\code {possible-completions (M-?)}}{144} -\entry{\code {possible-filename-completions (C-x /)}}{145} -\entry{\code {possible-hostname-completions (C-x @)}}{145} -\entry{\code {possible-username-completions (C-x ~)}}{145} -\entry{\code {possible-variable-completions (C-x $)}}{145} -\entry{\code {prefix-meta (\key {ESC})}}{146} -\entry{\code {previous-history (C-p)}}{139} -\entry{\code {previous-screen-line ()}}{138} -\entry{\code {print-last-kbd-macro ()}}{146} +\entry{\code {possible-command-completions (C-x !)}}{146} +\entry{\code {possible-completions (M-?)}}{145} +\entry{\code {possible-filename-completions (C-x /)}}{146} +\entry{\code {possible-hostname-completions (C-x @)}}{146} +\entry{\code {possible-username-completions (C-x ~)}}{146} +\entry{\code {possible-variable-completions (C-x $)}}{146} +\entry{\code {prefix-meta (\key {ESC})}}{147} +\entry{\code {previous-history (C-p)}}{140} +\entry{\code {previous-screen-line ()}}{139} +\entry{\code {print-last-kbd-macro ()}}{147} \initial {Q} -\entry{\code {quoted-insert (C-q or C-v)}}{141} +\entry{\code {quoted-insert (C-q or C-v)}}{142} \initial {R} -\entry{\code {re-read-init-file (C-x C-r)}}{146} -\entry{\code {redraw-current-line ()}}{139} -\entry{\code {reverse-search-history (C-r)}}{139} -\entry{\code {revert-line (M-r)}}{146} +\entry{\code {re-read-init-file (C-x C-r)}}{147} +\entry{\code {redraw-current-line ()}}{140} +\entry{\code {reverse-search-history (C-r)}}{140} +\entry{\code {revert-line (M-r)}}{147} \initial {S} -\entry{\code {self-insert (a, b, A, 1, !, \dots {})}}{141} -\entry{\code {set-mark (C-@)}}{146} -\entry{\code {shell-backward-kill-word ()}}{143} -\entry{\code {shell-backward-word (M-C-b)}}{138} -\entry{\code {shell-expand-line (M-C-e)}}{148} -\entry{\code {shell-forward-word (M-C-f)}}{138} -\entry{\code {shell-kill-word (M-C-d)}}{143} -\entry{\code {shell-transpose-words (M-C-t)}}{142} -\entry{\code {skip-csi-sequence ()}}{146} -\entry{\code {spell-correct-word (C-x s)}}{147} -\entry{\code {start-kbd-macro (C-x ()}}{145} +\entry{\code {self-insert (a, b, A, 1, !, \dots {})}}{142} +\entry{\code {set-mark (C-@)}}{147} +\entry{\code {shell-backward-kill-word ()}}{144} +\entry{\code {shell-backward-word (M-C-b)}}{139} +\entry{\code {shell-expand-line (M-C-e)}}{149} +\entry{\code {shell-forward-word (M-C-f)}}{139} +\entry{\code {shell-kill-word (M-C-d)}}{144} +\entry{\code {shell-transpose-words (M-C-t)}}{143} +\entry{\code {skip-csi-sequence ()}}{147} +\entry{\code {spell-correct-word (C-x s)}}{148} +\entry{\code {start-kbd-macro (C-x ()}}{146} \initial {T} -\entry{\code {tilde-expand (M-&)}}{146} -\entry{\code {transpose-chars (C-t)}}{141} -\entry{\code {transpose-words (M-t)}}{142} +\entry{\code {tilde-expand (M-&)}}{147} +\entry{\code {transpose-chars (C-t)}}{142} +\entry{\code {transpose-words (M-t)}}{143} \initial {U} -\entry{\code {undo (C-_ or C-x C-u)}}{146} -\entry{\code {universal-argument ()}}{144} -\entry{\code {unix-filename-rubout ()}}{143} -\entry{\code {unix-line-discard (C-u)}}{142} -\entry{\code {unix-word-rubout (C-w)}}{143} -\entry{\code {upcase-word (M-u)}}{142} +\entry{\code {undo (C-_ or C-x C-u)}}{147} +\entry{\code {universal-argument ()}}{145} +\entry{\code {unix-filename-rubout ()}}{144} +\entry{\code {unix-line-discard (C-u)}}{143} +\entry{\code {unix-word-rubout (C-w)}}{144} +\entry{\code {upcase-word (M-u)}}{143} \initial {Y} -\entry{\code {yank (C-y)}}{143} -\entry{\code {yank-last-arg (M-. or M-_)}}{140} -\entry{\code {yank-nth-arg (M-C-y)}}{140} -\entry{\code {yank-pop (M-y)}}{143} +\entry{\code {yank (C-y)}}{144} +\entry{\code {yank-last-arg (M-. or M-_)}}{141} +\entry{\code {yank-nth-arg (M-C-y)}}{141} +\entry{\code {yank-pop (M-y)}}{144} diff --git a/doc/bashref.html b/doc/bashref.html index 4b417cd1..40cc27fe 100644 --- a/doc/bashref.html +++ b/doc/bashref.html @@ -4,9 +4,9 @@