mirror of
https://https.git.savannah.gnu.org/git/bash.git
synced 2026-07-10 05:30:49 +02:00
next set of documentation updates (job control); fix read timeout problem; fix bash-source-fullpath default; brace expansion integer overflow fix; fix for help output for loadable builtins
This commit is contained in:
+268
-241
@@ -1,9 +1,9 @@
|
||||
This is bash.info, produced by makeinfo version 7.1 from bashref.texi.
|
||||
|
||||
This text is a brief description of the features that are present in the
|
||||
Bash shell (version 5.3, 10 October 2024).
|
||||
Bash shell (version 5.3, 14 October 2024).
|
||||
|
||||
This is Edition 5.3, last updated 10 October 2024, of ‘The GNU Bash
|
||||
This is Edition 5.3, last updated 14 October 2024, of ‘The GNU Bash
|
||||
Reference Manual’, for ‘Bash’, Version 5.3.
|
||||
|
||||
Copyright © 1988-2024 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, 10 October 2024). The Bash home page is
|
||||
Bash shell (version 5.3, 14 October 2024). The Bash home page is
|
||||
<http://www.gnu.org/software/bash/>.
|
||||
|
||||
This is Edition 5.3, last updated 10 October 2024, of ‘The GNU Bash
|
||||
This is Edition 5.3, last updated 14 October 2024, of ‘The GNU Bash
|
||||
Reference Manual’, for ‘Bash’, Version 5.3.
|
||||
|
||||
Bash contains features that appear in other popular shells, and some
|
||||
@@ -1774,7 +1774,7 @@ replaced with the corresponding element from the directory stack, as it
|
||||
would be displayed by the ‘dirs’ builtin invoked with the characters
|
||||
following tilde in the tilde-prefix as an argument (*note The Directory
|
||||
Stack::). If the tilde-prefix, sans the tilde, consists of a number
|
||||
without a leading ‘+’ or ‘-’, ‘+’ is assumed.
|
||||
without a leading ‘+’ or ‘-’, tilde expansion assumes ‘+’.
|
||||
|
||||
The results of tilde expansion are treated as if they were quoted, so
|
||||
the replacement is not subject to word splitting and filename expansion.
|
||||
@@ -1904,12 +1904,12 @@ omitted, the operator tests only for existence.
|
||||
DEFAULT
|
||||
|
||||
‘${PARAMETER:?WORD}’
|
||||
If PARAMETER is null or unset, the expansion of WORD (or a message
|
||||
to that effect if WORD is not present) is written to the standard
|
||||
error and the shell, if it is not interactive, exits with a
|
||||
non-zero status. An interactive shell does not exit, but does not
|
||||
execute the command associated with the expansion. Otherwise, the
|
||||
value of PARAMETER is substituted.
|
||||
If PARAMETER is null or unset, the shell writes the expansion of
|
||||
WORD (or a message to that effect if WORD is not present) to the
|
||||
standard error and, if it is not interactive, exits with a non-zero
|
||||
status. An interactive shell does not exit, but does not execute
|
||||
the command associated with the expansion. Otherwise, the value of
|
||||
PARAMETER is substituted.
|
||||
|
||||
$ var=
|
||||
$ : ${var:?var is unset or null}
|
||||
@@ -7071,15 +7071,17 @@ all lines that make up a compound command, before executing any of the
|
||||
commands on that line or the compound command. Aliases are expanded
|
||||
when a command is read, not when it is executed. Therefore, an alias
|
||||
definition appearing on the same line as another command does not take
|
||||
effect until the shell reads the next line of input. The commands
|
||||
following the alias definition on that line are not affected by the new
|
||||
alias. This behavior is also an issue when functions are executed.
|
||||
Aliases are expanded when a function definition is read, not when the
|
||||
function is executed, because a function definition is itself a command.
|
||||
As a consequence, aliases defined in a function are not available until
|
||||
after that function is executed. To be safe, always put alias
|
||||
definitions on a separate line, and do not use ‘alias’ in compound
|
||||
commands.
|
||||
effect until the shell reads the next line of input, and an alias
|
||||
definition in a compound command does not take effect until the shell
|
||||
parses and executes the entire compound command. The commands following
|
||||
the alias definition on that line, or in the rest of a compound command,
|
||||
are not affected by the new alias. This behavior is also an issue when
|
||||
functions are executed. Aliases are expanded when a function definition
|
||||
is read, not when the function is executed, because a function
|
||||
definition is itself a command. As a consequence, aliases defined in a
|
||||
function are not available until after that function is executed. To be
|
||||
safe, always put alias definitions on a separate line, and do not use
|
||||
‘alias’ in compound commands.
|
||||
|
||||
For almost every purpose, shell functions are preferred over aliases.
|
||||
|
||||
@@ -8065,8 +8067,10 @@ interface supplied jointly by the operating system kernel's terminal
|
||||
driver and Bash.
|
||||
|
||||
The shell associates a JOB with each pipeline. It keeps a table of
|
||||
currently executing jobs, which may be listed with the ‘jobs’ command.
|
||||
When Bash starts a job asynchronously, it prints a line that looks like:
|
||||
currently executing jobs, which the ‘jobs’ command will display. Each
|
||||
job has a “job number”, which ‘jobs’ displays between brackets. Job
|
||||
numbers start at 1. When Bash starts a job asynchronously, it prints a
|
||||
line that looks like:
|
||||
[1] 25647
|
||||
indicating that this job is job number 1 and that the process ID of the
|
||||
last process in the pipeline associated with this job is 25647. All of
|
||||
@@ -8074,72 +8078,85 @@ the processes in a single pipeline are members of the same job. Bash
|
||||
uses the JOB abstraction as the basis for job control.
|
||||
|
||||
To facilitate the implementation of the user interface to job
|
||||
control, the operating system maintains the notion of a current terminal
|
||||
process group ID. Members of this process group (processes whose
|
||||
process group ID is equal to the current terminal process group ID)
|
||||
receive keyboard-generated signals such as ‘SIGINT’. These processes
|
||||
are said to be in the foreground. Background processes are those whose
|
||||
process group ID differs from the terminal's; such processes are immune
|
||||
to keyboard-generated signals. Only foreground processes are allowed to
|
||||
read from or, if the user so specifies with ‘stty tostop’, write to the
|
||||
terminal. Background processes which attempt to read from (write to
|
||||
when ‘tostop’ is in effect) the terminal are sent a ‘SIGTTIN’
|
||||
(‘SIGTTOU’) signal by the kernel's terminal driver, which, unless
|
||||
caught, suspends the process.
|
||||
control, each process has a “process group ID”, and the operating system
|
||||
maintains the notion of a current terminal process group ID. Processes
|
||||
that have the same process group ID are said to be part of the same
|
||||
“process group”. Members of the foreground process group (processes
|
||||
whose process group ID is equal to the current terminal process group
|
||||
ID) receive keyboard-generated signals such as ‘SIGINT’. Processes in
|
||||
the foreground process group are said to be foreground processes.
|
||||
Background processes are those whose process group ID differs from the
|
||||
terminal's; such processes are immune to keyboard-generated signals.
|
||||
Only foreground processes are allowed to read from or, if the user so
|
||||
specifies with ‘stty tostop’, write to the terminal. Background
|
||||
processes which attempt to read from (write to when ‘tostop’ is in
|
||||
effect) the terminal are sent a ‘SIGTTIN’ (‘SIGTTOU’) signal by the
|
||||
kernel's terminal driver, which, unless caught, suspends the process.
|
||||
|
||||
If the operating system on which Bash is running supports job
|
||||
control, Bash contains facilities to use it. Typing the “suspend”
|
||||
character (typically ‘^Z’, Control-Z) while a process is running causes
|
||||
that process to be stopped and returns control to Bash. Typing the
|
||||
“delayed suspend” character (typically ‘^Y’, Control-Y) causes the
|
||||
process to be stopped when it attempts to read input from the terminal,
|
||||
and control to be returned to Bash. The user then manipulates the state
|
||||
of this job, using the ‘bg’ command to continue it in the background,
|
||||
the ‘fg’ command to continue it in the foreground, or the ‘kill’ command
|
||||
to kill it. A ‘^Z’ takes effect immediately, and has the additional
|
||||
side effect of causing pending output and typeahead to be discarded.
|
||||
character (typically ‘^Z’, Control-Z) while a process is running stops
|
||||
that process and returns control to Bash. Typing the “delayed suspend”
|
||||
character (typically ‘^Y’, Control-Y) causes the process to stop when it
|
||||
attempts to read input from the terminal, and returns control to Bash.
|
||||
The user then manipulates the state of this job, using the ‘bg’ command
|
||||
to continue it in the background, the ‘fg’ command to continue it in the
|
||||
foreground, or the ‘kill’ command to kill it. The suspend character
|
||||
takes effect immediately, and has the additional side effect of
|
||||
discarding any pending output and typeahead. If you want to force a
|
||||
background process to stop, or stop a process that's not associated with
|
||||
your terminal session, send it the ‘SIGSTOP’ signal using ‘kill’.
|
||||
|
||||
There are a number of ways to refer to a job in the shell. The
|
||||
character ‘%’ introduces a job specification (“jobspec”).
|
||||
There are a number of ways to refer to a job in the shell. The ‘%’
|
||||
character introduces a “job specification” (jobspec).
|
||||
|
||||
Job number ‘n’ may be referred to as ‘%n’. The symbols ‘%%’ and ‘%+’
|
||||
refer to the shell's notion of the current job, which is the last job
|
||||
stopped while it was in the foreground or started in the background. A
|
||||
single ‘%’ (with no accompanying job specification) also refers to the
|
||||
current job. The previous job may be referenced using ‘%-’. If there
|
||||
is only a single job, ‘%+’ and ‘%-’ can both be used to refer to that
|
||||
job. In output pertaining to jobs (e.g., the output of the ‘jobs’
|
||||
command), the current job is always flagged with a ‘+’, and the previous
|
||||
job with a ‘-’.
|
||||
Job number ‘n’ may be referred to as ‘%n’. A job may also be
|
||||
referred to using a prefix of the name used to start it, or using a
|
||||
substring that appears in its command line. For example, ‘%ce’ refers
|
||||
to a job whose command name begins with ‘ce’. Using ‘%?ce’, on the
|
||||
other hand, refers to any job containing the string ‘ce’ in its command
|
||||
line. If the prefix or substring matches more than one job, Bash
|
||||
reports an error.
|
||||
|
||||
A job may also be referred to using a prefix of the name used to
|
||||
start it, or using a substring that appears in its command line. For
|
||||
example, ‘%ce’ refers to a stopped job whose command name begins with
|
||||
‘ce’. Using ‘%?ce’, on the other hand, refers to any job containing the
|
||||
string ‘ce’ in its command line. If the prefix or substring matches
|
||||
more than one job, Bash reports an error.
|
||||
The symbols ‘%%’ and ‘%+’ refer to the shell's notion of the “current
|
||||
job”. A single ‘%’ (with no accompanying job specification) also refers
|
||||
to the current job. ‘%-’ refers to the “previous job”. When a job
|
||||
starts in the background, a job stops while in the foreground, or a job
|
||||
is resumed in the background, it becomes the current job. The job that
|
||||
was the current job becomes the previous job. When the current job
|
||||
terminates, the previous job becomes the current job. If there is only
|
||||
a single job, ‘%+’ and ‘%-’ can both be used to refer to that job. In
|
||||
output pertaining to jobs (e.g., the output of the ‘jobs’ command), the
|
||||
current job is always marked with a ‘+’, and the previous job with a
|
||||
‘-’.
|
||||
|
||||
Simply naming a job can be used to bring it into the foreground: ‘%1’
|
||||
is a synonym for ‘fg %1’, bringing job 1 from the background into the
|
||||
foreground. Similarly, ‘%1 &’ resumes job 1 in the background,
|
||||
equivalent to ‘bg %1’
|
||||
equivalent to ‘bg %1’.
|
||||
|
||||
The shell learns immediately whenever a job changes state. Normally,
|
||||
Bash waits until it is about to print a prompt before reporting changes
|
||||
in a job's status so as to not interrupt any other output, though it
|
||||
will notify of changes in a job's status after a foreground command in a
|
||||
list completes, before executing the next command. If the ‘-b’ option
|
||||
to the ‘set’ builtin is enabled, Bash reports such changes immediately
|
||||
(*note The Set Builtin::). Any trap on ‘SIGCHLD’ is executed for each
|
||||
child process that exits.
|
||||
Bash waits until it is about to print a prompt before notifying the user
|
||||
about changes in a job's status so as to not interrupt any other output,
|
||||
though it will notify of changes in a job's status after a foreground
|
||||
command in a list completes, before executing the next command in the
|
||||
list. If the ‘-b’ option to the ‘set’ builtin is enabled, Bash reports
|
||||
such changes immediately (*note The Set Builtin::). Bash executes any
|
||||
trap on ‘SIGCHLD’ for each child process that terminates.
|
||||
|
||||
If an attempt to exit Bash is made while jobs are stopped, (or
|
||||
running, if the ‘checkjobs’ option is enabled - see *note The Shopt
|
||||
Builtin::), the shell prints a warning message, and if the ‘checkjobs’
|
||||
option is enabled, lists the jobs and their statuses. The ‘jobs’
|
||||
command may then be used to inspect their status. If a second attempt
|
||||
to exit is made without an intervening command, Bash does not print
|
||||
another warning, and any stopped jobs are terminated.
|
||||
When a job terminates and Bash notifies the user about it, Bash
|
||||
removes the job from the jobs table. It will not appear in ‘jobs’
|
||||
output, but ‘wait’ will report its exit status, as long as it's supplied
|
||||
the process ID associated with the job as an argument. When the table
|
||||
is empty, job numbers start over at 1.
|
||||
|
||||
If a user attempts to exit Bash while jobs are stopped, (or running,
|
||||
if the ‘checkjobs’ option is enabled - see *note The Shopt Builtin::),
|
||||
the shell prints a warning message, and if the ‘checkjobs’ option is
|
||||
enabled, lists the jobs and their statuses. The ‘jobs’ command may then
|
||||
be used to inspect their status. If the user immediately attempts to
|
||||
exit again, without an intervening command, Bash does not print another
|
||||
warning, and terminates any stopped jobs.
|
||||
|
||||
When the shell is waiting for a job or process using the ‘wait’
|
||||
builtin, and job control is enabled, ‘wait’ will return when the job
|
||||
@@ -8156,21 +8173,22 @@ File: bash.info, Node: Job Control Builtins, Next: Job Control Variables, Pre
|
||||
bg [JOBSPEC ...]
|
||||
|
||||
Resume each suspended job JOBSPEC in the background, as if it had
|
||||
been started with ‘&’. If JOBSPEC is not supplied, the current job
|
||||
is used. The return status is zero unless it is run when job
|
||||
control is not enabled, or, when run with job control enabled, any
|
||||
JOBSPEC was not found or specifies a job that was started without
|
||||
job control.
|
||||
been started with ‘&’. If JOBSPEC is not supplied, the shell uses
|
||||
its notion of the current job. ‘bg’ returns zero unless it is run
|
||||
when job control is not enabled, or, when run with job control
|
||||
enabled, any JOBSPEC was not found or specifies a job that was
|
||||
started without job control.
|
||||
|
||||
‘fg’
|
||||
fg [JOBSPEC]
|
||||
|
||||
Resume the job JOBSPEC in the foreground and make it the current
|
||||
job. If JOBSPEC is not supplied, resume the current job. The
|
||||
return status is that of the command placed into the foreground, or
|
||||
non-zero if run when job control is disabled or, when run with job
|
||||
control enabled, JOBSPEC does not specify a valid job or JOBSPEC
|
||||
specifies a job that was started without job control.
|
||||
job. If JOBSPEC is not supplied, ‘fg’ resumes the current job.
|
||||
The return status is that of the command placed into the
|
||||
foreground, or non-zero if run when job control is disabled or,
|
||||
when run with job control enabled, JOBSPEC does not specify a valid
|
||||
job or JOBSPEC specifies a job that was started without job
|
||||
control.
|
||||
|
||||
‘jobs’
|
||||
jobs [-lnprs] [JOBSPEC]
|
||||
@@ -8197,7 +8215,8 @@ File: bash.info, Node: Job Control Builtins, Next: Job Control Variables, Pre
|
||||
|
||||
If JOBSPEC is supplied, ‘jobs’ restricts output to information
|
||||
about that job. If JOBSPEC is not supplied, ‘jobs’ lists the
|
||||
status of all jobs.
|
||||
status of all jobs. The return status is zero unless an invalid
|
||||
option is encountered or an invalid JOBSPEC is supplied.
|
||||
|
||||
If the ‘-x’ option is supplied, ‘jobs’ replaces any JOBSPEC found
|
||||
in COMMAND or ARGUMENTS with the corresponding process group ID,
|
||||
@@ -8205,21 +8224,25 @@ File: bash.info, Node: Job Control Builtins, Next: Job Control Variables, Pre
|
||||
status.
|
||||
|
||||
‘kill’
|
||||
kill [-s SIGSPEC] [-n SIGNUM] [-SIGSPEC] JOBSPEC or PID
|
||||
kill [-s SIGSPEC] [-n SIGNUM] [-SIGSPEC] ID [...]
|
||||
kill -l|-L [EXIT_STATUS]
|
||||
|
||||
Send a signal specified by SIGSPEC or SIGNUM to the process named
|
||||
by job specification JOBSPEC or process ID PID. SIGSPEC is either
|
||||
a case-insensitive signal name such as ‘SIGINT’ (with or without
|
||||
the ‘SIG’ prefix) or a signal number; SIGNUM is a signal number.
|
||||
If SIGSPEC and SIGNUM are not present, ‘kill’ sends ‘SIGTERM’.
|
||||
Send a signal specified by SIGSPEC or SIGNUM to the processes named
|
||||
by each ID. Each ID may be a job specification JOBSPEC or process
|
||||
ID PID. SIGSPEC is either a case-insensitive signal name such as
|
||||
‘SIGINT’ (with or without the ‘SIG’ prefix) or a signal number;
|
||||
SIGNUM is a signal number. If SIGSPEC and SIGNUM are not present,
|
||||
‘kill’ sends ‘SIGTERM’.
|
||||
|
||||
The ‘-l’ option lists the signal names. If any arguments are
|
||||
supplied when ‘-l’ is supplied, the names of the signals
|
||||
corresponding to the arguments are listed, and the return status is
|
||||
supplied when ‘-l’ is supplied, ‘kill’ lists the names of the
|
||||
signals corresponding to the arguments, and the return status is
|
||||
zero. EXIT_STATUS is a number specifying a signal number or the
|
||||
exit status of a process terminated by a signal. The ‘-L’ option
|
||||
is equivalent to ‘-l’.
|
||||
exit status of a process terminated by a signal; if it is supplied,
|
||||
‘kill’ prints the name of the signal that caused the process to
|
||||
terminate. ‘kill’ assumes that process exit statuses are greater
|
||||
than 128; anything less than that is a signal number. The ‘-L’
|
||||
option is equivalent to ‘-l’.
|
||||
|
||||
The return status is zero if at least one signal was successfully
|
||||
sent, or non-zero if an error occurs or an invalid option is
|
||||
@@ -8229,9 +8252,9 @@ File: bash.info, Node: Job Control Builtins, Next: Job Control Variables, Pre
|
||||
wait [-fn] [-p VARNAME] [ID ...]
|
||||
|
||||
Wait until the child process specified by each ID exits and return
|
||||
the exit status of the last ID. Each ID may be a PID or job
|
||||
specification JOBSPEC; if a job spec is supplied, ‘wait’ waits for
|
||||
all processes in the job.
|
||||
the exit status of the last ID. Each ID may be a process ID PID or
|
||||
a job specification JOBSPEC; if a jobspec is supplied, ‘wait’ waits
|
||||
for all processes in the job.
|
||||
|
||||
If no options or IDs are supplied, ‘wait’ waits for all running
|
||||
background jobs and the last-executed process substitution, if its
|
||||
@@ -8243,11 +8266,11 @@ File: bash.info, Node: Job Control Builtins, Next: Job Control Variables, Pre
|
||||
is a child of the shell, or if no arguments are supplied and the
|
||||
shell has no unwaited-for children, the exit status is 127.
|
||||
|
||||
If the ‘-p’ option is supplied, the process or job identifier of
|
||||
the job for which the exit status is returned is assigned to the
|
||||
If the ‘-p’ option is supplied, ‘wait’ assigns the process or job
|
||||
identifier of the job for which the exit status is returned to the
|
||||
variable VARNAME named by the option argument. The variable, which
|
||||
cannot be readonly, will be unset initially, before any assignment.
|
||||
This is useful only when the ‘-n’ option is supplied.
|
||||
This is useful only when used with the ‘-n’ option.
|
||||
|
||||
Supplying the ‘-f’ option, when job control is enabled, forces
|
||||
‘wait’ to wait for each ID to terminate before returning its
|
||||
@@ -8263,16 +8286,18 @@ File: bash.info, Node: Job Control Builtins, Next: Job Control Variables, Pre
|
||||
disown [-ar] [-h] [ID ...]
|
||||
|
||||
Without options, remove each ID from the table of active jobs.
|
||||
Each ID may be a PID or job specification JOBSPEC; if ID is a PID,
|
||||
‘disown’ uses the job containing PID. If the ‘-h’ option is
|
||||
supplied, the job is not removed from the table, but is marked so
|
||||
that ‘SIGHUP’ is not sent to the job if the shell receives a
|
||||
‘SIGHUP’. If ID is not present, and neither the ‘-a’ nor the ‘-r’
|
||||
option is supplied, ‘disown’ removes the current job.
|
||||
Each ID may be a job specification JOBSPEC or a process ID PID; if
|
||||
ID is a PID, ‘disown’ uses the job containing PID as JOBSPEC.
|
||||
|
||||
If the ‘-h’ option is supplied, ‘disown’ does not remove the jobs
|
||||
corresponding to each ‘id’ from the jobs table, but rather marks
|
||||
them so the shell does not send ‘SIGHUP’ to the job if the shell
|
||||
receives a ‘SIGHUP’.
|
||||
|
||||
If no ID is supplied, the ‘-a’ option means to remove or mark all
|
||||
jobs; the ‘-r’ option without an ID argument restricts operation to
|
||||
running jobs.
|
||||
jobs; the ‘-r’ option without an ID argument removes or marks
|
||||
running jobs. If no ID is supplied, and neither the ‘-a’ nor the
|
||||
‘-r’ option is supplied, ‘disown’ removes or marks the current job.
|
||||
|
||||
The return value is 0 unless an ID does not specify a valid job.
|
||||
|
||||
@@ -8296,19 +8321,20 @@ File: bash.info, Node: Job Control Variables, Prev: Job Control Builtins, Up:
|
||||
|
||||
‘auto_resume’
|
||||
This variable controls how the shell interacts with the user and
|
||||
job control. If this variable exists then single-word simple
|
||||
commands without redirections are treated as candidates for
|
||||
resumption of an existing job. There is no ambiguity allowed; if
|
||||
there is more than one job beginning with the string typed, then
|
||||
the most recently accessed job is selected. The name of a stopped
|
||||
job, in this context, is the command line used to start it. If
|
||||
this variable is set to the value ‘exact’, the string supplied must
|
||||
match the name of a stopped job exactly; if set to ‘substring’, the
|
||||
string supplied needs to match a substring of the name of a stopped
|
||||
job. The ‘substring’ value provides functionality analogous to the
|
||||
‘%?’ job ID (*note Job Control Basics::). If set to any other
|
||||
value, the supplied string must be a prefix of a stopped job's
|
||||
name; this provides functionality analogous to the ‘%’ job ID.
|
||||
job control. If this variable exists then simple commands
|
||||
consisting of only a single word, without redirections, are treated
|
||||
as candidates for resumption of an existing job. There is no
|
||||
ambiguity allowed; if there is more than one job beginning with or
|
||||
containing the word, then this selects the most recently accessed
|
||||
job. The name of a stopped job, in this context, is the command
|
||||
line used to start it, as displayed by ‘jobs’. If this variable is
|
||||
set to the value ‘exact’, the word must match the name of a stopped
|
||||
job exactly; if set to ‘substring’, the word needs to match a
|
||||
substring of the name of a stopped job. The ‘substring’ value
|
||||
provides functionality analogous to the ‘%?string’ job ID (*note
|
||||
Job Control Basics::). If set to any other value (e.g., ‘prefix’),
|
||||
the word must be a prefix of a stopped job's name; this provides
|
||||
functionality analogous to the ‘%string’ job ID.
|
||||
|
||||
|
||||
File: bash.info, Node: Command Line Editing, Next: Using History Interactively, Prev: Job Control, Up: Top
|
||||
@@ -9090,7 +9116,7 @@ Key Bindings
|
||||
|
||||
This key binding syntax recognizes a number of symbolic
|
||||
character names: DEL, ESC, ESCAPE, LFD, NEWLINE, RET, RETURN,
|
||||
RUBOUT, SPACE, SPC, and TAB.
|
||||
RUBOUT (a destructive backspace), SPACE, SPC, and TAB.
|
||||
|
||||
"KEYSEQ": FUNCTION-NAME or MACRO
|
||||
KEYSEQ differs from KEYNAME above in that strings denoting an
|
||||
@@ -9582,7 +9608,8 @@ File: bash.info, Node: Commands For Text, Next: Commands For Killing, Prev: C
|
||||
‘delete-char (C-d)’
|
||||
Delete the character at point. If this function is bound to the
|
||||
same character as the tty EOF character, as ‘C-d’ commonly is, see
|
||||
above for the effects.
|
||||
above for the effects. This may also be bound to the Delete key on
|
||||
some keyboards.
|
||||
|
||||
‘backward-delete-char (Rubout)’
|
||||
Delete the character behind the cursor. A numeric argument means
|
||||
@@ -12642,7 +12669,7 @@ D.1 Index of Shell Builtin Commands
|
||||
* dirs: Directory Stack Builtins.
|
||||
(line 7)
|
||||
* disown: Job Control Builtins.
|
||||
(line 114)
|
||||
(line 120)
|
||||
* echo: Bash Builtins. (line 284)
|
||||
* enable: Bash Builtins. (line 337)
|
||||
* eval: Bourne Shell Builtins.
|
||||
@@ -12667,9 +12694,9 @@ D.1 Index of Shell Builtin Commands
|
||||
* history: Bash History Builtins.
|
||||
(line 59)
|
||||
* jobs: Job Control Builtins.
|
||||
(line 27)
|
||||
(line 28)
|
||||
* kill: Job Control Builtins.
|
||||
(line 59)
|
||||
(line 61)
|
||||
* let: Bash Builtins. (line 394)
|
||||
* local: Bash Builtins. (line 403)
|
||||
* logout: Bash Builtins. (line 428)
|
||||
@@ -12693,7 +12720,7 @@ D.1 Index of Shell Builtin Commands
|
||||
* shopt: The Shopt Builtin. (line 9)
|
||||
* source: Bash Builtins. (line 668)
|
||||
* suspend: Job Control Builtins.
|
||||
(line 131)
|
||||
(line 139)
|
||||
* test: Bourne Shell Builtins.
|
||||
(line 333)
|
||||
* times: Bourne Shell Builtins.
|
||||
@@ -12711,7 +12738,7 @@ D.1 Index of Shell Builtin Commands
|
||||
* unset: Bourne Shell Builtins.
|
||||
(line 528)
|
||||
* wait: Job Control Builtins.
|
||||
(line 80)
|
||||
(line 86)
|
||||
|
||||
|
||||
File: bash.info, Node: Reserved Word Index, Next: Variable Index, Prev: Builtin Index, Up: Indexes
|
||||
@@ -13021,7 +13048,7 @@ D.4 Function Index
|
||||
* alias-expand-line (): Miscellaneous Commands.
|
||||
(line 133)
|
||||
* backward-char (C-b): Commands For Moving. (line 17)
|
||||
* backward-delete-char (Rubout): Commands For Text. (line 17)
|
||||
* backward-delete-char (Rubout): Commands For Text. (line 18)
|
||||
* backward-kill-line (C-x Rubout): Commands For Killing.
|
||||
(line 11)
|
||||
* backward-kill-word (M-<DEL>): Commands For Killing.
|
||||
@@ -13030,9 +13057,9 @@ D.4 Function Index
|
||||
* beginning-of-history (M-<): Commands For History.
|
||||
(line 20)
|
||||
* beginning-of-line (C-a): Commands For Moving. (line 6)
|
||||
* bracketed-paste-begin (): Commands For Text. (line 34)
|
||||
* bracketed-paste-begin (): Commands For Text. (line 35)
|
||||
* call-last-kbd-macro (C-x e): Keyboard Macros. (line 13)
|
||||
* capitalize-word (M-c): Commands For Text. (line 72)
|
||||
* capitalize-word (M-c): Commands For Text. (line 73)
|
||||
* character-search (C-]): Miscellaneous Commands.
|
||||
(line 41)
|
||||
* character-search-backward (M-C-]): Miscellaneous Commands.
|
||||
@@ -13071,7 +13098,7 @@ D.4 Function Index
|
||||
(line 147)
|
||||
* do-lowercase-version (M-A, M-B, M-X, ...): Miscellaneous Commands.
|
||||
(line 14)
|
||||
* downcase-word (M-l): Commands For Text. (line 68)
|
||||
* downcase-word (M-l): Commands For Text. (line 69)
|
||||
* dump-functions (): Miscellaneous Commands.
|
||||
(line 71)
|
||||
* dump-macros (): Miscellaneous Commands.
|
||||
@@ -13093,7 +13120,7 @@ D.4 Function Index
|
||||
(line 90)
|
||||
* fetch-history (): Commands For History.
|
||||
(line 106)
|
||||
* forward-backward-delete-char (): Commands For Text. (line 22)
|
||||
* forward-backward-delete-char (): Commands For Text. (line 23)
|
||||
* forward-char (C-f): Commands For Moving. (line 14)
|
||||
* forward-search-history (C-s): Commands For History.
|
||||
(line 33)
|
||||
@@ -13145,7 +13172,7 @@ D.4 Function Index
|
||||
(line 39)
|
||||
* operate-and-get-next (C-o): Commands For History.
|
||||
(line 99)
|
||||
* overwrite-mode (): Commands For Text. (line 76)
|
||||
* overwrite-mode (): Commands For Text. (line 77)
|
||||
* possible-command-completions (C-x !): Commands For Completion.
|
||||
(line 87)
|
||||
* possible-completions (M-?): Commands For Completion.
|
||||
@@ -13164,7 +13191,7 @@ D.4 Function Index
|
||||
(line 13)
|
||||
* previous-screen-line (): Commands For Moving. (line 36)
|
||||
* print-last-kbd-macro (): Keyboard Macros. (line 17)
|
||||
* quoted-insert (C-q or C-v): Commands For Text. (line 27)
|
||||
* quoted-insert (C-q or C-v): Commands For Text. (line 28)
|
||||
* re-read-init-file (C-x C-r): Miscellaneous Commands.
|
||||
(line 6)
|
||||
* redraw-current-line (): Commands For Moving. (line 59)
|
||||
@@ -13172,7 +13199,7 @@ D.4 Function Index
|
||||
(line 27)
|
||||
* revert-line (M-r): Miscellaneous Commands.
|
||||
(line 26)
|
||||
* self-insert (a, b, A, 1, !, ...): Commands For Text. (line 31)
|
||||
* self-insert (a, b, A, 1, !, ...): Commands For Text. (line 32)
|
||||
* set-mark (C-@): Miscellaneous Commands.
|
||||
(line 33)
|
||||
* shell-backward-kill-word (): Commands For Killing.
|
||||
@@ -13183,7 +13210,7 @@ D.4 Function Index
|
||||
* shell-forward-word (M-C-f): Commands For Moving. (line 28)
|
||||
* shell-kill-word (M-C-d): Commands For Killing.
|
||||
(line 32)
|
||||
* shell-transpose-words (M-C-t): Commands For Text. (line 57)
|
||||
* shell-transpose-words (M-C-t): Commands For Text. (line 58)
|
||||
* skip-csi-sequence (): Miscellaneous Commands.
|
||||
(line 50)
|
||||
* spell-correct-word (C-x s): Miscellaneous Commands.
|
||||
@@ -13191,8 +13218,8 @@ D.4 Function Index
|
||||
* start-kbd-macro (C-x (): Keyboard Macros. (line 6)
|
||||
* tilde-expand (M-&): Miscellaneous Commands.
|
||||
(line 30)
|
||||
* transpose-chars (C-t): Commands For Text. (line 46)
|
||||
* transpose-words (M-t): Commands For Text. (line 52)
|
||||
* transpose-chars (C-t): Commands For Text. (line 47)
|
||||
* transpose-words (M-t): Commands For Text. (line 53)
|
||||
* undo (C-_ or C-x C-u): Miscellaneous Commands.
|
||||
(line 23)
|
||||
* universal-argument (): Numeric Arguments. (line 10)
|
||||
@@ -13202,7 +13229,7 @@ D.4 Function Index
|
||||
(line 16)
|
||||
* unix-word-rubout (C-w): Commands For Killing.
|
||||
(line 41)
|
||||
* upcase-word (M-u): Commands For Text. (line 64)
|
||||
* upcase-word (M-u): Commands For Text. (line 65)
|
||||
* yank (C-y): Commands For Killing.
|
||||
(line 72)
|
||||
* yank-last-arg (M-. or M-_): Commands For History.
|
||||
@@ -13355,7 +13382,7 @@ D.5 Concept Index
|
||||
* quoting: Quoting. (line 6)
|
||||
* quoting, ANSI: ANSI-C Quoting. (line 6)
|
||||
* Readline, how to use: Job Control Variables.
|
||||
(line 22)
|
||||
(line 23)
|
||||
* redirection: Redirections. (line 6)
|
||||
* reserved word: Definitions. (line 70)
|
||||
* reserved words: Reserved Words. (line 6)
|
||||
@@ -13424,104 +13451,104 @@ Node: Special Parameters70300
|
||||
Node: Shell Expansions73761
|
||||
Node: Brace Expansion75950
|
||||
Node: Tilde Expansion78678
|
||||
Node: Shell Parameter Expansion81620
|
||||
Node: Command Substitution101392
|
||||
Node: Arithmetic Expansion104925
|
||||
Node: Process Substitution105938
|
||||
Node: Word Splitting107054
|
||||
Node: Filename Expansion109151
|
||||
Node: Pattern Matching112419
|
||||
Node: Quote Removal117753
|
||||
Node: Redirections118057
|
||||
Node: Executing Commands128272
|
||||
Node: Simple Command Expansion128939
|
||||
Node: Command Search and Execution131047
|
||||
Node: Command Execution Environment133491
|
||||
Node: Environment136939
|
||||
Node: Exit Status138842
|
||||
Node: Signals140900
|
||||
Node: Shell Scripts144798
|
||||
Node: Shell Builtin Commands148096
|
||||
Node: Bourne Shell Builtins150207
|
||||
Node: Bash Builtins176508
|
||||
Node: Modifying Shell Behavior212956
|
||||
Node: The Set Builtin213298
|
||||
Node: The Shopt Builtin225234
|
||||
Node: Special Builtins242286
|
||||
Node: Shell Variables243275
|
||||
Node: Bourne Shell Variables243709
|
||||
Node: Bash Variables246217
|
||||
Node: Bash Features284474
|
||||
Node: Invoking Bash285488
|
||||
Node: Bash Startup Files291914
|
||||
Node: Interactive Shells297227
|
||||
Node: What is an Interactive Shell?297635
|
||||
Node: Is this Shell Interactive?298297
|
||||
Node: Interactive Shell Behavior299121
|
||||
Node: Bash Conditional Expressions302882
|
||||
Node: Shell Arithmetic308099
|
||||
Node: Aliases311438
|
||||
Node: Arrays314400
|
||||
Node: The Directory Stack321463
|
||||
Node: Directory Stack Builtins322260
|
||||
Node: Controlling the Prompt326705
|
||||
Node: The Restricted Shell329589
|
||||
Node: Bash POSIX Mode332471
|
||||
Node: Shell Compatibility Mode350612
|
||||
Node: Job Control359623
|
||||
Node: Job Control Basics360080
|
||||
Node: Job Control Builtins365388
|
||||
Node: Job Control Variables371556
|
||||
Node: Command Line Editing372724
|
||||
Node: Introduction and Notation374427
|
||||
Node: Readline Interaction376777
|
||||
Node: Readline Bare Essentials377965
|
||||
Node: Readline Movement Commands379773
|
||||
Node: Readline Killing Commands380769
|
||||
Node: Readline Arguments382792
|
||||
Node: Searching383849
|
||||
Node: Readline Init File386110
|
||||
Node: Readline Init File Syntax387414
|
||||
Node: Conditional Init Constructs414134
|
||||
Node: Sample Init File418519
|
||||
Node: Bindable Readline Commands421640
|
||||
Node: Commands For Moving423112
|
||||
Node: Commands For History425339
|
||||
Node: Commands For Text430592
|
||||
Node: Commands For Killing434651
|
||||
Node: Numeric Arguments437439
|
||||
Node: Commands For Completion438591
|
||||
Node: Keyboard Macros443091
|
||||
Node: Miscellaneous Commands443792
|
||||
Node: Readline vi Mode450345
|
||||
Node: Programmable Completion451322
|
||||
Node: Programmable Completion Builtins459374
|
||||
Node: A Programmable Completion Example471039
|
||||
Node: Using History Interactively476384
|
||||
Node: Bash History Facilities477065
|
||||
Node: Bash History Builtins480800
|
||||
Node: History Interaction487271
|
||||
Node: Event Designators492225
|
||||
Node: Word Designators493803
|
||||
Node: Modifiers496111
|
||||
Node: Installing Bash498052
|
||||
Node: Basic Installation499168
|
||||
Node: Compilers and Options503044
|
||||
Node: Compiling For Multiple Architectures503794
|
||||
Node: Installation Names505543
|
||||
Node: Specifying the System Type507777
|
||||
Node: Sharing Defaults508523
|
||||
Node: Operation Controls509237
|
||||
Node: Optional Features510256
|
||||
Node: Reporting Bugs522636
|
||||
Node: Major Differences From The Bourne Shell523994
|
||||
Node: GNU Free Documentation License545414
|
||||
Node: Indexes570591
|
||||
Node: Builtin Index571042
|
||||
Node: Reserved Word Index578140
|
||||
Node: Variable Index580585
|
||||
Node: Function Index597998
|
||||
Node: Concept Index611854
|
||||
Node: Shell Parameter Expansion81633
|
||||
Node: Command Substitution101401
|
||||
Node: Arithmetic Expansion104934
|
||||
Node: Process Substitution105947
|
||||
Node: Word Splitting107063
|
||||
Node: Filename Expansion109160
|
||||
Node: Pattern Matching112428
|
||||
Node: Quote Removal117762
|
||||
Node: Redirections118066
|
||||
Node: Executing Commands128281
|
||||
Node: Simple Command Expansion128948
|
||||
Node: Command Search and Execution131056
|
||||
Node: Command Execution Environment133500
|
||||
Node: Environment136948
|
||||
Node: Exit Status138851
|
||||
Node: Signals140909
|
||||
Node: Shell Scripts144807
|
||||
Node: Shell Builtin Commands148105
|
||||
Node: Bourne Shell Builtins150216
|
||||
Node: Bash Builtins176517
|
||||
Node: Modifying Shell Behavior212965
|
||||
Node: The Set Builtin213307
|
||||
Node: The Shopt Builtin225243
|
||||
Node: Special Builtins242295
|
||||
Node: Shell Variables243284
|
||||
Node: Bourne Shell Variables243718
|
||||
Node: Bash Variables246226
|
||||
Node: Bash Features284483
|
||||
Node: Invoking Bash285497
|
||||
Node: Bash Startup Files291923
|
||||
Node: Interactive Shells297236
|
||||
Node: What is an Interactive Shell?297644
|
||||
Node: Is this Shell Interactive?298306
|
||||
Node: Interactive Shell Behavior299130
|
||||
Node: Bash Conditional Expressions302891
|
||||
Node: Shell Arithmetic308108
|
||||
Node: Aliases311447
|
||||
Node: Arrays314582
|
||||
Node: The Directory Stack321645
|
||||
Node: Directory Stack Builtins322442
|
||||
Node: Controlling the Prompt326887
|
||||
Node: The Restricted Shell329771
|
||||
Node: Bash POSIX Mode332653
|
||||
Node: Shell Compatibility Mode350794
|
||||
Node: Job Control359805
|
||||
Node: Job Control Basics360262
|
||||
Node: Job Control Builtins366538
|
||||
Node: Job Control Variables373220
|
||||
Node: Command Line Editing374451
|
||||
Node: Introduction and Notation376154
|
||||
Node: Readline Interaction378504
|
||||
Node: Readline Bare Essentials379692
|
||||
Node: Readline Movement Commands381500
|
||||
Node: Readline Killing Commands382496
|
||||
Node: Readline Arguments384519
|
||||
Node: Searching385576
|
||||
Node: Readline Init File387837
|
||||
Node: Readline Init File Syntax389141
|
||||
Node: Conditional Init Constructs415887
|
||||
Node: Sample Init File420272
|
||||
Node: Bindable Readline Commands423393
|
||||
Node: Commands For Moving424865
|
||||
Node: Commands For History427092
|
||||
Node: Commands For Text432345
|
||||
Node: Commands For Killing436470
|
||||
Node: Numeric Arguments439258
|
||||
Node: Commands For Completion440410
|
||||
Node: Keyboard Macros444910
|
||||
Node: Miscellaneous Commands445611
|
||||
Node: Readline vi Mode452164
|
||||
Node: Programmable Completion453141
|
||||
Node: Programmable Completion Builtins461193
|
||||
Node: A Programmable Completion Example472858
|
||||
Node: Using History Interactively478203
|
||||
Node: Bash History Facilities478884
|
||||
Node: Bash History Builtins482619
|
||||
Node: History Interaction489090
|
||||
Node: Event Designators494044
|
||||
Node: Word Designators495622
|
||||
Node: Modifiers497930
|
||||
Node: Installing Bash499871
|
||||
Node: Basic Installation500987
|
||||
Node: Compilers and Options504863
|
||||
Node: Compiling For Multiple Architectures505613
|
||||
Node: Installation Names507362
|
||||
Node: Specifying the System Type509596
|
||||
Node: Sharing Defaults510342
|
||||
Node: Operation Controls511056
|
||||
Node: Optional Features512075
|
||||
Node: Reporting Bugs524455
|
||||
Node: Major Differences From The Bourne Shell525813
|
||||
Node: GNU Free Documentation License547233
|
||||
Node: Indexes572410
|
||||
Node: Builtin Index572861
|
||||
Node: Reserved Word Index579959
|
||||
Node: Variable Index582404
|
||||
Node: Function Index599817
|
||||
Node: Concept Index613673
|
||||
|
||||
End Tag Table
|
||||
|
||||
|
||||
Reference in New Issue
Block a user