pmodules/bash
0
0
Fork 0
mirror of https://https.git.savannah.gnu.org/git/bash.git synced 2026-06-30 17:09:50 +02:00
Code Issues Packages Projects Releases Wiki Activity

next set of documentation fixes: update formatting, make filename formatting consistent, typeset the name readline consistently

Browse Source
This commit is contained in:
Chet Ramey
2024-10-18 12:19:48 -04:00
parent 3ed028ccec
commit 261c6e8cc6
63 changed files with 21845 additions and 20671 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CWRU/CWRU.chlog
+20
View File
@@ -10360,3 +10360,23 @@ doc/bash.1,doc/bashref.texi
doc/bash.1,doc/bashref.texi,lib/readline/doc/readline.3,lib/readline/doc/rluser.texi
- minor wording updates and typo fixes from
G. Branden Robinson <g.branden.robinson@gmail.com>
10/15
-----
doc/bash.1,doc/bashref.texi,lib/readline/doc/readline.3,lib/readline/doc/rluser.texi
- wording/formatting updates and typo fixes from
G. Branden Robinson <g.branden.robinson@gmail.com>
doc/bash.1
- update .FN macro, use it consistently for filenames, like @file{}
doc/bashref.texi
- make sure to use @dots and @file consistently
doc/bash.1,lib/readline/doc/readline.3
- make sure `readline' is typeset consistently
10/18
-----
sig.c
- fix minix typo
INSTALL
+1 -1
View File
@@ -107,7 +107,7 @@ you want the object files and executables to go and run the ‘configure’
script from the source directory (*note Basic Installation::). You may
need to supply the ‘--srcdir=PATH’ argument to tell ‘configure’ where
the source files are. ‘configure’ automatically checks for the source
code in the directory that ‘configure’ is in and in '..'.
code in the directory that ‘configure’ is in and in ‘..’.
If you have to use a ‘make’ that does not support the ‘VPATH’ variable,
you can compile Bash for one architecture at a time in the source code
POSIX
+216 -219
View File
@@ -15,13 +15,13 @@ standard was published in 1992. It was merged with the original IEEE
1003.1 Working Group and is currently maintained by the Austin Group (a
joint working group of the IEEE, The Open Group and ISO/IEC SC22/WG15).
Today the Shell and Utilities are a volume within the set of documents
that make up IEEE Std 1003.1-2017, and thus the former POSIX.2 (from
that make up IEEE Std 1003.1-2024, and thus the former POSIX.2 (from
1992) is now part of the current unified POSIX standard.
The Shell and Utilities volume concentrates on the command interpreter
interface and utility programs commonly executed from the command line
or by other programs. The standard is freely available on the web at
<https://pubs.opengroup.org/onlinepubs/9699919799/utilities/contents.html>.
<https://pubs.opengroup.org/onlinepubs/9799919799/utilities/contents.html>.
Bash is concerned with the aspects of the shell's behavior defined by
the POSIX Shell and Utilities volume. The shell command language has of
@@ -45,7 +45,7 @@ editing commands were left out due to objections.
Although Bash is an implementation of the POSIX shell specification,
there are areas where the Bash default behavior differs from the
specification. The Bash “posix mode” changes the Bash behavior in these
areas so that it conforms to the standard more closely.
areas so that it conforms more closely to the standard.
Starting Bash with the ‘--posix’ command-line option or executing ‘set
-o posix’ while Bash is running will cause Bash to conform more closely
@@ -59,132 +59,148 @@ The following list is what's changed when 'POSIX mode' is in effect:
1. Bash ensures that the ‘POSIXLY_CORRECT’ variable is set.
2. When a command in the hash table no longer exists, Bash will
re-search ‘$PATH’ to find the new location. This is also available
with ‘shopt -s checkhash’.
2. Bash reads and executes the POSIX startup files (‘$ENV’) rather
than the normal Bash files (*note Bash Startup Files::.
3. Bash will not insert a command without the execute bit set into the
command hash table, even if it returns it as a (last-ditch) result
from a ‘$PATH’ search.
3. Alias expansion is always enabled, even in non-interactive shells.
4. The message printed by the job control code and builtins when a job
exits with a non-zero status is 'Done(status)'.
5. The message printed by the job control code and builtins when a job
is stopped is 'Stopped(SIGNAME)', where SIGNAME is, for example,
‘SIGTSTP’.
6. If the shell is interactive, Bash does not perform job
notifications between executing commands in lists separated by ‘;’
or newline. Non-interactive shells print status messages after a
foreground job in a list completes.
7. If the shell is interactive, Bash waits until the next prompt
before printing the status of a background job that changes status
or a foreground job that terminates due to a signal.
Non-interactive shells print status messages after a foreground job
completes.
8. Bash permanently removes jobs from the jobs table after notifying
the user of their termination, whether that is via ‘wait’, ‘jobs’,
or interactive shell notification before prompting.
9. Alias expansion is always enabled, even in non-interactive shells.
10. Reserved words appearing in a context where reserved words are
4. Reserved words appearing in a context where reserved words are
recognized do not undergo alias expansion.
11. Alias expansion is performed when initially parsing a command
substitution. The default mode generally defers it, when enabled,
until the command substitution is executed. This means that
command substitution will not expand aliases that are defined after
the command substitution is initially parsed (e.g., as part of a
function definition).
5. Alias expansion is performed when initially parsing a command
substitution. The default (non-posix) mode generally defers it,
when enabled, until the command substitution is executed. This
means that command substitution will not expand aliases that are
defined after the command substitution is initially parsed (e.g.,
as part of a function definition).
12. The POSIX ‘PS1’ and ‘PS2’ expansions of ‘!’ to the history number
and ‘!!’ to ‘!’ are enabled, and parameter expansion is performed
on the values of ‘PS1’ and ‘PS2’ regardless of the setting of the
‘promptvars’ option.
6. The ‘time’ reserved word may be used by itself as a simple command.
When used in this way, it displays timing statistics for the shell
and its completed children. The ‘TIMEFORMAT’ variable controls the
format of the timing information.
13. The POSIX startup files are executed (‘$ENV’) rather than the
normal Bash files.
7. The parser does not recognize ‘time’ as a reserved word if the next
token begins with a ‘-’.
14. Tilde expansion is only performed on assignments preceding a
command name, rather than on all assignment statements on the line.
8. When parsing and expanding a ${...} expansion that appears within
double quotes, single quotes are no longer special and cannot be
used to quote a closing brace or other special character, unless
the operator is one of those defined to perform pattern removal.
In this case, they do not have to appear as matched pairs.
15. The default history file is ‘~/.sh_history’ (this is the default
value the shell assigns to ‘$HISTFILE’).
9. Redirection operators do not perform filename expansion on the word
in a redirection unless the shell is interactive.
16. Redirection operators do not perform filename expansion on the
word in the redirection unless the shell is interactive.
10. Redirection operators do not perform word splitting on the word in
a redirection.
17. Redirection operators do not perform word splitting on the word in
the redirection.
18. Function names must be valid shell ‘name’s. That is, they may not
11. Function names must be valid shell ‘name’s. That is, they may not
contain characters other than letters, digits, and underscores, and
may not start with a digit. Declaring a function with an invalid
name causes a fatal syntax error in non-interactive shells.
name in a non-interactive shell is a fatal syntax error.
19. Function names may not be the same as one of the POSIX special
12. Function names may not be the same as one of the POSIX special
builtins.
13. Tilde expansion is only performed on assignments preceding a
command name, rather than on all assignment statements on the line.
14. While variable indirection is available, it may not be applied to
the ‘#’ and ‘?’ special parameters.
15. Expanding the ‘*’ special parameter in a pattern context where the
expansion is double-quoted does not treat the ‘$*’ as if it were
double-quoted.
16. A double quote character (‘"’) is treated specially when it
appears in a backquoted command substitution in the body of a
here-document that undergoes expansion. That means, for example,
that a backslash preceding a double quote character will escape it
and the backslash will be removed.
17. Command substitutions don't set the ‘?’ special parameter. The
exit status of a simple command without a command word is still the
exit status of the last command substitution that occurred while
evaluating the variable assignments and redirections in that
command, but that does not happen until after all of the
assignments and redirections.
18. Literal tildes that appear as the first character in elements of
the ‘PATH’ variable are not expanded as described above under *note
Tilde Expansion::.
19. Command lookup finds POSIX special builtins before shell
functions, including output printed by the ‘type’ and ‘command’
builtins.
20. Even if a shell function whose name contains a slash was defined
before entering POSIX mode, the shell will not execute a function
whose name contains one or more slashes.
21. POSIX special builtins are found before shell functions during
command lookup, including output printed by the ‘type’ and
‘command’ builtins.
21. When a command in the hash table no longer exists, Bash will
re-search ‘$PATH’ to find the new location. This is also available
with ‘shopt -s checkhash’.
22. When printing shell function definitions (e.g., by ‘type’), Bash
does not print the ‘function’ keyword.
22. Bash will not insert a command without the execute bit set into
the command hash table, even if it returns it as a (last-ditch)
result from a ‘$PATH’ search.
23. Literal tildes that appear as the first character in elements of
the ‘PATH’ variable are not expanded as described above under *note
Tilde Expansion::.
23. The message printed by the job control code and builtins when a
job exits with a non-zero status is 'Done(status)'.
24. The ‘time’ reserved word may be used by itself as a command. When
used in this way, it displays timing statistics for the shell and
its completed children. The ‘TIMEFORMAT’ variable controls the
format of the timing information.
24. The message printed by the job control code and builtins when a
job is stopped is 'Stopped(SIGNAME)', where SIGNAME is, for
example, ‘SIGTSTP’.
25. When parsing and expanding a ${...} expansion that appears within
double quotes, single quotes are no longer special and cannot be
used to quote a closing brace or other special character, unless
the operator is one of those defined to perform pattern removal.
In this case, they do not have to appear as matched pairs.
25. If the shell is interactive, Bash does not perform job
notifications between executing commands in lists separated by ‘;’
or newline. Non-interactive shells print status messages after a
foreground job in a list completes.
26. The parser does not recognize ‘time’ as a reserved word if the
next token begins with a ‘-’.
26. If the shell is interactive, Bash waits until the next prompt
before printing the status of a background job that changes status
or a foreground job that terminates due to a signal.
Non-interactive shells print status messages after a foreground job
completes.
27. The ‘!’ character does not introduce history expansion within a
27. Bash permanently removes jobs from the jobs table after notifying
the user of their termination via the ‘wait’ or ‘jobs’ builtins.
28. The ‘vi’ editing mode will invoke the ‘vi’ editor directly when
the ‘v’ command is run, instead of checking ‘$VISUAL’ and
‘$EDITOR’.
29. Prompt expansion enables the POSIX ‘PS1’ and ‘PS2’ expansions of
‘!’ to the history number and ‘!!’ to ‘!’, and Bash performs
parameter expansion on the values of ‘PS1’ and ‘PS2’ regardless of
the setting of the ‘promptvars’ option.
30. The default history file is ‘~/.sh_history’ (this is the default
value the shell assigns to ‘$HISTFILE’).
31. The ‘!’ character does not introduce history expansion within a
double-quoted string, even if the ‘histexpand’ option is enabled.
28. If a POSIX special builtin returns an error status, a
32. When printing shell function definitions (e.g., by ‘type’), Bash
does not print the ‘function’ keyword.
33. Non-interactive shells exit if a syntax error in an arithmetic
expansion results in an invalid expression.
34. Non-interactive shells exit if a parameter expansion error occurs.
35. If a POSIX special builtin returns an error status, a
non-interactive shell exits. The fatal errors are those listed in
the POSIX standard, and include things like passing incorrect
options, redirection errors, variable assignment errors for
assignments preceding the command name, and so on.
29. The ‘unset’ builtin with the ‘-v’ option specified returns a fatal
error if it attempts to unset a ‘readonly’ or ‘non-unsettable’
variable, or encounters a variable name argument that is an invalid
identifier, which causes a non-interactive shell to exit.
30. When asked to unset a variable that appears in an assignment
statement preceding the command, the ‘unset’ builtin attempts to
unset a variable of the same name in the current or previous scope
as well. This implements the required "if an assigned variable is
further modified by the utility, the modifications made by the
utility shall persist" behavior.
31. A non-interactive shell exits with an error status if a variable
36. A non-interactive shell exits with an error status if a variable
assignment error occurs when no command name follows the assignment
statements. A variable assignment error occurs, for example, when
trying to assign a value to a readonly variable.
32. A non-interactive shell exits with an error status if a variable
37. A non-interactive shell exits with an error status if a variable
assignment error occurs in an assignment statement preceding a
special builtin, but not with any other simple command. For any
other simple command, the shell aborts execution of that command,
@@ -192,172 +208,157 @@ The following list is what's changed when 'POSIX mode' is in effect:
perform any further processing of the command in which the error
occurred").
33. A non-interactive shell exits with an error status if the
38. A non-interactive shell exits with an error status if the
iteration variable in a ‘for’ statement or the selection variable
in a ‘select’ statement is a readonly variable or has an invalid
name.
34. Non-interactive shells exit if FILENAME in ‘.’ FILENAME is not
39. Non-interactive shells exit if FILENAME in ‘.’ FILENAME is not
found.
35. Non-interactive shells exit if a syntax error in an arithmetic
expansion results in an invalid expression.
36. Non-interactive shells exit if a parameter expansion error occurs.
37. Non-interactive shells exit if there is a syntax error in a script
40. Non-interactive shells exit if there is a syntax error in a script
read with the ‘.’ or ‘source’ builtins, or in a string processed by
the ‘eval’ builtin.
38. While variable indirection is available, it may not be applied to
the ‘#’ and ‘?’ special parameters.
41. Non-interactive shells exit if the ‘export’, ‘readonly’ or ‘unset’
builtin commands get an argument that is not a valid identifier,
and they are not operating on shell functions. These errors force
an exit because these are special builtins.
39. Expanding the ‘*’ special parameter in a pattern context where the
expansion is double-quoted does not treat the ‘$*’ as if it were
double-quoted.
40. Assignment statements preceding POSIX special builtins persist in
42. Assignment statements preceding POSIX special builtins persist in
the shell environment after the builtin completes.
41. The ‘command’ builtin does not prevent builtins that take
43. The ‘command’ builtin does not prevent builtins that take
assignment statements as arguments from expanding them as
assignment statements; when not in POSIX mode, assignment builtins
assignment statements; when not in POSIX mode, declaration commands
lose their assignment statement expansion properties when preceded
by ‘command’.
42. The ‘bg’ builtin uses the required format to describe each job
44. Enabling POSIX mode has the effect of setting the
‘inherit_errexit’ option, so subshells spawned to execute command
substitutions inherit the value of the ‘-e’ option from the parent
shell. When the ‘inherit_errexit’ option is not enabled, Bash
clears the ‘-e’ option in such subshells.
45. Enabling POSIX mode has the effect of setting the ‘shift_verbose’
option, so numeric arguments to ‘shift’ that exceed the number of
positional parameters will result in an error message.
46. Enabling POSIX mode has the effect of setting the
‘interactive_comments’ option (*note Comments::).
47. The ‘.’ and ‘source’ builtins do not search the current directory
for the filename argument if it is not found by searching ‘PATH’.
48. When the ‘alias’ builtin displays alias definitions, it does not
display them with a leading ‘alias ’ unless the ‘-p’ option is
supplied.
49. The ‘bg’ builtin uses the required format to describe each job
placed in the background, which does not include an indication of
whether the job is the current or previous job.
43. The output of ‘kill -l’ prints all the signal names on a single
line, separated by spaces, without the ‘SIG’ prefix.
50. When the ‘cd’ builtin is invoked in logical mode, and the pathname
constructed from ‘$PWD’ and the directory name supplied as an
argument does not refer to an existing directory, ‘cd’ will fail
instead of falling back to physical mode.
44. The ‘kill’ builtin does not accept signal names with a ‘SIG’
prefix.
51. When the ‘cd’ builtin cannot change a directory because the length
of the pathname constructed from ‘$PWD’ and the directory name
supplied as an argument exceeds ‘PATH_MAX’ when canonicalized, ‘cd’
will attempt to use the supplied directory name.
45. The ‘export’ and ‘readonly’ builtin commands display their output
52. When the ‘xpg_echo’ option is enabled, Bash does not attempt to
interpret any arguments to ‘echo’ as options. ‘echo’ displays each
argument after converting escape sequences.
53. The ‘export’ and ‘readonly’ builtin commands display their output
in the format required by POSIX.
46. If the ‘export’ and ‘readonly’ builtin commands get an argument
that is not a valid identifier, and they are not operating on shell
functions, they return an error. This will cause a non-interactive
shell to exit because these are special builtins.
54. When listing the history, the ‘fc’ builtin does not include an
indication of whether or not a history entry has been modified.
47. The ‘trap’ builtin displays signal names without the leading
55. The default editor used by ‘fc’ is ‘ed’.
56. ‘fc’ treats extra arguments as an error instead of ignoring them.
57. If there are too many arguments supplied to ‘fc -s’, ‘fc’ prints
an error message and returns failure.
58. The output of ‘kill -l’ prints all the signal names on a single
line, separated by spaces, without the ‘SIG’ prefix.
59. The ‘kill’ builtin does not accept signal names with a ‘SIG’
prefix.
60. The ‘printf’ builtin uses ‘double’ (via ‘strtod’) to convert
arguments corresponding to floating point conversion specifiers,
instead of ‘long double’ if it's available. The ‘L’ length
modifier forces ‘printf’ to use ‘long double’ if it's available.
61. The ‘pwd’ builtin verifies that the value it prints is the same as
the current directory, even if it is not asked to check the file
system with the ‘-P’ option.
62. The ‘read’ builtin may be interrupted by a signal for which a trap
has been set. If Bash receives a trapped signal while executing
‘read’, the trap handler executes and ‘read’ returns an exit status
greater than 128.
63. When the ‘set’ builtin is invoked without options, it does not
display shell function names and definitions.
64. When the ‘set’ builtin is invoked without options, it displays
variable values without quotes, unless they contain shell
metacharacters, even if the result contains nonprinting characters.
65. The ‘test’ builtin compares strings using the current locale when
evaluating the ‘<’ and ‘>’ binary operators.
66. The ‘test’ builtin's ‘-t’ unary primary requires an argument.
Historical versions of ‘test’ made the argument optional in certain
cases, and Bash attempts to accommodate those for backwards
compatibility.
67. The ‘trap’ builtin displays signal names without the leading
‘SIG’.
48. The ‘trap’ builtin doesn't check the first argument for a possible
68. The ‘trap’ builtin doesn't check the first argument for a possible
signal specification and revert the signal handling to the original
disposition if it is, unless that argument consists solely of
digits and is a valid signal number. If users want to reset the
handler for a given signal to the original disposition, they should
use ‘-’ as the first argument.
49. ‘trap -p’ without arguments displays signals whose dispositions
69. ‘trap -p’ without arguments displays signals whose dispositions
are set to SIG_DFL and those that were ignored when the shell
started, not just trapped signals.
50. The ‘.’ and ‘source’ builtins do not search the current directory
for the filename argument if it is not found by searching ‘PATH’.
51. Enabling POSIX mode has the effect of setting the
‘inherit_errexit’ option, so subshells spawned to execute command
substitutions inherit the value of the ‘-e’ option from the parent
shell. When the ‘inherit_errexit’ option is not enabled, Bash
clears the ‘-e’ option in such subshells.
52. Enabling POSIX mode has the effect of setting the ‘shift_verbose’
option, so numeric arguments to ‘shift’ that exceed the number of
positional parameters will result in an error message.
53. When the ‘alias’ builtin displays alias definitions, it does not
display them with a leading ‘alias ’ unless the ‘-p’ option is
supplied.
54. When the ‘set’ builtin is invoked without options, it does not
display shell function names and definitions.
55. When the ‘set’ builtin is invoked without options, it displays
variable values without quotes, unless they contain shell
metacharacters, even if the result contains nonprinting characters.
56. When the ‘cd’ builtin is invoked in logical mode, and the pathname
constructed from ‘$PWD’ and the directory name supplied as an
argument does not refer to an existing directory, ‘cd’ will fail
instead of falling back to physical mode.
57. When the ‘cd’ builtin cannot change a directory because the length
of the pathname constructed from ‘$PWD’ and the directory name
supplied as an argument exceeds ‘PATH_MAX’ when canonicalized, ‘cd’
will attempt to use the supplied directory name.
58. The ‘pwd’ builtin verifies that the value it prints is the same as
the current directory, even if it is not asked to check the file
system with the ‘-P’ option.
59. When listing the history, the ‘fc’ builtin does not include an
indication of whether or not a history entry has been modified.
60. The default editor used by ‘fc’ is ‘ed’.
61. ‘fc’ treats extra arguments as an error instead of ignoring them.
62. If there are too many arguments supplied to ‘fc -s’, ‘fc’ prints
an error message and returns failure.
63. The ‘type’ and ‘command’ builtins will not report a non-executable
70. The ‘type’ and ‘command’ builtins will not report a non-executable
file as having been found, though the shell will attempt to execute
such a file if it is the only so-named file found in ‘$PATH’.
64. The ‘vi’ editing mode will invoke the ‘vi’ editor directly when
the ‘v’ command is run, instead of checking ‘$VISUAL’ and
‘$EDITOR’.
65. When the ‘xpg_echo’ option is enabled, Bash does not attempt to
interpret any arguments to ‘echo’ as options. Each argument is
displayed, after escape characters are converted.
66. The ‘ulimit’ builtin uses a block size of 512 bytes for the ‘-c’
71. The ‘ulimit’ builtin uses a block size of 512 bytes for the ‘-c’
and ‘-f’ options.
67. The arrival of ‘SIGCHLD’ when a trap is set on ‘SIGCHLD’ does not
72. The ‘unset’ builtin with the ‘-v’ option specified returns a fatal
error if it attempts to unset a ‘readonly’ or ‘non-unsettable’
variable, which causes a non-interactive shell to exit.
73. When asked to unset a variable that appears in an assignment
statement preceding the command, the ‘unset’ builtin attempts to
unset a variable of the same name in the current or previous scope
as well. This implements the required "if an assigned variable is
further modified by the utility, the modifications made by the
utility shall persist" behavior.
74. The arrival of ‘SIGCHLD’ when a trap is set on ‘SIGCHLD’ does not
interrupt the ‘wait’ builtin and cause it to return immediately.
The trap command is run once for each child that exits.
68. The ‘read’ builtin may be interrupted by a signal for which a trap
has been set. If Bash receives a trapped signal while executing
‘read’, the trap handler executes and ‘read’ returns an exit status
greater than 128.
69. The ‘printf’ builtin uses ‘double’ (via ‘strtod’) to convert
arguments corresponding to floating point conversion specifiers,
instead of ‘long double’ if it's available. The ‘L’ length
modifier forces ‘printf’ to use ‘long double’ if it's available.
70. Bash removes an exited background process's status from the list
75. Bash removes an exited background process's status from the list
of such statuses after the ‘wait’ builtin is used to obtain it.
71. A double quote character (‘"’) is treated specially when it
appears in a backquoted command substitution in the body of a
here-document that undergoes expansion. That means, for example,
that a backslash preceding a double quote character will escape it
and the backslash will be removed.
72. The ‘test’ builtin compares strings using the current locale when
processing the ‘<’ and ‘>’ binary operators.
73. The ‘test’ builtin's ‘-t’ unary primary requires an argument.
Historical versions of ‘test’ made the argument optional in certain
cases, and Bash attempts to accommodate those for backwards
compatibility.
74. Command substitutions don't set the ‘?’ special parameter. The
exit status of a simple command without a command word is still the
exit status of the last command substitution that occurred while
evaluating the variable assignments and redirections in that
command, but that does not happen until after all of the
assignments and redirections.
There is other POSIX behavior that Bash does not implement by default
even when in POSIX mode. Specifically:
@@ -365,11 +366,7 @@ even when in POSIX mode. Specifically:
entries if ‘FCEDIT’ is unset, rather than defaulting directly to
‘ed’. ‘fc’ uses ‘ed’ if ‘EDITOR’ is unset.
2. A non-interactive shell does not exit if a variable assignment
preceding the ‘command’ builtin or another non-special builtin
fails.
3. As noted above, Bash requires the ‘xpg_echo’ option to be enabled
2. As noted above, Bash requires the ‘xpg_echo’ option to be enabled
for the ‘echo’ builtin to be fully conformant.
Bash can be configured to be POSIX-conformant by default, by specifying
doc/bash.0
+2000 -1989
View File
File diff suppressed because it is too large Load Diff
doc/bash.1
+302 -239
View File
File diff suppressed because it is too large Load Diff
doc/bash.html
+370 -217
View File
File diff suppressed because it is too large Load Diff
doc/bash.info
+263 -254
View File
@@ -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, 14 October 2024).
Bash shell (version 5.3, 15 October 2024).
This is Edition 5.3, last updated 14 October 2024, of ‘The GNU Bash
This is Edition 5.3, last updated 15 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, 14 October 2024). The Bash home page is
Bash shell (version 5.3, 15 October 2024). The Bash home page is
<http://www.gnu.org/software/bash/>.
This is Edition 5.3, last updated 14 October 2024, of ‘The GNU Bash
This is Edition 5.3, last updated 15 October 2024, of ‘The GNU Bash
Reference Manual’, for ‘Bash’, Version 5.3.
Bash contains features that appear in other popular shells, and some
@@ -2619,7 +2619,7 @@ set of filenames that are tested: when ‘dotglob’ is enabled, the set of
filenames includes all files beginning with ‘.’, but the filenames ‘.’
and ‘..’ must be matched by a pattern or sub-pattern that begins with a
dot; when it is disabled, the set does not include any filenames
beginning with "." unless the pattern or sub-pattern begins with a ‘.’.
beginning with ‘.’ unless the pattern or sub-pattern begins with a ‘.’.
If the ‘globskipdots’ shell option is enabled, the filenames ‘.’ and
‘..’ never appear in the set. As above, ‘.’ only has a special meaning
when matching filenames.
@@ -2673,7 +2673,7 @@ redirection refers to the standard input (file descriptor 0). If the
first character of the redirection operator is ‘>’, the redirection
refers to the standard output (file descriptor 1).
The \fIword\fP following the redirection operator in the following
The WORD following the redirection operator in the following
descriptions, unless otherwise noted, is subjected to brace expansion,
tilde expansion, parameter and variable expansion, command substitution,
arithmetic expansion, quote removal, filename expansion, and word
@@ -3407,18 +3407,19 @@ standard.
greater than or equal to 1.
‘cd’
cd [-L|[-P [-e]]] [-@] [DIRECTORY]
cd [-L] [-@] [DIRECTORY]
cd -P [-e] [-@] [DIRECTORY]
Change the current working directory to DIRECTORY. If DIRECTORY is
not supplied, the value of the ‘HOME’ shell variable is used as
DIRECTORY. If the shell variable ‘CDPATH’ exists, ‘cd’ uses it as
a search path: ‘cd’ searches each directory name in ‘CDPATH’ for
DIRECTORY, with alternative directory names in ‘CDPATH’ separated
by a colon (‘:’). A null directory name in ‘CDPATH’ means the same
thing as the current directory. If DIRECTORY begins with a slash,
‘CDPATH’ is not used.
DIRECTORY. If the shell variable ‘CDPATH’ exists, and DIRECTORY
does not begin with a slash, ‘cd’ uses it as a search path: ‘cd’
searches each directory name in ‘CDPATH’ for DIRECTORY, with
alternative directory names in ‘CDPATH’ separated by a colon (‘:’).
A null directory name in ‘CDPATH’ means the same thing as the
current directory.
The ‘-P’ option means to not follow symbolic links: symbolic links
The ‘-P’ option means not to follow symbolic links: symbolic links
are resolved while ‘cd’ is traversing DIRECTORY and before
processing an instance of ‘..’ in DIRECTORY.
@@ -3426,13 +3427,16 @@ standard.
DIRECTORY are resolved after ‘cd’ processes an instance of ‘..’ in
DIRECTORY.
If ‘..’ appears in DIRECTORY, it is processed by removing the
If ‘..’ appears in DIRECTORY, ‘cd’ processes it by removing the
immediately preceding pathname component, back to a slash or the
beginning of DIRECTORY.
beginning of DIRECTORY, and verifying that the portion of DIRECTORY
it has processed to that point is still a valid directory name
after removing the pathname component. If it is not a valid
directory name, ‘cd’ returns a non-zero status.
If the ‘-e’ option is supplied with ‘-P’ and the current working
directory cannot be successfully determined after a successful
directory change, ‘cd’ will return a non-zero status.
If the ‘-e’ option is supplied with ‘-P’ and ‘cd’ cannot
successfully determine the current working directory after a
successful directory change, it will return a non-zero status.
On systems that support it, the ‘-@’ option presents the extended
attributes associated with a file as a directory.
@@ -5364,9 +5368,9 @@ This builtin allows you to change additional optional shell behavior.
completion.
‘noexpand_translation’
If set, Bash encloses the translated results of $"..."
quoting in single quotes instead of double quotes. If the
string is not translated, this has no effect.
If set, Bash encloses the translated results of $"..." quoting
in single quotes instead of double quotes. If the string is
not translated, this has no effect.
‘nullglob’
If set, filename expansion patterns which match no files
@@ -5840,7 +5844,7 @@ Variables::).
‘EPOCHREALTIME’
Each time this parameter is referenced, it expands to the number of
seconds since the Unix Epoch as a floating point value with
seconds since the Unix Epoch as a floating-point value with
micro-second granularity (see the documentation for the C library
function ‘time’ for the definition of Epoch). Assignments to
‘EPOCHREALTIME’ are ignored. If ‘EPOCHREALTIME’ is unset, it loses
@@ -5912,12 +5916,15 @@ Variables::).
value of this variable specifies the sort criteria and sort order
for the results of filename expansion. If this variable is unset
or set to the null string, filename expansion uses the historical
behavior of sorting by name. If set, a valid value begins with an
optional ‘+’, which is ignored, or ‘-’, which reverses the sort
order from ascending to descending, followed by a sort specifier.
The valid sort specifiers are ‘name’, ‘numeric’, ‘size’, ‘mtime’,
‘atime’, ‘ctime’, and ‘blocks’, which sort the files on name, names
in numeric rather than lexicographic order, file size, modification
behavior of sorting by name, in ascending lexicographic order as
determined by the ‘LC_COLLATE’ shell variable.
If set, a valid value begins with an optional ‘+’, which is
ignored, or ‘-’, which reverses the sort order from ascending to
descending, followed by a sort specifier. The valid sort
specifiers are ‘name’, ‘numeric’, ‘size’, ‘mtime’, ‘atime’,
‘ctime’, and ‘blocks’, which sort the files on name, names in
numeric rather than lexicographic order, file size, modification
time, access time, inode change time, and number of blocks,
respectively. If any of the non-name keys compare as equal (e.g.,
if two files are the same size), sorting uses the name as a
@@ -5927,14 +5934,14 @@ Variables::).
order by modification time (newest first).
The ‘numeric’ specifier treats names consisting solely of digits as
numbers and sorts them using the numeric value (so "2" will sort
numbers and sorts them using their numeric value (so "2" will sort
before "10", for example). When using ‘numeric’, names containing
non-digits sort after all the all-digit names and are sorted by
name using the traditional behavior.
A sort specifier of ‘nosort’ disables sorting completely; the
results are returned in the order they are read from the file
system, and any leading ‘-’ is ignored.
A sort specifier of ‘nosort’ disables sorting completely; Bash
returns the results in the order they are read from the file
system, ignoring any leading ‘-’.
If the sort specifier is missing, it defaults to NAME, so a value
of ‘+’ is equivalent to the null string, and a value of ‘-’ sorts
@@ -5951,17 +5958,16 @@ Variables::).
‘histchars’
Up to three characters which control history expansion, quick
substitution, and tokenization (*note History Interaction::). The
first character is the “history expansion” character, that is, the
character which signifies the start of a history expansion,
normally ‘!’. The second character is the character which
signifies "quick substitution" when seen as the first character on
a line, normally ‘^’. The optional third character is the
character which indicates that the remainder of the line is a
comment when found as the first character of a word, usually ‘#’.
The history comment character causes history substitution to be
skipped for the remaining words on the line. It does not
necessarily cause the shell parser to treat the rest of the line as
a comment.
first character is the “history expansion” character, the character
which begins a history expansion, normally ‘!’. The second
character is the character which signifies "quick substitution"
when seen as the first character on a line, normally ‘^’. The
optional third character is the character which indicates that the
remainder of the line is a comment when found as the first
character of a word, usually ‘#’. The history comment character
disables history substitution for the remaining words on the line.
It does not necessarily cause the shell parser to treat the rest of
the line as a comment.
‘HISTCMD’
The history number, or index in the history list, of the current
@@ -6577,7 +6583,7 @@ conforming to the POSIX standard as well.
When invoked as an interactive login shell, or as a non-interactive
shell with the ‘--login’ option, it first attempts to read and execute
commands from ‘/etc/profile’ and ‘~/.profile’, in that order. The
‘--noprofile’ option may be used to inhibit this behavior.
‘--noprofile’ option will inhibit this behavior.
When invoked as an interactive shell with the name ‘sh’, Bash looks
for the variable ‘ENV’, expands its value if it is defined, and uses the
@@ -6588,8 +6594,8 @@ other startup files, the ‘--rcfile’ option has no effect.
A non-interactive shell invoked with the name ‘sh’ does not attempt
to read any other startup files.
When invoked as ‘sh’, Bash enters POSIX mode after the startup files
are read.
When invoked as ‘sh’, Bash enters POSIX mode after reading the
startup files.
Invoked in POSIX mode
.....................
@@ -6609,10 +6615,10 @@ and rarely-seen remote shell daemon, usually ‘rshd’, or the secure shell
daemon ‘sshd’. If Bash determines it is being run non-interactively in
this fashion, it reads and executes commands from ‘~/.bashrc’, if that
file exists and is readable. It will not do this if invoked as ‘sh’.
The ‘--norc’ option may be used to inhibit this behavior, and the
‘--rcfile’ option will make Bash use a different file instead of
‘~/.bashrc’, but neither ‘rshd’ nor ‘sshd’ generally invoke the shell
with those options or allow them to be specified.
The ‘--norc’ option will inhibit this behavior, and the ‘--rcfile’
option will make Bash use a different file instead of ‘~/.bashrc’, but
neither ‘rshd’ nor ‘sshd’ generally invoke the shell with those options
or allow them to be specified.
Invoked with unequal effective and real UID/GIDs
................................................
@@ -6786,10 +6792,10 @@ numeric, and file attribute comparisons.
expressions. If the operating system on which Bash is running provides
these special files, Bash will use them; otherwise it will emulate them
internally with this behavior: If the FILE argument to one of the
primaries is of the form ‘/dev/fd/N’, then file descriptor N is checked.
If the FILE argument to one of the primaries is one of ‘/dev/stdin’,
‘/dev/stdout’, or ‘/dev/stderr’, file descriptor 0, 1, or 2,
respectively, is checked.
primaries is of the form ‘/dev/fd/N’, then Bash checks file descriptor
N. If the FILE argument to one of the primaries is one of ‘/dev/stdin’,
‘/dev/stdout’, or ‘/dev/stderr’, Bash checks file descriptor 0, 1, or 2,
respectively.
When used with ‘[[’, the ‘<’ and ‘>’ operators sort lexicographically
using the current locale. The ‘test’ command uses ASCII ordering.
@@ -6996,9 +7002,9 @@ levels are listed in order of decreasing precedence.
Shell variables are allowed as operands; parameter expansion is
performed before the expression is evaluated. Within an expression,
shell variables may also be referenced by name without using the
parameter expansion syntax. This means you can use .Q x , where \fIx\fP
is a shell variable name, in an arithmetic expression, and the shell
will evaluate its value as an expression and use the result. A shell
parameter expansion syntax. This means you can use X, where X is a
shell variable name, in an arithmetic expression, and the shell will
evaluate its value as an expression and use the result. A shell
variable that is null or unset evaluates to 0 when referenced by name in
an expression.
@@ -7662,6 +7668,9 @@ startup files.
27. Bash permanently removes jobs from the jobs table after notifying
the user of their termination via the ‘wait’ or ‘jobs’ builtins.
It removes the job from the jobs list after notifying the user of
its termination, but the status is still available via ‘wait’, as
long as ‘wait’ is supplied a PID argument.
28. The ‘vi’ editing mode will invoke the ‘vi’ editor directly when
the ‘v’ command is run, instead of checking ‘$VISUAL’ and
@@ -7854,7 +7863,7 @@ startup files.
The trap command is run once for each child that exits.
75. Bash removes an exited background process's status from the list
of such statuses after the ‘wait’ builtin is used to obtain it.
of such statuses after the ‘wait’ builtin returns it.
There is other POSIX behavior that Bash does not implement by default
even when in POSIX mode. Specifically:
@@ -7997,13 +8006,13 @@ required for bash-5.1 and later versions.
like ‘a[@]’. Bash-5.2 will unset an element with key ‘@’
(associative arrays) or remove all the elements without
unsetting the array (indexed arrays).
• Arithmetic commands ( ((...)) ) and the expressions in an
• Arithmetic commands ( ((...)) ) and the expressions in an
arithmetic for statement can be expanded more than once.
• Expressions used as arguments to arithmetic operators in the
‘[[’ conditional command can be expanded more than once.
• The expressions in substring parameter brace expansion can be
expanded more than once.
• The expressions in the $(( ... )) word expansion can be
• The expressions in the $(( ... )) word expansion can be
expanded more than once.
• Arithmetic expressions used as indexed array subscripts can be
expanded more than once.
@@ -8141,7 +8150,7 @@ 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
status changes immediately (*note The Set Builtin::). Bash executes any
trap on ‘SIGCHLD’ for each child process that terminates.
When a job terminates and Bash notifies the user about it, Bash
@@ -8377,27 +8386,26 @@ File: bash.info, Node: Introduction and Notation, Next: Readline Interaction,
8.1 Introduction to Line Editing
================================
The following paragraphs describe the notation used to represent
keystrokes.
The following paragraphs use Emacs style to describe the notation used
to represent keystrokes.
The text ‘C-k’ is read as 'Control-K' and describes the character
produced when the <k> key is pressed while the Control key is depressed.
The text ‘M-k’ is read as 'Meta-K' and describes the character
produced when the Meta key (if you have one) is depressed, and the <k>
key is pressed (a “meta character”). The Meta key is labeled <ALT> on
many keyboards. On keyboards with two keys labeled <ALT> (usually to
either side of the space bar), the <ALT> on the left side is generally
set to work as a Meta key. The <ALT> key on the right may also be
configured to work as a Meta key or may be configured as some other
modifier, such as a Compose key for typing accented characters.
key is pressed (a “meta character”), then both are released. The Meta
key is labeled <ALT> or <Option> on many keyboards. On keyboards with
two keys labeled <ALT> (usually to either side of the space bar), the
<ALT> on the left side is generally set to work as a Meta key. One of
the <ALT> keys may also be configured as some other modifier, such as a
Compose key for typing accented characters.
On some keyboards, the Meta key modifier produces meta characters
with the eighth bit (0200) set. You can use the ‘enable-meta-key’
variable to control whether or not it does this, if the keyboard allows
it. On many others, the terminal or terminal emulator converts the
metafied key to a key sequence beginning with <ESC> as described in the
next paragraph.
On some keyboards, the Meta key modifier produces characters with the
eighth bit (0200) set. You can use the ‘enable-meta-key’ variable to
control whether or not it does this, if the keyboard allows it. On many
others, the terminal or terminal emulator converts the metafied key to a
key sequence beginning with <ESC> as described in the next paragraph.
If you do not have a Meta or <ALT> key, or another key working as a
Meta key, you can generally achieve the latter effect by typing <ESC>
@@ -8642,7 +8650,7 @@ keybindings. Any user can customize programs that use Readline by
putting commands in an “inputrc” file, conventionally in their home
directory. The name of this file is taken from the value of the shell
variable ‘INPUTRC’. If that variable is unset, the default is
‘~/.inputrc’. If that file does not exist or cannot be read, readline
‘~/.inputrc’. If that file does not exist or cannot be read, Readline
looks for ‘/etc/inputrc’. The ‘bind’ builtin command can also be used
to set Readline keybindings and variables. *Note Bash Builtins::.
@@ -8747,9 +8755,9 @@ Variable Settings
different color. The color definitions are taken from the
value of the ‘LS_COLORS’ environment variable. If there is a
color definition in ‘LS_COLORS’ for the custom suffix
‘readline-colored-completion-prefix’, Readline uses this color
for the common prefix instead of its default. The default is
‘off’.
‘.readline-colored-completion-prefix’, Readline uses this
color for the common prefix instead of its default. The
default is ‘off’.
‘colored-stats’
If set to ‘on’, Readline displays possible completions using
@@ -8782,7 +8790,7 @@ Variable Settings
‘completion-prefix-display-length’
The maximum length in characters of the common prefix of a
list of possible completions that is displayed without
modification. When set to a value greater than zero, readline
modification. When set to a value greater than zero, Readline
replaces common prefixes longer than this value with an
ellipsis when displaying possible completions.
@@ -8881,7 +8889,7 @@ Variable Settings
key sequences containing ‘\M-’ or ‘Meta-’ (see ‘Key Bindings’
in *note Readline Init File Syntax::) by converting a key
sequence of the form ‘\M-’C or ‘Meta-’C to the two-character
sequence ‘ESC’C (adding the meta prefix). If
sequence ‘ESC’ C (adding the meta prefix). If
‘force-meta-prefix’ is set to ‘off’ (the default), Readline
uses the value of the ‘convert-meta’ variable to determine
whether to perform this conversion: if ‘convert-meta’ is ‘on’,
@@ -9042,7 +9050,7 @@ Variable Settings
If set to ‘on’, this alters the default completion behavior
when inserting a single match into the line. It's only active
when performing completion in the middle of a word. If
enabled, readline does not insert characters from the
enabled, Readline does not insert characters from the
completion that match characters after point in the word being
completed, so portions of the word following the cursor are
not duplicated. For instance, if this is enabled, attempting
@@ -9416,9 +9424,10 @@ sequence are unbound by default.
position, and “mark” refers to a cursor position saved by the ‘set-mark’
command. The text between the point and mark is referred to as the
“region”. Readline has the concept of an _active region_: when the
region is active, Readline redisplay uses the value of the
‘active-region-start-color’ variable to denote the region. Several
commands set the region to active; those are noted below.
region is active, Readline redisplay highlights the region using the
value of the ‘active-region-start-color’ variable. The
‘enable-active-region’ variable turns this on and off. Several commands
set the region to active; those are noted below.

File: bash.info, Node: Commands For Moving, Next: Commands For History, Up: Bindable Readline Commands
@@ -10004,7 +10013,7 @@ File: bash.info, Node: Miscellaneous Commands, Prev: Keyboard Macros, Up: Bin
default.
‘execute-named-command (M-x)’
Read a bindable readline command name from the input and execute
Read a bindable Readline command name from the input and execute
the function to which it's bound, as if the key sequence to which
it was bound appeared in the input. If this function is supplied
with a numeric argument, it passes that argument to the function it
@@ -10093,7 +10102,7 @@ File: bash.info, Node: Programmable Completion, Next: Programmable Completion
When the user attempts word completion for an argument to a command for
which a completion specification (a “compspec”) has been defined using
the ‘complete’ builtin (*note Programmable Completion Builtins::),
\fBreadline\fP invokes the programmable completion facilities.
Readline invokes the programmable completion facilities.
First, Bash identifies the command name. If a compspec has been
defined for that command, the compspec is used to generate the list of
@@ -10494,7 +10503,7 @@ happening.
other supplied options should apply to "empty" command completion;
and the ‘-I’ option indicates that other supplied options should
apply to completion on the initial word on the line. These are
determined in the same way as the \fBcomplete\fP builtin.
determined in the same way as the ‘complete’ builtin.
If multiple options are supplied, the ‘-D’ option takes precedence
over ‘-E’, and both take precedence over ‘-I’
@@ -11254,7 +11263,7 @@ you want the object files and executables to go and run the ‘configure’
script from the source directory (*note Basic Installation::). You may
need to supply the ‘--srcdir=PATH’ argument to tell ‘configure’ where
the source files are. ‘configure’ automatically checks for the source
code in the directory that ‘configure’ is in and in '..'.
code in the directory that ‘configure’ is in and in ‘..’.
If you have to use a ‘make’ that does not support the ‘VPATH’
variable, you can compile Bash for one architecture at a time in the
@@ -12645,7 +12654,7 @@ D.1 Index of Shell Builtin Commands
* .: Bourne Shell Builtins.
(line 17)
* [: Bourne Shell Builtins.
(line 333)
(line 337)
* alias: Bash Builtins. (line 11)
* bg: Job Control Builtins.
(line 7)
@@ -12664,7 +12673,7 @@ D.1 Index of Shell Builtin Commands
* compopt: Programmable Completion Builtins.
(line 257)
* continue: Bourne Shell Builtins.
(line 102)
(line 106)
* declare: Bash Builtins. (line 179)
* dirs: Directory Stack Builtins.
(line 7)
@@ -12673,23 +12682,23 @@ D.1 Index of Shell Builtin Commands
* echo: Bash Builtins. (line 284)
* enable: Bash Builtins. (line 337)
* eval: Bourne Shell Builtins.
(line 111)
(line 115)
* exec: Bourne Shell Builtins.
(line 119)
(line 123)
* exit: Bourne Shell Builtins.
(line 141)
(line 145)
* export: Bourne Shell Builtins.
(line 148)
(line 152)
* false: Bourne Shell Builtins.
(line 170)
(line 174)
* fc: Bash History Builtins.
(line 10)
* fg: Job Control Builtins.
(line 17)
* getopts: Bourne Shell Builtins.
(line 175)
(line 179)
* hash: Bourne Shell Builtins.
(line 226)
(line 230)
* help: Bash Builtins. (line 374)
* history: Bash History Builtins.
(line 59)
@@ -12707,36 +12716,36 @@ D.1 Index of Shell Builtin Commands
* pushd: Directory Stack Builtins.
(line 70)
* pwd: Bourne Shell Builtins.
(line 258)
(line 262)
* read: Bash Builtins. (line 548)
* readarray: Bash Builtins. (line 659)
* readonly: Bourne Shell Builtins.
(line 270)
(line 274)
* return: Bourne Shell Builtins.
(line 295)
(line 299)
* set: The Set Builtin. (line 11)
* shift: Bourne Shell Builtins.
(line 320)
(line 324)
* shopt: The Shopt Builtin. (line 9)
* source: Bash Builtins. (line 668)
* suspend: Job Control Builtins.
(line 139)
* test: Bourne Shell Builtins.
(line 333)
(line 337)
* times: Bourne Shell Builtins.
(line 433)
(line 437)
* trap: Bourne Shell Builtins.
(line 439)
(line 443)
* true: Bourne Shell Builtins.
(line 505)
(line 509)
* type: Bash Builtins. (line 673)
* typeset: Bash Builtins. (line 710)
* ulimit: Bash Builtins. (line 716)
* umask: Bourne Shell Builtins.
(line 510)
(line 514)
* unalias: Bash Builtins. (line 824)
* unset: Bourne Shell Builtins.
(line 528)
(line 532)
* wait: Job Control Builtins.
(line 86)
@@ -12907,57 +12916,57 @@ D.3 Parameter and Variable Index
* FUNCNEST: Bash Variables. (line 363)
* GLOBIGNORE: Bash Variables. (line 368)
* GLOBSORT: Bash Variables. (line 375)
* GROUPS: Bash Variables. (line 410)
* histchars: Bash Variables. (line 416)
* HISTCMD: Bash Variables. (line 431)
* HISTCONTROL: Bash Variables. (line 437)
* HISTFILE: Bash Variables. (line 455)
* HISTFILESIZE: Bash Variables. (line 461)
* HISTIGNORE: Bash Variables. (line 472)
* GROUPS: Bash Variables. (line 413)
* histchars: Bash Variables. (line 419)
* HISTCMD: Bash Variables. (line 433)
* HISTCONTROL: Bash Variables. (line 439)
* HISTFILE: Bash Variables. (line 457)
* HISTFILESIZE: Bash Variables. (line 463)
* HISTIGNORE: Bash Variables. (line 474)
* history-preserve-point: Readline Init File Syntax.
(line 232)
* history-size: Readline Init File Syntax.
(line 238)
* HISTSIZE: Bash Variables. (line 496)
* HISTTIMEFORMAT: Bash Variables. (line 503)
* HISTSIZE: Bash Variables. (line 498)
* HISTTIMEFORMAT: Bash Variables. (line 505)
* HOME: Bourne Shell Variables.
(line 13)
* horizontal-scroll-mode: Readline Init File Syntax.
(line 248)
* HOSTFILE: Bash Variables. (line 512)
* HOSTNAME: Bash Variables. (line 523)
* HOSTTYPE: Bash Variables. (line 526)
* HOSTFILE: Bash Variables. (line 514)
* HOSTNAME: Bash Variables. (line 525)
* HOSTTYPE: Bash Variables. (line 528)
* IFS: Bourne Shell Variables.
(line 18)
* IGNOREEOF: Bash Variables. (line 529)
* IGNOREEOF: Bash Variables. (line 531)
* input-meta: Readline Init File Syntax.
(line 256)
* INPUTRC: Bash Variables. (line 538)
* INSIDE_EMACS: Bash Variables. (line 542)
* INPUTRC: Bash Variables. (line 540)
* INSIDE_EMACS: Bash Variables. (line 544)
* isearch-terminators: Readline Init File Syntax.
(line 267)
* keymap: Readline Init File Syntax.
(line 274)
* LANG: Creating Internationalized Scripts.
(line 51)
* LANG <1>: Bash Variables. (line 548)
* LC_ALL: Bash Variables. (line 552)
* LC_COLLATE: Bash Variables. (line 556)
* LC_CTYPE: Bash Variables. (line 563)
* LANG <1>: Bash Variables. (line 550)
* LC_ALL: Bash Variables. (line 554)
* LC_COLLATE: Bash Variables. (line 558)
* LC_CTYPE: Bash Variables. (line 565)
* LC_MESSAGES: Creating Internationalized Scripts.
(line 51)
* LC_MESSAGES <1>: Bash Variables. (line 568)
* LC_NUMERIC: Bash Variables. (line 572)
* LC_TIME: Bash Variables. (line 576)
* LINENO: Bash Variables. (line 580)
* LINES: Bash Variables. (line 587)
* MACHTYPE: Bash Variables. (line 593)
* LC_MESSAGES <1>: Bash Variables. (line 570)
* LC_NUMERIC: Bash Variables. (line 574)
* LC_TIME: Bash Variables. (line 578)
* LINENO: Bash Variables. (line 582)
* LINES: Bash Variables. (line 589)
* MACHTYPE: Bash Variables. (line 595)
* MAIL: Bourne Shell Variables.
(line 24)
* MAILCHECK: Bash Variables. (line 597)
* MAILCHECK: Bash Variables. (line 599)
* MAILPATH: Bourne Shell Variables.
(line 29)
* MAPFILE: Bash Variables. (line 605)
* MAPFILE: Bash Variables. (line 607)
* mark-modified-lines: Readline Init File Syntax.
(line 304)
* mark-symlinked-directories: Readline Init File Syntax.
@@ -12968,46 +12977,46 @@ D.3 Parameter and Variable Index
(line 321)
* meta-flag: Readline Init File Syntax.
(line 256)
* OLDPWD: Bash Variables. (line 609)
* OLDPWD: Bash Variables. (line 611)
* OPTARG: Bourne Shell Variables.
(line 36)
* OPTERR: Bash Variables. (line 612)
* OPTERR: Bash Variables. (line 614)
* OPTIND: Bourne Shell Variables.
(line 40)
* OSTYPE: Bash Variables. (line 617)
* OSTYPE: Bash Variables. (line 619)
* output-meta: Readline Init File Syntax.
(line 326)
* page-completions: Readline Init File Syntax.
(line 335)
* PATH: Bourne Shell Variables.
(line 44)
* PIPESTATUS: Bash Variables. (line 620)
* POSIXLY_CORRECT: Bash Variables. (line 626)
* PPID: Bash Variables. (line 636)
* PROMPT_COMMAND: Bash Variables. (line 640)
* PROMPT_DIRTRIM: Bash Variables. (line 646)
* PS0: Bash Variables. (line 652)
* PIPESTATUS: Bash Variables. (line 622)
* POSIXLY_CORRECT: Bash Variables. (line 628)
* PPID: Bash Variables. (line 638)
* PROMPT_COMMAND: Bash Variables. (line 642)
* PROMPT_DIRTRIM: Bash Variables. (line 648)
* PS0: Bash Variables. (line 654)
* PS1: Bourne Shell Variables.
(line 53)
* PS2: Bourne Shell Variables.
(line 58)
* PS3: Bash Variables. (line 657)
* PS4: Bash Variables. (line 662)
* PWD: Bash Variables. (line 670)
* RANDOM: Bash Variables. (line 673)
* READLINE_ARGUMENT: Bash Variables. (line 681)
* READLINE_LINE: Bash Variables. (line 685)
* READLINE_MARK: Bash Variables. (line 689)
* READLINE_POINT: Bash Variables. (line 695)
* REPLY: Bash Variables. (line 699)
* PS3: Bash Variables. (line 659)
* PS4: Bash Variables. (line 664)
* PWD: Bash Variables. (line 672)
* RANDOM: Bash Variables. (line 675)
* READLINE_ARGUMENT: Bash Variables. (line 683)
* READLINE_LINE: Bash Variables. (line 687)
* READLINE_MARK: Bash Variables. (line 691)
* READLINE_POINT: Bash Variables. (line 697)
* REPLY: Bash Variables. (line 701)
* revert-all-at-newline: Readline Init File Syntax.
(line 348)
* search-ignore-case: Readline Init File Syntax.
(line 355)
* SECONDS: Bash Variables. (line 703)
* SHELL: Bash Variables. (line 713)
* SHELLOPTS: Bash Variables. (line 718)
* SHLVL: Bash Variables. (line 727)
* SECONDS: Bash Variables. (line 705)
* SHELL: Bash Variables. (line 715)
* SHELLOPTS: Bash Variables. (line 720)
* SHLVL: Bash Variables. (line 729)
* show-all-if-ambiguous: Readline Init File Syntax.
(line 360)
* show-all-if-unmodified: Readline Init File Syntax.
@@ -13016,15 +13025,15 @@ D.3 Parameter and Variable Index
(line 375)
* skip-completed-text: Readline Init File Syntax.
(line 381)
* SRANDOM: Bash Variables. (line 732)
* SRANDOM: Bash Variables. (line 734)
* TEXTDOMAIN: Creating Internationalized Scripts.
(line 51)
* TEXTDOMAINDIR: Creating Internationalized Scripts.
(line 51)
* TIMEFORMAT: Bash Variables. (line 741)
* TMOUT: Bash Variables. (line 780)
* TMPDIR: Bash Variables. (line 792)
* UID: Bash Variables. (line 796)
* TIMEFORMAT: Bash Variables. (line 743)
* TMOUT: Bash Variables. (line 782)
* TMPDIR: Bash Variables. (line 794)
* UID: Bash Variables. (line 798)
* vi-cmd-mode-string: Readline Init File Syntax.
(line 394)
* vi-ins-mode-string: Readline Init File Syntax.
@@ -13458,97 +13467,97 @@ 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
Node: Quote Removal117765
Node: Redirections118069
Node: Executing Commands128278
Node: Simple Command Expansion128945
Node: Command Search and Execution131053
Node: Command Execution Environment133497
Node: Environment136945
Node: Exit Status138848
Node: Signals140906
Node: Shell Scripts144804
Node: Shell Builtin Commands148102
Node: Bourne Shell Builtins150213
Node: Bash Builtins176763
Node: Modifying Shell Behavior213211
Node: The Set Builtin213553
Node: The Shopt Builtin225489
Node: Special Builtins242541
Node: Shell Variables243530
Node: Bourne Shell Variables243964
Node: Bash Variables246472
Node: Bash Features284781
Node: Invoking Bash285795
Node: Bash Startup Files292221
Node: Interactive Shells297513
Node: What is an Interactive Shell?297921
Node: Is this Shell Interactive?298583
Node: Interactive Shell Behavior299407
Node: Bash Conditional Expressions303168
Node: Shell Arithmetic308387
Node: Aliases311716
Node: Arrays314851
Node: The Directory Stack321914
Node: Directory Stack Builtins322711
Node: Controlling the Prompt327156
Node: The Restricted Shell330040
Node: Bash POSIX Mode332922
Node: Shell Compatibility Mode351251
Node: Job Control360258
Node: Job Control Basics360715
Node: Job Control Builtins366993
Node: Job Control Variables373675
Node: Command Line Editing374906
Node: Introduction and Notation376609
Node: Readline Interaction378961
Node: Readline Bare Essentials380149
Node: Readline Movement Commands381957
Node: Readline Killing Commands382953
Node: Readline Arguments384976
Node: Searching386033
Node: Readline Init File388294
Node: Readline Init File Syntax389598
Node: Conditional Init Constructs416346
Node: Sample Init File420731
Node: Bindable Readline Commands423852
Node: Commands For Moving425390
Node: Commands For History427617
Node: Commands For Text432870
Node: Commands For Killing436995
Node: Numeric Arguments439783
Node: Commands For Completion440935
Node: Keyboard Macros445435
Node: Miscellaneous Commands446136
Node: Readline vi Mode452689
Node: Programmable Completion453666
Node: Programmable Completion Builtins461712
Node: A Programmable Completion Example473377
Node: Using History Interactively478722
Node: Bash History Facilities479403
Node: Bash History Builtins483138
Node: History Interaction489609
Node: Event Designators494563
Node: Word Designators496141
Node: Modifiers498449
Node: Installing Bash500390
Node: Basic Installation501506
Node: Compilers and Options505382
Node: Compiling For Multiple Architectures506132
Node: Installation Names507885
Node: Specifying the System Type510119
Node: Sharing Defaults510865
Node: Operation Controls511579
Node: Optional Features512598
Node: Reporting Bugs524978
Node: Major Differences From The Bourne Shell526336
Node: GNU Free Documentation License547756
Node: Indexes572933
Node: Builtin Index573384
Node: Reserved Word Index580482
Node: Variable Index582927
Node: Function Index600340
Node: Concept Index614196

End Tag Table
doc/bash.pdf
BIN
View File
Binary file not shown.
doc/bash.ps
+10402 -9785
View File
File diff suppressed because it is too large Load Diff
doc/bashref.dvi
BIN
View File
Binary file not shown.
doc/bashref.html
+84 -70
View File
@@ -4,9 +4,9 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This text is a brief description of the features that are present in
the Bash shell (version 5.3, 14 October 2024).
the Bash shell (version 5.3, 15 October 2024).
This is Edition 5.3, last updated 14 October 2024,
This is Edition 5.3, last updated 15 October 2024,
of The GNU Bash Reference Manual,
for Bash, Version 5.3.
@@ -77,10 +77,10 @@ Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Previou
<h1 class="top" id="Bash-Features-1"><span>Bash Features<a class="copiable-link" href="#Bash-Features-1"> &para;</a></span></h1>
<p>This text is a brief description of the features that are present in
the Bash shell (version 5.3, 14 October 2024).
the Bash shell (version 5.3, 15 October 2024).
The Bash home page is <a class="url" href="http://www.gnu.org/software/bash/">http://www.gnu.org/software/bash/</a>.
</p>
<p>This is Edition 5.3, last updated 14 October 2024,
<p>This is Edition 5.3, last updated 15 October 2024,
of <cite class="cite">The GNU Bash Reference Manual</cite>,
for <code class="code">Bash</code>, Version 5.3.
</p>
@@ -857,7 +857,7 @@ There are more details in the gettext documentation.
<a class="index-entry-id" id="index-internationalized-scripts"></a>
<a class="index-entry-id" id="index-string-translations"></a>
<p>Once you&rsquo;ve marked the strings in your script
that you want to translate using $&quot;...&quot;,
that you want to translate using $&quot;&hellip;&quot;,
you create a gettext &quot;template&quot; file using the command
</p>
<div class="example">
@@ -2615,7 +2615,8 @@ it introduces a level of indirection.
Bash uses the value formed by expanding the rest of
<var class="var">parameter</var> as the new <var class="var">parameter</var>;
this new parameter is then
expanded and that value is used in the rest of the expansion, rather
expanded and that value is used
in the rest of the expansion, rather
than the expansion of the original <var class="var">parameter</var>.
This is known as <code class="code">indirect expansion</code>.
The value is subject to tilde expansion,
@@ -3403,11 +3404,11 @@ without regard to the case of alphabetic characters.
<p>When a pattern is used for filename expansion, the character &lsquo;<samp class="samp">.</samp>&rsquo;
at the start of a filename or immediately following a slash
must be matched explicitly, unless the shell option <code class="code">dotglob</code> is set.
In order to match the filenames &lsquo;<samp class="samp">.</samp>&rsquo; and &lsquo;<samp class="samp">..</samp>&rsquo;,
In order to match the filenames <samp class="file">.</samp> and <samp class="file">..</samp>,
the pattern must begin with &lsquo;<samp class="samp">.</samp>&rsquo; (for example, &lsquo;<samp class="samp">.?</samp>&rsquo;),
even if <code class="code">dotglob</code> is set.
If the <code class="code">globskipdots</code> shell option is enabled, the filenames
&lsquo;<samp class="samp">.</samp>&rsquo; and &lsquo;<samp class="samp">..</samp>&rsquo; never match, even if the pattern begins
<samp class="file">.</samp> and <samp class="file">..</samp> never match, even if the pattern begins
with a &lsquo;<samp class="samp">.</samp>&rsquo;.
When not matching filenames, the &lsquo;<samp class="samp">.</samp>&rsquo; character is not treated specially.
</p>
@@ -3577,14 +3578,14 @@ patterns, including shell functions and command substitutions.
the set of filenames that are tested:
when <code class="code">dotglob</code> is enabled, the set of filenames includes all files
beginning with &lsquo;<samp class="samp">.</samp>&rsquo;, but the filenames
&lsquo;<samp class="samp">.</samp>&rsquo; and &lsquo;<samp class="samp">..</samp>&rsquo; must be matched by a
<samp class="file">.</samp> and <samp class="file">..</samp> must be matched by a
pattern or sub-pattern that begins with a dot;
when it is disabled, the set does not
include any filenames beginning with &ldquo;.&rdquo; unless the pattern
include any filenames beginning with &lsquo;<samp class="samp">.</samp>&rsquo; unless the pattern
or sub-pattern begins with a &lsquo;<samp class="samp">.</samp>&rsquo;.
If the <code class="code">globskipdots</code>
shell option is enabled, the filenames
&lsquo;<samp class="samp">.</samp>&rsquo; and &lsquo;<samp class="samp">..</samp>&rsquo;
<samp class="file">.</samp> and <samp class="file">..</samp>
never appear in the set.
As above, &lsquo;<samp class="samp">.</samp>&rsquo; only has a special meaning when matching filenames.
</p>
@@ -3656,7 +3657,7 @@ If the first character of the redirection operator
is &lsquo;<samp class="samp">&gt;</samp>&rsquo;, the redirection refers to the standard output (file
descriptor 1).
</p>
<p>The \fIword\fP following the redirection operator in the following
<p>The <var class="var">word</var> following the redirection operator in the following
descriptions, unless otherwise noted, is subjected to
brace expansion,
tilde expansion,
@@ -4585,37 +4586,43 @@ The return status is zero unless <var class="var">n</var> is not greater than or
</dd>
<dt><a id="index-cd"></a><span><code class="code">cd</code><a class="copiable-link" href="#index-cd"> &para;</a></span></dt>
<dd><div class="example">
<pre class="example-preformatted">cd [-L|[-P [-e]]] [-@] [<var class="var">directory</var>]
<pre class="example-preformatted">cd [-L] [-@] [<var class="var">directory</var>]
cd -P [-e] [-@] [<var class="var">directory</var>]
</pre></div>
<p>Change the current working directory to <var class="var">directory</var>.
If <var class="var">directory</var> is not supplied, the value of the <code class="env">HOME</code>
shell variable is used as <var class="var">directory</var>.
If the shell variable
<code class="env">CDPATH</code> exists, <code class="code">cd</code> uses it as a search path:
<code class="env">CDPATH</code> exists,
and <var class="var">directory</var> does not begin with a slash,
<code class="code">cd</code> uses it as a search path:
<code class="code">cd</code> searches each directory name in <code class="env">CDPATH</code> for
<var class="var">directory</var>, with alternative directory names in <code class="env">CDPATH</code>
separated by a colon (&lsquo;<samp class="samp">:</samp>&rsquo;).
A null directory name in <code class="env">CDPATH</code> means the same thing as the
current directory.
If <var class="var">directory</var> begins with a slash, <code class="env">CDPATH</code> is not used.
</p>
<p>The <samp class="option">-P</samp> option means to not follow symbolic links: symbolic links
<p>The <samp class="option">-P</samp> option means not to follow symbolic links: symbolic links
are resolved while <code class="code">cd</code> is traversing <var class="var">directory</var> and before
processing an instance of &lsquo;<samp class="samp">..</samp>&rsquo; in <var class="var">directory</var>.
processing an instance of <samp class="file">..</samp> in <var class="var">directory</var>.
</p>
<p>By default, or when the <samp class="option">-L</samp> option is supplied, symbolic links
in <var class="var">directory</var> are resolved after <code class="code">cd</code> processes an instance
of &lsquo;<samp class="samp">..</samp>&rsquo; in <var class="var">directory</var>.
of <samp class="file">..</samp> in <var class="var">directory</var>.
</p>
<p>If &lsquo;<samp class="samp">..</samp>&rsquo; appears in <var class="var">directory</var>, it is processed by removing the
<p>If <samp class="file">..</samp> appears in <var class="var">directory</var>, <code class="code">cd</code> processes it by removing the
immediately preceding pathname component, back to a slash or the beginning
of <var class="var">directory</var>.
of <var class="var">directory</var>,
and verifying that the portion of <var class="var">directory</var>
it has processed to
that point is still a valid directory name after removing the pathname
component.
If it is not a valid directory name, <code class="code">cd</code> returns a non-zero status.
</p>
<p>If the <samp class="option">-e</samp> option is supplied with <samp class="option">-P</samp>
and the current working directory cannot be successfully determined
after a successful directory change, <code class="code">cd</code> will return a non-zero
status.
and <code class="code">cd</code> cannot successfully determine the current working directory
after a successful directory change, it will return a non-zero status.
</p>
<p>On systems that support it, the <samp class="option">-@</samp> option presents the extended
attributes associated with a file as a directory.
@@ -6856,7 +6863,7 @@ if the directory name initially supplied does not exist.
<dt><code class="code">dotglob</code></dt>
<dd><p>If set, Bash includes filenames beginning with a &lsquo;<samp class="samp">.</samp>&rsquo; in
the results of filename expansion.
The filenames &lsquo;<samp class="samp">.</samp>&rsquo; and &lsquo;<samp class="samp">..</samp>&rsquo; must always be matched explicitly,
The filenames <samp class="file">.</samp> and <samp class="file">..</samp> must always be matched explicitly,
even if <code class="code">dotglob</code> is set.
</p>
</dd>
@@ -6943,7 +6950,7 @@ and upper-case and lower-case ASCII characters will collate together.
</dd>
<dt><code class="code">globskipdots</code></dt>
<dd><p>If set, filename expansion will never match the filenames
&lsquo;<samp class="samp">.</samp>&rsquo; and &lsquo;<samp class="samp">..</samp>&rsquo;, even if the pattern begins with a &lsquo;<samp class="samp">.</samp>&rsquo;.
<samp class="file">.</samp> and <samp class="file">..</samp>, even if the pattern begins with a &lsquo;<samp class="samp">.</samp>&rsquo;.
This option is enabled by default.
</p>
</dd>
@@ -7061,7 +7068,7 @@ or when filtering possible completions as part of programmable completion.
</dd>
<dt><code class="code">noexpand_translation</code></dt>
<dd><p>If set, Bash
encloses the translated results of $&quot;...&quot; quoting in single quotes
encloses the translated results of $&quot;&hellip;&quot; quoting in single quotes
instead of double quotes.
If the string is not translated, this has no effect.
</p>
@@ -7677,7 +7684,7 @@ when an interactive shell is invoked in
</dd>
<dt><a id="index-EPOCHREALTIME"></a><span><code class="code">EPOCHREALTIME</code><a class="copiable-link" href="#index-EPOCHREALTIME"> &para;</a></span></dt>
<dd><p>Each time this parameter is referenced, it expands to the number of seconds
since the Unix Epoch as a floating point value with micro-second granularity
since the Unix Epoch as a floating-point value with micro-second granularity
(see the documentation for the C library function <code class="code">time</code> for the
definition of Epoch).
Assignments to <code class="env">EPOCHREALTIME</code> are ignored.
@@ -7773,8 +7780,11 @@ option.
The value of this variable specifies the sort criteria and sort order for
the results of filename expansion.
If this variable is unset or set to the null string, filename expansion
uses the historical behavior of sorting by name.
If set, a valid value begins with an optional &lsquo;<samp class="samp">+</samp>&rsquo;, which is ignored,
uses the historical behavior of sorting by name,
in ascending lexicographic order as determined by the
<code class="code">LC_COLLATE</code> shell variable.
</p>
<p>If set, a valid value begins with an optional &lsquo;<samp class="samp">+</samp>&rsquo;, which is ignored,
or &lsquo;<samp class="samp">-</samp>&rsquo;, which reverses the sort order from ascending to descending,
followed by a sort specifier.
The valid sort specifiers are
@@ -7797,14 +7807,15 @@ the same size), sorting uses the name as a secondary sort key.
order by modification time (newest first).
</p>
<p>The &lsquo;<samp class="samp">numeric</samp>&rsquo; specifier treats names consisting solely of digits as
numbers and sorts them using the numeric value (so &quot;2&quot; will sort before
&quot;10&quot;, for example).
numbers and sorts them using their numeric value
(so &quot;2&quot; will sort before &quot;10&quot;, for example).
When using &lsquo;<samp class="samp">numeric</samp>&rsquo;, names containing non-digits sort after all
the all-digit names and are sorted by name using the traditional behavior.
</p>
<p>A sort specifier of &lsquo;<samp class="samp">nosort</samp>&rsquo; disables sorting completely; the results
are returned in the order they are read from the file system,
and any leading &lsquo;<samp class="samp">-</samp>&rsquo; is ignored.
<p>A sort specifier of &lsquo;<samp class="samp">nosort</samp>&rsquo; disables sorting completely;
Bash returns the results
in the order they are read from the file system,
ignoring any leading &lsquo;<samp class="samp">-</samp>&rsquo;.
</p>
<p>If the sort specifier is missing, it defaults to <var class="var">name</var>,
so a value of &lsquo;<samp class="samp">+</samp>&rsquo; is equivalent to the null string,
@@ -7826,8 +7837,8 @@ subsequently reset.
<dd><p>Up to three characters which control history expansion, quick
substitution, and tokenization (see <a class="pxref" href="#History-Interaction">History Expansion</a>).
The first character is the
<em class="dfn">history expansion</em> character, that is, the character which signifies the
start of a history expansion, normally &lsquo;<samp class="samp">!</samp>&rsquo;.
<em class="dfn">history expansion</em> character,
the character which begins a history expansion, normally &lsquo;<samp class="samp">!</samp>&rsquo;.
The second character is the
character which signifies &quot;quick substitution&quot; when seen as the first
character on a line, normally &lsquo;<samp class="samp">^</samp>&rsquo;.
@@ -7835,7 +7846,7 @@ The optional third character is the
character which indicates that the remainder of the line is a comment when
found as the first character of a word, usually &lsquo;<samp class="samp">#</samp>&rsquo;.
The history
comment character causes history substitution to be skipped for the
comment character disables history substitution for the
remaining words on the line.
It does not necessarily cause the shell
parser to treat the rest of the line as a comment.
@@ -8614,7 +8625,7 @@ possible, while conforming to the <small class="sc">POSIX</small> standard as we
shell with the <samp class="option">--login</samp> option, it first attempts to read
and execute commands from <samp class="file">/etc/profile</samp> and <samp class="file">~/.profile</samp>, in
that order.
The <samp class="option">--noprofile</samp> option may be used to inhibit this behavior.
The <samp class="option">--noprofile</samp> option will inhibit this behavior.
</p>
<p>When invoked as an interactive shell with the name <code class="code">sh</code>, Bash
looks for the variable <code class="env">ENV</code>, expands its value if it is defined,
@@ -8626,8 +8637,8 @@ no effect.
<p>A non-interactive shell invoked with the name <code class="code">sh</code> does not attempt
to read any other startup files.
</p>
<p>When invoked as <code class="code">sh</code>, Bash enters <small class="sc">POSIX</small> mode after
the startup files are read.
<p>When invoked as <code class="code">sh</code>, Bash enters <small class="sc">POSIX</small> mode after reading
the startup files.
</p>
<h4 class="subsubheading" id="Invoked-in-posix-mode"><span>Invoked in <small class="sc">POSIX</small> mode<a class="copiable-link" href="#Invoked-in-posix-mode"> &para;</a></span></h4>
@@ -8650,7 +8661,7 @@ determines it is being run non-interactively in this fashion,
it reads and executes commands from <samp class="file">~/.bashrc</samp>, if that
file exists and is readable.
It will not do this if invoked as <code class="code">sh</code>.
The <samp class="option">--norc</samp> option may be used to inhibit this behavior, and the
The <samp class="option">--norc</samp> option will inhibit this behavior, and the
<samp class="option">--rcfile</samp> option
will make Bash use a different file instead of
<samp class="file">~/.bashrc</samp>, but neither
@@ -8870,10 +8881,10 @@ If the operating system on which Bash is running provides these
special files, Bash will use them; otherwise it will emulate them
internally with this behavior:
If the <var class="var">file</var> argument to one of the primaries is of the form
<samp class="file">/dev/fd/<var class="var">N</var></samp>, then file descriptor <var class="var">N</var> is checked.
<samp class="file">/dev/fd/<var class="var">N</var></samp>, then Bash checks file descriptor <var class="var">N</var>.
If the <var class="var">file</var> argument to one of the primaries is one of
<samp class="file">/dev/stdin</samp>, <samp class="file">/dev/stdout</samp>, or <samp class="file">/dev/stderr</samp>, file
descriptor 0, 1, or 2, respectively, is checked.
<samp class="file">/dev/stdin</samp>, <samp class="file">/dev/stdout</samp>, or <samp class="file">/dev/stderr</samp>,
Bash checks file descriptor 0, 1, or 2, respectively.
</p>
<p>When used with <code class="code">[[</code>, the &lsquo;<samp class="samp">&lt;</samp>&rsquo; and &lsquo;<samp class="samp">&gt;</samp>&rsquo; operators sort
lexicographically using the current locale.
@@ -9161,9 +9172,8 @@ The levels are listed in order of decreasing precedence.
performed before the expression is evaluated.
Within an expression, shell variables may also be referenced by name
without using the parameter expansion syntax.
This means you can use
.Q x ,
where \fIx\fP is a shell variable name, in an arithmetic expression,
This means you can use <var class="var">x</var>,
where <var class="var">x</var> is a shell variable name, in an arithmetic expression,
and the shell will evaluate its value as an expression and use the
result.
A shell variable that is null or unset evaluates to 0 when referenced
@@ -10011,6 +10021,9 @@ completes.
</li><li> Bash permanently removes jobs from the jobs table after notifying the
user of their termination via the <code class="code">wait</code> or <code class="code">jobs</code> builtins.
It removes the job from the jobs list after notifying the user of its
termination, but the status is still available via <code class="code">wait</code>, as long
as <code class="code">wait</code> is supplied a <small class="sc">PID</small> argument.
</li><li> The <code class="code">vi</code> editing mode will invoke the <code class="code">vi</code> editor directly when
the &lsquo;<samp class="samp">v</samp>&rsquo; command is run, instead of checking <code class="code">$VISUAL</code> and
@@ -10210,7 +10223,7 @@ not interrupt the <code class="code">wait</code> builtin and cause it to return
The trap command is run once for each child that exits.
</li><li> Bash removes an exited background process&rsquo;s status from the list of such
statuses after the <code class="code">wait</code> builtin is used to obtain it.
statuses after the <code class="code">wait</code> builtin returns it.
</li></ol>
@@ -10397,13 +10410,13 @@ Bash-5.1 suppresses that message when the <samp class="option">-l</samp> option
&lsquo;<samp class="samp">a[@]</samp>&rsquo;.
Bash-5.2 will unset an element with key &lsquo;<samp class="samp">@</samp>&rsquo; (associative arrays)
or remove all the elements without unsetting the array (indexed arrays).
</li><li>Arithmetic commands ( ((...)) ) and the expressions in an arithmetic for
</li><li>Arithmetic commands ( ((&hellip;)) ) and the expressions in an arithmetic for
statement can be expanded more than once.
</li><li>Expressions used as arguments to arithmetic operators in the <code class="code">[[</code>
conditional command can be expanded more than once.
</li><li>The expressions in substring parameter brace expansion can be
expanded more than once.
</li><li>The expressions in the $(( ... )) word expansion can be expanded
</li><li>The expressions in the $(( &hellip; )) word expansion can be expanded
more than once.
</li><li>Arithmetic expressions used as indexed array subscripts can be
expanded more than once.
@@ -10592,7 +10605,7 @@ though it will notify of changes in a job&rsquo;s status after a
foreground command in
a list completes, before executing the next command in the list.
If the <samp class="option">-b</samp> option to the <code class="code">set</code> builtin is enabled,
Bash reports such changes immediately (see <a class="pxref" href="#The-Set-Builtin">The Set Builtin</a>).
Bash reports status changes immediately (see <a class="pxref" href="#The-Set-Builtin">The Set Builtin</a>).
Bash executes any trap on <code class="code">SIGCHLD</code>
for each child process that terminates.
</p>
@@ -10920,8 +10933,8 @@ Next: <a href="#Readline-Interaction" accesskey="n" rel="next">Readline Interact
</div>
<h3 class="section" id="Introduction-to-Line-Editing"><span>8.1 Introduction to Line Editing<a class="copiable-link" href="#Introduction-to-Line-Editing"> &para;</a></span></h3>
<p>The following paragraphs describe the notation used to represent
keystrokes.
<p>The following paragraphs use Emacs style to
describe the notation used to represent keystrokes.
</p>
<p>The text <kbd class="kbd">C-k</kbd> is read as &lsquo;Control-K&rsquo; and describes the character
produced when the <kbd class="key">k</kbd> key is pressed while the Control key
@@ -10929,16 +10942,16 @@ is depressed.
</p>
<p>The text <kbd class="kbd">M-k</kbd> is read as &lsquo;Meta-K&rsquo; and describes the character
produced when the Meta key (if you have one) is depressed, and the <kbd class="key">k</kbd>
key is pressed (a <em class="dfn">meta character</em>).
The Meta key is labeled <kbd class="key">ALT</kbd> on many keyboards.
key is pressed (a <em class="dfn">meta character</em>), then both are released.
The Meta key is labeled <kbd class="key">ALT</kbd> or <kbd class="key">Option</kbd> on many keyboards.
On keyboards with two keys labeled <kbd class="key">ALT</kbd> (usually to either side of
the space bar), the <kbd class="key">ALT</kbd> on the left side is generally set to
work as a Meta key.
The <kbd class="key">ALT</kbd> key on the right may also be configured to work as a
Meta key or may be configured as some other modifier, such as a
One of the <kbd class="key">ALT</kbd> keys may also be configured
as some other modifier, such as a
Compose key for typing accented characters.
</p>
<p>On some keyboards, the Meta key modifier produces meta characters with
<p>On some keyboards, the Meta key modifier produces characters with
the eighth bit (0200) set.
You can use the <code class="code">enable-meta-key</code> variable
to control whether or not it does this, if the keyboard allows it.
@@ -11270,7 +11283,7 @@ commands in an <em class="dfn">inputrc</em> file, conventionally in their home d
The name of this file is taken from the value of the
shell variable <code class="env">INPUTRC</code>.
If that variable is unset, the default is <samp class="file">~/.inputrc</samp>.
If that file does not exist or cannot be read, readline looks for
If that file does not exist or cannot be read, Readline looks for
<samp class="file">/etc/inputrc</samp>.
The <code class="code">bind</code><!-- /@w --> builtin command can also be used to set Readline
keybindings and variables.
@@ -11395,7 +11408,7 @@ common prefix of the set of possible completions using a different color.
The color definitions are taken from the value of the <code class="env">LS_COLORS</code>
environment variable.
If there is a color definition in <code class="env">LS_COLORS</code> for the custom suffix
&lsquo;<samp class="samp">readline-colored-completion-prefix</samp>&rsquo;, Readline uses this color for
&lsquo;<samp class="samp">.readline-colored-completion-prefix</samp>&rsquo;, Readline uses this color for
the common prefix instead of its default.
The default is &lsquo;<samp class="samp">off</samp>&rsquo;.
</p>
@@ -11440,7 +11453,7 @@ The default value is &lsquo;<samp class="samp">off</samp>&rsquo;.
<dd><p>The maximum
length in characters of the common prefix of a list of possible
completions that is displayed without modification.
When set to a value greater than zero, readline
When set to a value greater than zero, Readline
replaces common prefixes longer than this value
with an ellipsis when displaying possible completions.
</p>
@@ -11561,7 +11574,7 @@ sequences containing <kbd class="kbd">\M-</kbd> or <code class="code">Meta-</cod
(see <code class="code">Key Bindings</code> in <a class="ref" href="#Readline-Init-File-Syntax">Readline Init File Syntax</a>)
by converting a key sequence of the form
<kbd class="kbd">\M-</kbd><var class="var">C</var> or <code class="code">Meta-</code><var class="var">C</var> to the two-character sequence
<kbd class="kbd">ESC</kbd><var class="var">C</var> (adding the meta prefix).
<kbd class="kbd">ESC</kbd> <var class="var">C</var> (adding the meta prefix).
If <code class="code">force-meta-prefix</code> is set to &lsquo;<samp class="samp">off</samp>&rsquo; (the default),
Readline uses the value of the <code class="code">convert-meta</code> variable to determine
whether to perform this conversion:
@@ -11762,7 +11775,7 @@ The default value is &lsquo;<samp class="samp">off</samp>&rsquo;.
<dd><p>If set to &lsquo;<samp class="samp">on</samp>&rsquo;, this alters the default completion behavior when
inserting a single match into the line.
It&rsquo;s only active when performing completion in the middle of a word.
If enabled, readline does not insert characters from the completion
If enabled, Readline does not insert characters from the completion
that match characters after point in the word being completed,
so portions of the word following the cursor are not duplicated.
For instance, if this is enabled, attempting completion when the cursor
@@ -12232,9 +12245,10 @@ position, and <em class="dfn">mark</em> refers to a cursor position saved by the
<code class="code">set-mark</code> command.
The text between the point and mark is referred to as the <em class="dfn">region</em>.
Readline has the concept of an <em class="emph">active region</em>:
when the region is active, Readline redisplay uses the
value of the <code class="code">active-region-start-color</code> variable
to denote the region.
when the region is active,
Readline redisplay highlights the region using the
value of the <code class="code">active-region-start-color</code> variable.
The <code class="code">enable-active-region</code> variable turns this on and off.
Several commands set the region to active; those are noted below.
</p>
<ul class="mini-toc">
@@ -13022,7 +13036,7 @@ This command is unbound by default.
</p>
</dd>
<dt><a id="index-execute_002dnamed_002dcommand-_0028M_002dx_0029"></a><span><code class="code">execute-named-command (M-x)</code><a class="copiable-link" href="#index-execute_002dnamed_002dcommand-_0028M_002dx_0029"> &para;</a></span></dt>
<dd><p>Read a bindable readline command name from the input and execute the
<dd><p>Read a bindable Readline command name from the input and execute the
function to which it&rsquo;s bound, as if the key sequence to which it was
bound appeared in the input.
If this function is supplied with a numeric argument, it passes that
@@ -13144,7 +13158,7 @@ Next: <a href="#Programmable-Completion-Builtins" accesskey="n" rel="next">Progr
<p>When the user attempts word completion for an argument to a command for
which a completion specification (a <em class="dfn">compspec</em>) has been defined
using the <code class="code">complete</code> builtin (see <a class="pxref" href="#Programmable-Completion-Builtins">Programmable Completion Builtins</a>),
\fBreadline\fP invokes the programmable completion facilities.
Readline invokes the programmable completion facilities.
</p>
<p>First, Bash identifies the command name.
If a compspec has been defined for that command, the
@@ -13658,7 +13672,7 @@ the <samp class="option">-E</samp> option indicates that other supplied options
apply to &ldquo;empty&rdquo; command completion; and
the <samp class="option">-I</samp> option indicates that other supplied options should
apply to completion on the initial word on the line.
These are determined in the same way as the \fBcomplete\fP builtin.
These are determined in the same way as the <code class="code">complete</code> builtin.
</p>
<p>If multiple options are supplied, the <samp class="option">-D</samp> option takes precedence
over <samp class="option">-E</samp>, and both take precedence over <samp class="option">-I</samp>
@@ -14629,7 +14643,7 @@ You may need to
supply the <samp class="option">--srcdir=PATH</samp> argument to tell <code class="code">configure</code>
where the source files are.
<code class="code">configure</code> automatically checks for the
source code in the directory that <code class="code">configure</code> is in and in &lsquo;..&rsquo;.
source code in the directory that <code class="code">configure</code> is in and in <samp class="file">..</samp>.
</p>
<p>If you have to use a <code class="code">make</code> that does not support the <code class="code">VPATH</code>
variable, you can compile Bash for one architecture at a
doc/bashref.info
+263 -254
View File
@@ -2,9 +2,9 @@ This is bashref.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, 14 October 2024).
Bash shell (version 5.3, 15 October 2024).
This is Edition 5.3, last updated 14 October 2024, of ‘The GNU Bash
This is Edition 5.3, last updated 15 October 2024, of ‘The GNU Bash
Reference Manual’, for ‘Bash’, Version 5.3.
Copyright © 1988-2024 Free Software Foundation, Inc.
@@ -27,10 +27,10 @@ Bash Features
*************
This text is a brief description of the features that are present in the
Bash shell (version 5.3, 14 October 2024). The Bash home page is
Bash shell (version 5.3, 15 October 2024). The Bash home page is
<http://www.gnu.org/software/bash/>.
This is Edition 5.3, last updated 14 October 2024, of ‘The GNU Bash
This is Edition 5.3, last updated 15 October 2024, of ‘The GNU Bash
Reference Manual’, for ‘Bash’, Version 5.3.
Bash contains features that appear in other popular shells, and some
@@ -2620,7 +2620,7 @@ set of filenames that are tested: when ‘dotglob’ is enabled, the set of
filenames includes all files beginning with ‘.’, but the filenames ‘.’
and ‘..’ must be matched by a pattern or sub-pattern that begins with a
dot; when it is disabled, the set does not include any filenames
beginning with "." unless the pattern or sub-pattern begins with a ‘.’.
beginning with ‘.’ unless the pattern or sub-pattern begins with a ‘.’.
If the ‘globskipdots’ shell option is enabled, the filenames ‘.’ and
‘..’ never appear in the set. As above, ‘.’ only has a special meaning
when matching filenames.
@@ -2674,7 +2674,7 @@ redirection refers to the standard input (file descriptor 0). If the
first character of the redirection operator is ‘>’, the redirection
refers to the standard output (file descriptor 1).
The \fIword\fP following the redirection operator in the following
The WORD following the redirection operator in the following
descriptions, unless otherwise noted, is subjected to brace expansion,
tilde expansion, parameter and variable expansion, command substitution,
arithmetic expansion, quote removal, filename expansion, and word
@@ -3408,18 +3408,19 @@ standard.
greater than or equal to 1.
‘cd’
cd [-L|[-P [-e]]] [-@] [DIRECTORY]
cd [-L] [-@] [DIRECTORY]
cd -P [-e] [-@] [DIRECTORY]
Change the current working directory to DIRECTORY. If DIRECTORY is
not supplied, the value of the ‘HOME’ shell variable is used as
DIRECTORY. If the shell variable ‘CDPATH’ exists, ‘cd’ uses it as
a search path: ‘cd’ searches each directory name in ‘CDPATH’ for
DIRECTORY, with alternative directory names in ‘CDPATH’ separated
by a colon (‘:’). A null directory name in ‘CDPATH’ means the same
thing as the current directory. If DIRECTORY begins with a slash,
‘CDPATH’ is not used.
DIRECTORY. If the shell variable ‘CDPATH’ exists, and DIRECTORY
does not begin with a slash, ‘cd’ uses it as a search path: ‘cd’
searches each directory name in ‘CDPATH’ for DIRECTORY, with
alternative directory names in ‘CDPATH’ separated by a colon (‘:’).
A null directory name in ‘CDPATH’ means the same thing as the
current directory.
The ‘-P’ option means to not follow symbolic links: symbolic links
The ‘-P’ option means not to follow symbolic links: symbolic links
are resolved while ‘cd’ is traversing DIRECTORY and before
processing an instance of ‘..’ in DIRECTORY.
@@ -3427,13 +3428,16 @@ standard.
DIRECTORY are resolved after ‘cd’ processes an instance of ‘..’ in
DIRECTORY.
If ‘..’ appears in DIRECTORY, it is processed by removing the
If ‘..’ appears in DIRECTORY, ‘cd’ processes it by removing the
immediately preceding pathname component, back to a slash or the
beginning of DIRECTORY.
beginning of DIRECTORY, and verifying that the portion of DIRECTORY
it has processed to that point is still a valid directory name
after removing the pathname component. If it is not a valid
directory name, ‘cd’ returns a non-zero status.
If the ‘-e’ option is supplied with ‘-P’ and the current working
directory cannot be successfully determined after a successful
directory change, ‘cd’ will return a non-zero status.
If the ‘-e’ option is supplied with ‘-P’ and ‘cd’ cannot
successfully determine the current working directory after a
successful directory change, it will return a non-zero status.
On systems that support it, the ‘-@’ option presents the extended
attributes associated with a file as a directory.
@@ -5365,9 +5369,9 @@ This builtin allows you to change additional optional shell behavior.
completion.
‘noexpand_translation’
If set, Bash encloses the translated results of $"..."
quoting in single quotes instead of double quotes. If the
string is not translated, this has no effect.
If set, Bash encloses the translated results of $"..." quoting
in single quotes instead of double quotes. If the string is
not translated, this has no effect.
‘nullglob’
If set, filename expansion patterns which match no files
@@ -5841,7 +5845,7 @@ Variables::).
‘EPOCHREALTIME’
Each time this parameter is referenced, it expands to the number of
seconds since the Unix Epoch as a floating point value with
seconds since the Unix Epoch as a floating-point value with
micro-second granularity (see the documentation for the C library
function ‘time’ for the definition of Epoch). Assignments to
‘EPOCHREALTIME’ are ignored. If ‘EPOCHREALTIME’ is unset, it loses
@@ -5913,12 +5917,15 @@ Variables::).
value of this variable specifies the sort criteria and sort order
for the results of filename expansion. If this variable is unset
or set to the null string, filename expansion uses the historical
behavior of sorting by name. If set, a valid value begins with an
optional ‘+’, which is ignored, or ‘-’, which reverses the sort
order from ascending to descending, followed by a sort specifier.
The valid sort specifiers are ‘name’, ‘numeric’, ‘size’, ‘mtime’,
‘atime’, ‘ctime’, and ‘blocks’, which sort the files on name, names
in numeric rather than lexicographic order, file size, modification
behavior of sorting by name, in ascending lexicographic order as
determined by the ‘LC_COLLATE’ shell variable.
If set, a valid value begins with an optional ‘+’, which is
ignored, or ‘-’, which reverses the sort order from ascending to
descending, followed by a sort specifier. The valid sort
specifiers are ‘name’, ‘numeric’, ‘size’, ‘mtime’, ‘atime’,
‘ctime’, and ‘blocks’, which sort the files on name, names in
numeric rather than lexicographic order, file size, modification
time, access time, inode change time, and number of blocks,
respectively. If any of the non-name keys compare as equal (e.g.,
if two files are the same size), sorting uses the name as a
@@ -5928,14 +5935,14 @@ Variables::).
order by modification time (newest first).
The ‘numeric’ specifier treats names consisting solely of digits as
numbers and sorts them using the numeric value (so "2" will sort
numbers and sorts them using their numeric value (so "2" will sort
before "10", for example). When using ‘numeric’, names containing
non-digits sort after all the all-digit names and are sorted by
name using the traditional behavior.
A sort specifier of ‘nosort’ disables sorting completely; the
results are returned in the order they are read from the file
system, and any leading ‘-’ is ignored.
A sort specifier of ‘nosort’ disables sorting completely; Bash
returns the results in the order they are read from the file
system, ignoring any leading ‘-’.
If the sort specifier is missing, it defaults to NAME, so a value
of ‘+’ is equivalent to the null string, and a value of ‘-’ sorts
@@ -5952,17 +5959,16 @@ Variables::).
‘histchars’
Up to three characters which control history expansion, quick
substitution, and tokenization (*note History Interaction::). The
first character is the “history expansion” character, that is, the
character which signifies the start of a history expansion,
normally ‘!’. The second character is the character which
signifies "quick substitution" when seen as the first character on
a line, normally ‘^’. The optional third character is the
character which indicates that the remainder of the line is a
comment when found as the first character of a word, usually ‘#’.
The history comment character causes history substitution to be
skipped for the remaining words on the line. It does not
necessarily cause the shell parser to treat the rest of the line as
a comment.
first character is the “history expansion” character, the character
which begins a history expansion, normally ‘!’. The second
character is the character which signifies "quick substitution"
when seen as the first character on a line, normally ‘^’. The
optional third character is the character which indicates that the
remainder of the line is a comment when found as the first
character of a word, usually ‘#’. The history comment character
disables history substitution for the remaining words on the line.
It does not necessarily cause the shell parser to treat the rest of
the line as a comment.
‘HISTCMD’
The history number, or index in the history list, of the current
@@ -6578,7 +6584,7 @@ conforming to the POSIX standard as well.
When invoked as an interactive login shell, or as a non-interactive
shell with the ‘--login’ option, it first attempts to read and execute
commands from ‘/etc/profile’ and ‘~/.profile’, in that order. The
‘--noprofile’ option may be used to inhibit this behavior.
‘--noprofile’ option will inhibit this behavior.
When invoked as an interactive shell with the name ‘sh’, Bash looks
for the variable ‘ENV’, expands its value if it is defined, and uses the
@@ -6589,8 +6595,8 @@ other startup files, the ‘--rcfile’ option has no effect.
A non-interactive shell invoked with the name ‘sh’ does not attempt
to read any other startup files.
When invoked as ‘sh’, Bash enters POSIX mode after the startup files
are read.
When invoked as ‘sh’, Bash enters POSIX mode after reading the
startup files.
Invoked in POSIX mode
.....................
@@ -6610,10 +6616,10 @@ and rarely-seen remote shell daemon, usually ‘rshd’, or the secure shell
daemon ‘sshd’. If Bash determines it is being run non-interactively in
this fashion, it reads and executes commands from ‘~/.bashrc’, if that
file exists and is readable. It will not do this if invoked as ‘sh’.
The ‘--norc’ option may be used to inhibit this behavior, and the
‘--rcfile’ option will make Bash use a different file instead of
‘~/.bashrc’, but neither ‘rshd’ nor ‘sshd’ generally invoke the shell
with those options or allow them to be specified.
The ‘--norc’ option will inhibit this behavior, and the ‘--rcfile’
option will make Bash use a different file instead of ‘~/.bashrc’, but
neither ‘rshd’ nor ‘sshd’ generally invoke the shell with those options
or allow them to be specified.
Invoked with unequal effective and real UID/GIDs
................................................
@@ -6787,10 +6793,10 @@ numeric, and file attribute comparisons.
expressions. If the operating system on which Bash is running provides
these special files, Bash will use them; otherwise it will emulate them
internally with this behavior: If the FILE argument to one of the
primaries is of the form ‘/dev/fd/N’, then file descriptor N is checked.
If the FILE argument to one of the primaries is one of ‘/dev/stdin’,
‘/dev/stdout’, or ‘/dev/stderr’, file descriptor 0, 1, or 2,
respectively, is checked.
primaries is of the form ‘/dev/fd/N’, then Bash checks file descriptor
N. If the FILE argument to one of the primaries is one of ‘/dev/stdin’,
‘/dev/stdout’, or ‘/dev/stderr’, Bash checks file descriptor 0, 1, or 2,
respectively.
When used with ‘[[’, the ‘<’ and ‘>’ operators sort lexicographically
using the current locale. The ‘test’ command uses ASCII ordering.
@@ -6997,9 +7003,9 @@ levels are listed in order of decreasing precedence.
Shell variables are allowed as operands; parameter expansion is
performed before the expression is evaluated. Within an expression,
shell variables may also be referenced by name without using the
parameter expansion syntax. This means you can use .Q x , where \fIx\fP
is a shell variable name, in an arithmetic expression, and the shell
will evaluate its value as an expression and use the result. A shell
parameter expansion syntax. This means you can use X, where X is a
shell variable name, in an arithmetic expression, and the shell will
evaluate its value as an expression and use the result. A shell
variable that is null or unset evaluates to 0 when referenced by name in
an expression.
@@ -7663,6 +7669,9 @@ startup files.
27. Bash permanently removes jobs from the jobs table after notifying
the user of their termination via the ‘wait’ or ‘jobs’ builtins.
It removes the job from the jobs list after notifying the user of
its termination, but the status is still available via ‘wait’, as
long as ‘wait’ is supplied a PID argument.
28. The ‘vi’ editing mode will invoke the ‘vi’ editor directly when
the ‘v’ command is run, instead of checking ‘$VISUAL’ and
@@ -7855,7 +7864,7 @@ startup files.
The trap command is run once for each child that exits.
75. Bash removes an exited background process's status from the list
of such statuses after the ‘wait’ builtin is used to obtain it.
of such statuses after the ‘wait’ builtin returns it.
There is other POSIX behavior that Bash does not implement by default
even when in POSIX mode. Specifically:
@@ -7998,13 +8007,13 @@ required for bash-5.1 and later versions.
like ‘a[@]’. Bash-5.2 will unset an element with key ‘@’
(associative arrays) or remove all the elements without
unsetting the array (indexed arrays).
• Arithmetic commands ( ((...)) ) and the expressions in an
• Arithmetic commands ( ((...)) ) and the expressions in an
arithmetic for statement can be expanded more than once.
• Expressions used as arguments to arithmetic operators in the
‘[[’ conditional command can be expanded more than once.
• The expressions in substring parameter brace expansion can be
expanded more than once.
• The expressions in the $(( ... )) word expansion can be
• The expressions in the $(( ... )) word expansion can be
expanded more than once.
• Arithmetic expressions used as indexed array subscripts can be
expanded more than once.
@@ -8142,7 +8151,7 @@ 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
status changes immediately (*note The Set Builtin::). Bash executes any
trap on ‘SIGCHLD’ for each child process that terminates.
When a job terminates and Bash notifies the user about it, Bash
@@ -8378,27 +8387,26 @@ File: bashref.info, Node: Introduction and Notation, Next: Readline Interactio
8.1 Introduction to Line Editing
================================
The following paragraphs describe the notation used to represent
keystrokes.
The following paragraphs use Emacs style to describe the notation used
to represent keystrokes.
The text ‘C-k’ is read as 'Control-K' and describes the character
produced when the <k> key is pressed while the Control key is depressed.
The text ‘M-k’ is read as 'Meta-K' and describes the character
produced when the Meta key (if you have one) is depressed, and the <k>
key is pressed (a “meta character”). The Meta key is labeled <ALT> on
many keyboards. On keyboards with two keys labeled <ALT> (usually to
either side of the space bar), the <ALT> on the left side is generally
set to work as a Meta key. The <ALT> key on the right may also be
configured to work as a Meta key or may be configured as some other
modifier, such as a Compose key for typing accented characters.
key is pressed (a “meta character”), then both are released. The Meta
key is labeled <ALT> or <Option> on many keyboards. On keyboards with
two keys labeled <ALT> (usually to either side of the space bar), the
<ALT> on the left side is generally set to work as a Meta key. One of
the <ALT> keys may also be configured as some other modifier, such as a
Compose key for typing accented characters.
On some keyboards, the Meta key modifier produces meta characters
with the eighth bit (0200) set. You can use the ‘enable-meta-key’
variable to control whether or not it does this, if the keyboard allows
it. On many others, the terminal or terminal emulator converts the
metafied key to a key sequence beginning with <ESC> as described in the
next paragraph.
On some keyboards, the Meta key modifier produces characters with the
eighth bit (0200) set. You can use the ‘enable-meta-key’ variable to
control whether or not it does this, if the keyboard allows it. On many
others, the terminal or terminal emulator converts the metafied key to a
key sequence beginning with <ESC> as described in the next paragraph.
If you do not have a Meta or <ALT> key, or another key working as a
Meta key, you can generally achieve the latter effect by typing <ESC>
@@ -8643,7 +8651,7 @@ keybindings. Any user can customize programs that use Readline by
putting commands in an “inputrc” file, conventionally in their home
directory. The name of this file is taken from the value of the shell
variable ‘INPUTRC’. If that variable is unset, the default is
‘~/.inputrc’. If that file does not exist or cannot be read, readline
‘~/.inputrc’. If that file does not exist or cannot be read, Readline
looks for ‘/etc/inputrc’. The ‘bind’ builtin command can also be used
to set Readline keybindings and variables. *Note Bash Builtins::.
@@ -8748,9 +8756,9 @@ Variable Settings
different color. The color definitions are taken from the
value of the ‘LS_COLORS’ environment variable. If there is a
color definition in ‘LS_COLORS’ for the custom suffix
‘readline-colored-completion-prefix’, Readline uses this color
for the common prefix instead of its default. The default is
‘off’.
‘.readline-colored-completion-prefix’, Readline uses this
color for the common prefix instead of its default. The
default is ‘off’.
‘colored-stats’
If set to ‘on’, Readline displays possible completions using
@@ -8783,7 +8791,7 @@ Variable Settings
‘completion-prefix-display-length’
The maximum length in characters of the common prefix of a
list of possible completions that is displayed without
modification. When set to a value greater than zero, readline
modification. When set to a value greater than zero, Readline
replaces common prefixes longer than this value with an
ellipsis when displaying possible completions.
@@ -8882,7 +8890,7 @@ Variable Settings
key sequences containing ‘\M-’ or ‘Meta-’ (see ‘Key Bindings’
in *note Readline Init File Syntax::) by converting a key
sequence of the form ‘\M-’C or ‘Meta-’C to the two-character
sequence ‘ESC’C (adding the meta prefix). If
sequence ‘ESC’ C (adding the meta prefix). If
‘force-meta-prefix’ is set to ‘off’ (the default), Readline
uses the value of the ‘convert-meta’ variable to determine
whether to perform this conversion: if ‘convert-meta’ is ‘on’,
@@ -9043,7 +9051,7 @@ Variable Settings
If set to ‘on’, this alters the default completion behavior
when inserting a single match into the line. It's only active
when performing completion in the middle of a word. If
enabled, readline does not insert characters from the
enabled, Readline does not insert characters from the
completion that match characters after point in the word being
completed, so portions of the word following the cursor are
not duplicated. For instance, if this is enabled, attempting
@@ -9417,9 +9425,10 @@ sequence are unbound by default.
position, and “mark” refers to a cursor position saved by the ‘set-mark’
command. The text between the point and mark is referred to as the
“region”. Readline has the concept of an _active region_: when the
region is active, Readline redisplay uses the value of the
‘active-region-start-color’ variable to denote the region. Several
commands set the region to active; those are noted below.
region is active, Readline redisplay highlights the region using the
value of the ‘active-region-start-color’ variable. The
‘enable-active-region’ variable turns this on and off. Several commands
set the region to active; those are noted below.

File: bashref.info, Node: Commands For Moving, Next: Commands For History, Up: Bindable Readline Commands
@@ -10005,7 +10014,7 @@ File: bashref.info, Node: Miscellaneous Commands, Prev: Keyboard Macros, Up:
default.
‘execute-named-command (M-x)’
Read a bindable readline command name from the input and execute
Read a bindable Readline command name from the input and execute
the function to which it's bound, as if the key sequence to which
it was bound appeared in the input. If this function is supplied
with a numeric argument, it passes that argument to the function it
@@ -10094,7 +10103,7 @@ File: bashref.info, Node: Programmable Completion, Next: Programmable Completi
When the user attempts word completion for an argument to a command for
which a completion specification (a “compspec”) has been defined using
the ‘complete’ builtin (*note Programmable Completion Builtins::),
\fBreadline\fP invokes the programmable completion facilities.
Readline invokes the programmable completion facilities.
First, Bash identifies the command name. If a compspec has been
defined for that command, the compspec is used to generate the list of
@@ -10495,7 +10504,7 @@ happening.
other supplied options should apply to "empty" command completion;
and the ‘-I’ option indicates that other supplied options should
apply to completion on the initial word on the line. These are
determined in the same way as the \fBcomplete\fP builtin.
determined in the same way as the ‘complete’ builtin.
If multiple options are supplied, the ‘-D’ option takes precedence
over ‘-E’, and both take precedence over ‘-I’
@@ -11255,7 +11264,7 @@ you want the object files and executables to go and run the ‘configure’
script from the source directory (*note Basic Installation::). You may
need to supply the ‘--srcdir=PATH’ argument to tell ‘configure’ where
the source files are. ‘configure’ automatically checks for the source
code in the directory that ‘configure’ is in and in '..'.
code in the directory that ‘configure’ is in and in ‘..’.
If you have to use a ‘make’ that does not support the ‘VPATH’
variable, you can compile Bash for one architecture at a time in the
@@ -12646,7 +12655,7 @@ D.1 Index of Shell Builtin Commands
* .: Bourne Shell Builtins.
(line 17)
* [: Bourne Shell Builtins.
(line 333)
(line 337)
* alias: Bash Builtins. (line 11)
* bg: Job Control Builtins.
(line 7)
@@ -12665,7 +12674,7 @@ D.1 Index of Shell Builtin Commands
* compopt: Programmable Completion Builtins.
(line 257)
* continue: Bourne Shell Builtins.
(line 102)
(line 106)
* declare: Bash Builtins. (line 179)
* dirs: Directory Stack Builtins.
(line 7)
@@ -12674,23 +12683,23 @@ D.1 Index of Shell Builtin Commands
* echo: Bash Builtins. (line 284)
* enable: Bash Builtins. (line 337)
* eval: Bourne Shell Builtins.
(line 111)
(line 115)
* exec: Bourne Shell Builtins.
(line 119)
(line 123)
* exit: Bourne Shell Builtins.
(line 141)
(line 145)
* export: Bourne Shell Builtins.
(line 148)
(line 152)
* false: Bourne Shell Builtins.
(line 170)
(line 174)
* fc: Bash History Builtins.
(line 10)
* fg: Job Control Builtins.
(line 17)
* getopts: Bourne Shell Builtins.
(line 175)
(line 179)
* hash: Bourne Shell Builtins.
(line 226)
(line 230)
* help: Bash Builtins. (line 374)
* history: Bash History Builtins.
(line 59)
@@ -12708,36 +12717,36 @@ D.1 Index of Shell Builtin Commands
* pushd: Directory Stack Builtins.
(line 70)
* pwd: Bourne Shell Builtins.
(line 258)
(line 262)
* read: Bash Builtins. (line 548)
* readarray: Bash Builtins. (line 659)
* readonly: Bourne Shell Builtins.
(line 270)
(line 274)
* return: Bourne Shell Builtins.
(line 295)
(line 299)
* set: The Set Builtin. (line 11)
* shift: Bourne Shell Builtins.
(line 320)
(line 324)
* shopt: The Shopt Builtin. (line 9)
* source: Bash Builtins. (line 668)
* suspend: Job Control Builtins.
(line 139)
* test: Bourne Shell Builtins.
(line 333)
(line 337)
* times: Bourne Shell Builtins.
(line 433)
(line 437)
* trap: Bourne Shell Builtins.
(line 439)
(line 443)
* true: Bourne Shell Builtins.
(line 505)
(line 509)
* type: Bash Builtins. (line 673)
* typeset: Bash Builtins. (line 710)
* ulimit: Bash Builtins. (line 716)
* umask: Bourne Shell Builtins.
(line 510)
(line 514)
* unalias: Bash Builtins. (line 824)
* unset: Bourne Shell Builtins.
(line 528)
(line 532)
* wait: Job Control Builtins.
(line 86)
@@ -12908,57 +12917,57 @@ D.3 Parameter and Variable Index
* FUNCNEST: Bash Variables. (line 363)
* GLOBIGNORE: Bash Variables. (line 368)
* GLOBSORT: Bash Variables. (line 375)
* GROUPS: Bash Variables. (line 410)
* histchars: Bash Variables. (line 416)
* HISTCMD: Bash Variables. (line 431)
* HISTCONTROL: Bash Variables. (line 437)
* HISTFILE: Bash Variables. (line 455)
* HISTFILESIZE: Bash Variables. (line 461)
* HISTIGNORE: Bash Variables. (line 472)
* GROUPS: Bash Variables. (line 413)
* histchars: Bash Variables. (line 419)
* HISTCMD: Bash Variables. (line 433)
* HISTCONTROL: Bash Variables. (line 439)
* HISTFILE: Bash Variables. (line 457)
* HISTFILESIZE: Bash Variables. (line 463)
* HISTIGNORE: Bash Variables. (line 474)
* history-preserve-point: Readline Init File Syntax.
(line 232)
* history-size: Readline Init File Syntax.
(line 238)
* HISTSIZE: Bash Variables. (line 496)
* HISTTIMEFORMAT: Bash Variables. (line 503)
* HISTSIZE: Bash Variables. (line 498)
* HISTTIMEFORMAT: Bash Variables. (line 505)
* HOME: Bourne Shell Variables.
(line 13)
* horizontal-scroll-mode: Readline Init File Syntax.
(line 248)
* HOSTFILE: Bash Variables. (line 512)
* HOSTNAME: Bash Variables. (line 523)
* HOSTTYPE: Bash Variables. (line 526)
* HOSTFILE: Bash Variables. (line 514)
* HOSTNAME: Bash Variables. (line 525)
* HOSTTYPE: Bash Variables. (line 528)
* IFS: Bourne Shell Variables.
(line 18)
* IGNOREEOF: Bash Variables. (line 529)
* IGNOREEOF: Bash Variables. (line 531)
* input-meta: Readline Init File Syntax.
(line 256)
* INPUTRC: Bash Variables. (line 538)
* INSIDE_EMACS: Bash Variables. (line 542)
* INPUTRC: Bash Variables. (line 540)
* INSIDE_EMACS: Bash Variables. (line 544)
* isearch-terminators: Readline Init File Syntax.
(line 267)
* keymap: Readline Init File Syntax.
(line 274)
* LANG: Creating Internationalized Scripts.
(line 51)
* LANG <1>: Bash Variables. (line 548)
* LC_ALL: Bash Variables. (line 552)
* LC_COLLATE: Bash Variables. (line 556)
* LC_CTYPE: Bash Variables. (line 563)
* LANG <1>: Bash Variables. (line 550)
* LC_ALL: Bash Variables. (line 554)
* LC_COLLATE: Bash Variables. (line 558)
* LC_CTYPE: Bash Variables. (line 565)
* LC_MESSAGES: Creating Internationalized Scripts.
(line 51)
* LC_MESSAGES <1>: Bash Variables. (line 568)
* LC_NUMERIC: Bash Variables. (line 572)
* LC_TIME: Bash Variables. (line 576)
* LINENO: Bash Variables. (line 580)
* LINES: Bash Variables. (line 587)
* MACHTYPE: Bash Variables. (line 593)
* LC_MESSAGES <1>: Bash Variables. (line 570)
* LC_NUMERIC: Bash Variables. (line 574)
* LC_TIME: Bash Variables. (line 578)
* LINENO: Bash Variables. (line 582)
* LINES: Bash Variables. (line 589)
* MACHTYPE: Bash Variables. (line 595)
* MAIL: Bourne Shell Variables.
(line 24)
* MAILCHECK: Bash Variables. (line 597)
* MAILCHECK: Bash Variables. (line 599)
* MAILPATH: Bourne Shell Variables.
(line 29)
* MAPFILE: Bash Variables. (line 605)
* MAPFILE: Bash Variables. (line 607)
* mark-modified-lines: Readline Init File Syntax.
(line 304)
* mark-symlinked-directories: Readline Init File Syntax.
@@ -12969,46 +12978,46 @@ D.3 Parameter and Variable Index
(line 321)
* meta-flag: Readline Init File Syntax.
(line 256)
* OLDPWD: Bash Variables. (line 609)
* OLDPWD: Bash Variables. (line 611)
* OPTARG: Bourne Shell Variables.
(line 36)
* OPTERR: Bash Variables. (line 612)
* OPTERR: Bash Variables. (line 614)
* OPTIND: Bourne Shell Variables.
(line 40)
* OSTYPE: Bash Variables. (line 617)
* OSTYPE: Bash Variables. (line 619)
* output-meta: Readline Init File Syntax.
(line 326)
* page-completions: Readline Init File Syntax.
(line 335)
* PATH: Bourne Shell Variables.
(line 44)
* PIPESTATUS: Bash Variables. (line 620)
* POSIXLY_CORRECT: Bash Variables. (line 626)
* PPID: Bash Variables. (line 636)
* PROMPT_COMMAND: Bash Variables. (line 640)
* PROMPT_DIRTRIM: Bash Variables. (line 646)
* PS0: Bash Variables. (line 652)
* PIPESTATUS: Bash Variables. (line 622)
* POSIXLY_CORRECT: Bash Variables. (line 628)
* PPID: Bash Variables. (line 638)
* PROMPT_COMMAND: Bash Variables. (line 642)
* PROMPT_DIRTRIM: Bash Variables. (line 648)
* PS0: Bash Variables. (line 654)
* PS1: Bourne Shell Variables.
(line 53)
* PS2: Bourne Shell Variables.
(line 58)
* PS3: Bash Variables. (line 657)
* PS4: Bash Variables. (line 662)
* PWD: Bash Variables. (line 670)
* RANDOM: Bash Variables. (line 673)
* READLINE_ARGUMENT: Bash Variables. (line 681)
* READLINE_LINE: Bash Variables. (line 685)
* READLINE_MARK: Bash Variables. (line 689)
* READLINE_POINT: Bash Variables. (line 695)
* REPLY: Bash Variables. (line 699)
* PS3: Bash Variables. (line 659)
* PS4: Bash Variables. (line 664)
* PWD: Bash Variables. (line 672)
* RANDOM: Bash Variables. (line 675)
* READLINE_ARGUMENT: Bash Variables. (line 683)
* READLINE_LINE: Bash Variables. (line 687)
* READLINE_MARK: Bash Variables. (line 691)
* READLINE_POINT: Bash Variables. (line 697)
* REPLY: Bash Variables. (line 701)
* revert-all-at-newline: Readline Init File Syntax.
(line 348)
* search-ignore-case: Readline Init File Syntax.
(line 355)
* SECONDS: Bash Variables. (line 703)
* SHELL: Bash Variables. (line 713)
* SHELLOPTS: Bash Variables. (line 718)
* SHLVL: Bash Variables. (line 727)
* SECONDS: Bash Variables. (line 705)
* SHELL: Bash Variables. (line 715)
* SHELLOPTS: Bash Variables. (line 720)
* SHLVL: Bash Variables. (line 729)
* show-all-if-ambiguous: Readline Init File Syntax.
(line 360)
* show-all-if-unmodified: Readline Init File Syntax.
@@ -13017,15 +13026,15 @@ D.3 Parameter and Variable Index
(line 375)
* skip-completed-text: Readline Init File Syntax.
(line 381)
* SRANDOM: Bash Variables. (line 732)
* SRANDOM: Bash Variables. (line 734)
* TEXTDOMAIN: Creating Internationalized Scripts.
(line 51)
* TEXTDOMAINDIR: Creating Internationalized Scripts.
(line 51)
* TIMEFORMAT: Bash Variables. (line 741)
* TMOUT: Bash Variables. (line 780)
* TMPDIR: Bash Variables. (line 792)
* UID: Bash Variables. (line 796)
* TIMEFORMAT: Bash Variables. (line 743)
* TMOUT: Bash Variables. (line 782)
* TMPDIR: Bash Variables. (line 794)
* UID: Bash Variables. (line 798)
* vi-cmd-mode-string: Readline Init File Syntax.
(line 394)
* vi-ins-mode-string: Readline Init File Syntax.
@@ -13459,97 +13468,97 @@ Node: Process Substitution106061
Node: Word Splitting107180
Node: Filename Expansion109280
Node: Pattern Matching112551
Node: Quote Removal117888
Node: Redirections118195
Node: Executing Commands128413
Node: Simple Command Expansion129083
Node: Command Search and Execution131194
Node: Command Execution Environment133641
Node: Environment137092
Node: Exit Status138998
Node: Signals141059
Node: Shell Scripts144960
Node: Shell Builtin Commands148261
Node: Bourne Shell Builtins150375
Node: Bash Builtins176679
Node: Modifying Shell Behavior213130
Node: The Set Builtin213475
Node: The Shopt Builtin225414
Node: Special Builtins242469
Node: Shell Variables243461
Node: Bourne Shell Variables243898
Node: Bash Variables246409
Node: Bash Features284669
Node: Invoking Bash285686
Node: Bash Startup Files292115
Node: Interactive Shells297431
Node: What is an Interactive Shell?297842
Node: Is this Shell Interactive?298507
Node: Interactive Shell Behavior299334
Node: Bash Conditional Expressions303098
Node: Shell Arithmetic308318
Node: Aliases311660
Node: Arrays314798
Node: The Directory Stack321864
Node: Directory Stack Builtins322664
Node: Controlling the Prompt327112
Node: The Restricted Shell329999
Node: Bash POSIX Mode332884
Node: Shell Compatibility Mode351028
Node: Job Control360042
Node: Job Control Basics360502
Node: Job Control Builtins366781
Node: Job Control Variables373466
Node: Command Line Editing374700
Node: Introduction and Notation376406
Node: Readline Interaction378759
Node: Readline Bare Essentials379950
Node: Readline Movement Commands381761
Node: Readline Killing Commands382760
Node: Readline Arguments384786
Node: Searching385846
Node: Readline Init File388110
Node: Readline Init File Syntax389417
Node: Conditional Init Constructs416166
Node: Sample Init File420554
Node: Bindable Readline Commands423678
Node: Commands For Moving425153
Node: Commands For History427383
Node: Commands For Text432639
Node: Commands For Killing436767
Node: Numeric Arguments439558
Node: Commands For Completion440713
Node: Keyboard Macros445216
Node: Miscellaneous Commands445920
Node: Readline vi Mode452476
Node: Programmable Completion453456
Node: Programmable Completion Builtins461511
Node: A Programmable Completion Example473179
Node: Using History Interactively478527
Node: Bash History Facilities479211
Node: Bash History Builtins482949
Node: History Interaction489423
Node: Event Designators494380
Node: Word Designators495961
Node: Modifiers498272
Node: Installing Bash500216
Node: Basic Installation501335
Node: Compilers and Options505214
Node: Compiling For Multiple Architectures505967
Node: Installation Names507719
Node: Specifying the System Type509956
Node: Sharing Defaults510705
Node: Operation Controls511422
Node: Optional Features512444
Node: Reporting Bugs524827
Node: Major Differences From The Bourne Shell526188
Node: GNU Free Documentation License547611
Node: Indexes572791
Node: Builtin Index573245
Node: Reserved Word Index580346
Node: Variable Index582794
Node: Function Index600210
Node: Concept Index614069
Node: Quote Removal117891
Node: Redirections118198
Node: Executing Commands128410
Node: Simple Command Expansion129080
Node: Command Search and Execution131191
Node: Command Execution Environment133638
Node: Environment137089
Node: Exit Status138995
Node: Signals141056
Node: Shell Scripts144957
Node: Shell Builtin Commands148258
Node: Bourne Shell Builtins150372
Node: Bash Builtins176925
Node: Modifying Shell Behavior213376
Node: The Set Builtin213721
Node: The Shopt Builtin225660
Node: Special Builtins242715
Node: Shell Variables243707
Node: Bourne Shell Variables244144
Node: Bash Variables246655
Node: Bash Features284967
Node: Invoking Bash285984
Node: Bash Startup Files292413
Node: Interactive Shells297708
Node: What is an Interactive Shell?298119
Node: Is this Shell Interactive?298784
Node: Interactive Shell Behavior299611
Node: Bash Conditional Expressions303375
Node: Shell Arithmetic308597
Node: Aliases311929
Node: Arrays315067
Node: The Directory Stack322133
Node: Directory Stack Builtins322933
Node: Controlling the Prompt327381
Node: The Restricted Shell330268
Node: Bash POSIX Mode333153
Node: Shell Compatibility Mode351485
Node: Job Control360495
Node: Job Control Basics360955
Node: Job Control Builtins367236
Node: Job Control Variables373921
Node: Command Line Editing375155
Node: Introduction and Notation376861
Node: Readline Interaction379216
Node: Readline Bare Essentials380407
Node: Readline Movement Commands382218
Node: Readline Killing Commands383217
Node: Readline Arguments385243
Node: Searching386303
Node: Readline Init File388567
Node: Readline Init File Syntax389874
Node: Conditional Init Constructs416625
Node: Sample Init File421013
Node: Bindable Readline Commands424137
Node: Commands For Moving425678
Node: Commands For History427908
Node: Commands For Text433164
Node: Commands For Killing437292
Node: Numeric Arguments440083
Node: Commands For Completion441238
Node: Keyboard Macros445741
Node: Miscellaneous Commands446445
Node: Readline vi Mode453001
Node: Programmable Completion453981
Node: Programmable Completion Builtins462030
Node: A Programmable Completion Example473698
Node: Using History Interactively479046
Node: Bash History Facilities479730
Node: Bash History Builtins483468
Node: History Interaction489942
Node: Event Designators494899
Node: Word Designators496480
Node: Modifiers498791
Node: Installing Bash500735
Node: Basic Installation501854
Node: Compilers and Options505733
Node: Compiling For Multiple Architectures506486
Node: Installation Names508242
Node: Specifying the System Type510479
Node: Sharing Defaults511228
Node: Operation Controls511945
Node: Optional Features512967
Node: Reporting Bugs525350
Node: Major Differences From The Bourne Shell526711
Node: GNU Free Documentation License548134
Node: Indexes573314
Node: Builtin Index573768
Node: Reserved Word Index580869
Node: Variable Index583317
Node: Function Index600733
Node: Concept Index614592

End Tag Table
doc/bashref.log
+20 -20
View File
@@ -1,11 +1,11 @@
This is pdfTeX, Version 3.141592653-2.6-1.40.26 (TeX Live 2024/MacPorts 2024.70613_0) (preloaded format=pdfetex 2024.4.9) 14 OCT 2024 17:00
This is pdfTeX, Version 3.141592653-2.6-1.40.26 (TeX Live 2024/MacPorts 2024.70613_0) (preloaded format=pdfetex 2024.4.9) 18 OCT 2024 12:02
entering extended mode
restricted \write18 enabled.
file:line:error style messages enabled.
%&-line parsing enabled.
**\input /usr/local/src/bash/bash-20241012/doc/bashref.texi
(/usr/local/src/bash/bash-20241012/doc/bashref.texi
(/usr/local/src/bash/bash-20241012/doc/texinfo.tex
**\input /usr/local/src/bash/bash-20241015/doc/bashref.texi
(/usr/local/src/bash/bash-20241015/doc/bashref.texi
(/usr/local/src/bash/bash-20241015/doc/texinfo.tex
Loading texinfo [version 2015-11-22.14]:
\outerhsize=\dimen16
\outervsize=\dimen17
@@ -161,15 +161,15 @@ This is `epsf.tex' v2.7.4 <14 February 2011>
texinfo.tex: doing @include of version.texi
(/usr/local/src/bash/bash-20241012/doc/version.texi) [1{/opt/local/var/db/texmf
(/usr/local/src/bash/bash-20241015/doc/version.texi) [1{/opt/local/var/db/texmf
/fonts/map/pdftex/updmap/pdftex.map}] [2]
(/usr/local/build/bash/bash-20241012/doc/bashref.toc [-1] [-2] [-3]) [-4]
(/usr/local/build/bash/bash-20241012/doc/bashref.toc)
(/usr/local/build/bash/bash-20241012/doc/bashref.toc) Chapter 1
(/usr/local/build/bash/bash-20241015/doc/bashref.toc [-1] [-2] [-3]) [-4]
(/usr/local/build/bash/bash-20241015/doc/bashref.toc)
(/usr/local/build/bash/bash-20241015/doc/bashref.toc) Chapter 1
\openout0 = `bashref.toc'.
(/usr/local/build/bash/bash-20241012/doc/bashref.aux)
(/usr/local/build/bash/bash-20241015/doc/bashref.aux)
\openout1 = `bashref.aux'.
[1] Chapter 2 [2]
@@ -231,7 +231,7 @@ e/fonts/enc/dvips/cm-super/cm-super-t1.enc}] [20] [21] [22] [23] [24]
[50] [51] [52]
[53] [54] [55] [56] [57] [58] [59] [60] [61] [62] [63] [64] [65] [66] [67]
[68] [69] [70]
Overfull \hbox (38.26585pt too wide) in paragraph at lines 5703--5703
Overfull \hbox (38.26585pt too wide) in paragraph at lines 5710--5710
[]@texttt set [-abefhkmnptuvxBCEHPT] [-o @textttsl option-name@texttt ] [--] [
-] [@textttsl ar-gu-ment []@texttt ][]
@@ -244,7 +244,7 @@ Overfull \hbox (38.26585pt too wide) in paragraph at lines 5703--5703
.etc.
Overfull \hbox (38.26585pt too wide) in paragraph at lines 5704--5704
Overfull \hbox (38.26585pt too wide) in paragraph at lines 5711--5711
[]@texttt set [+abefhkmnptuvxBCEHPT] [+o @textttsl option-name@texttt ] [--] [
-] [@textttsl ar-gu-ment []@texttt ][]
@@ -264,7 +264,7 @@ Chapter 7 [122] [123] [124] [125] [126]
texinfo.tex: doing @include of rluser.texi
(/usr/local/src/bash/bash-20241012/lib/readline/doc/rluser.texi Chapter 8
(/usr/local/src/bash/bash-20241015/lib/readline/doc/rluser.texi Chapter 8
[127] [128] [129] [130] [131] [132] [133] [134] [135] [136] [137] [138]
Underfull \hbox (badness 7540) in paragraph at lines 959--965
[]@textrm In the ex-am-ple above, @textttsl C-u[] @textrm is bound to the func
@@ -313,10 +313,10 @@ gnored[]
texinfo.tex: doing @include of hsuser.texi
(/usr/local/src/bash/bash-20241012/lib/readline/doc/hsuser.texi Chapter 9
(/usr/local/src/bash/bash-20241015/lib/readline/doc/hsuser.texi Chapter 9
[164] [165] [166] [167] [168] [169] [170]) Chapter 10 [171] [172] [173]
[174] [175]
Underfull \hbox (badness 10000) in paragraph at lines 10347--10356
Underfull \hbox (badness 10000) in paragraph at lines 10360--10369
[]@textrm All of the fol-low-ing op-tions ex-cept for `@texttt alt-array-implem
entation[]@textrm '[],
@@ -329,7 +329,7 @@ entation[]@textrm '[],
.etc.
Underfull \hbox (badness 10000) in paragraph at lines 10347--10356
Underfull \hbox (badness 10000) in paragraph at lines 10360--10369
@textrm `@texttt disabled-builtins[]@textrm '[], `@texttt direxpand-default[]@t
extrm '[], `@texttt strict-posix-default[]@textrm '[], and
@@ -346,13 +346,13 @@ extrm '[], `@texttt strict-posix-default[]@textrm '[], and
texinfo.tex: doing @include of fdl.texi
(/usr/local/src/bash/bash-20241012/doc/fdl.texi [189] [190] [191] [192]
(/usr/local/src/bash/bash-20241015/doc/fdl.texi [189] [190] [191] [192]
[193] [194] [195]) Appendix D [196] [197] [198] [199] [200] [201] [202]
[203] [204] [205] )
Here is how much of TeX's memory you used:
4113 strings out of 495840
47653 string characters out of 6171739
144667 words of memory out of 5000000
144695 words of memory out of 5000000
5048 multiletter control sequences out of 15000+600000
34315 words of font info for 116 fonts, out of 8000000 for 9000
701 hyphenation exceptions out of 8191
@@ -373,10 +373,10 @@ fonts/type1/public/amsfonts/cm/cmti10.pfb></opt/local/share/texmf-texlive/fonts
lic/amsfonts/cm/cmtt9.pfb></opt/local/share/texmf-texlive/fonts/type1/public/cm
-super/sfrm1095.pfb></opt/local/share/texmf-texlive/fonts/type1/public/cm-super
/sfrm1440.pfb>
Output written on bashref.pdf (211 pages, 844363 bytes).
Output written on bashref.pdf (211 pages, 845003 bytes).
PDF statistics:
2923 PDF objects out of 2984 (max. 8388607)
2664 compressed objects within 27 object streams
2924 PDF objects out of 2984 (max. 8388607)
2665 compressed objects within 27 object streams
339 named destinations out of 1000 (max. 500000)
1157 words of extra memory for PDF output out of 10000 (max. 10000000)
doc/bashref.pdf
BIN
View File
Binary file not shown.
doc/bashref.ps
+1416 -1405
View File
File diff suppressed because it is too large Load Diff
doc/bashref.texi
+60 -47
View File
@@ -572,7 +572,7 @@ There are more details in the gettext documentation.
@cindex internationalized scripts
@cindex string translations
Once you've marked the strings in your script
that you want to translate using $"...",
that you want to translate using $"@dots{}",
you create a gettext "template" file using the command
@example
@@ -2212,7 +2212,8 @@ it introduces a level of indirection.
Bash uses the value formed by expanding the rest of
@var{parameter} as the new @var{parameter};
this new parameter is then
expanded and that value is used in the rest of the expansion, rather
expanded and that value is used
in the rest of the expansion, rather
than the expansion of the original @var{parameter}.
This is known as @code{indirect expansion}.
The value is subject to tilde expansion,
@@ -2966,11 +2967,11 @@ without regard to the case of alphabetic characters.
When a pattern is used for filename expansion, the character @samp{.}
at the start of a filename or immediately following a slash
must be matched explicitly, unless the shell option @code{dotglob} is set.
In order to match the filenames @samp{.} and @samp{..},
In order to match the filenames @file{.} and @file{..},
the pattern must begin with @samp{.} (for example, @samp{.?}),
even if @code{dotglob} is set.
If the @code{globskipdots} shell option is enabled, the filenames
@samp{.} and @samp{..} never match, even if the pattern begins
@file{.} and @file{..} never match, even if the pattern begins
with a @samp{.}.
When not matching filenames, the @samp{.} character is not treated specially.
@@ -3125,14 +3126,14 @@ When matching filenames, the @code{dotglob} shell option determines
the set of filenames that are tested:
when @code{dotglob} is enabled, the set of filenames includes all files
beginning with @samp{.}, but the filenames
@samp{.} and @samp{..} must be matched by a
@file{.} and @file{..} must be matched by a
pattern or sub-pattern that begins with a dot;
when it is disabled, the set does not
include any filenames beginning with ``.'' unless the pattern
include any filenames beginning with @samp{.} unless the pattern
or sub-pattern begins with a @samp{.}.
If the @code{globskipdots}
shell option is enabled, the filenames
@samp{.} and @samp{..}
@file{.} and @file{..}
never appear in the set.
As above, @samp{.} only has a special meaning when matching filenames.
@@ -3190,7 +3191,7 @@ If the first character of the redirection operator
is @samp{>}, the redirection refers to the standard output (file
descriptor 1).
The \fIword\fP following the redirection operator in the following
The @var{word} following the redirection operator in the following
descriptions, unless otherwise noted, is subjected to
brace expansion,
tilde expansion,
@@ -4069,37 +4070,43 @@ The return status is zero unless @var{n} is not greater than or equal to 1.
@item cd
@btindex cd
@example
cd [-L|[-P [-e]]] [-@@] [@var{directory}]
cd [-L] [-@@] [@var{directory}]
cd -P [-e] [-@@] [@var{directory}]
@end example
Change the current working directory to @var{directory}.
If @var{directory} is not supplied, the value of the @env{HOME}
shell variable is used as @var{directory}.
If the shell variable
@env{CDPATH} exists, @code{cd} uses it as a search path:
@env{CDPATH} exists,
and @var{directory} does not begin with a slash,
@code{cd} uses it as a search path:
@code{cd} searches each directory name in @env{CDPATH} for
@var{directory}, with alternative directory names in @env{CDPATH}
separated by a colon (@samp{:}).
A null directory name in @env{CDPATH} means the same thing as the
current directory.
If @var{directory} begins with a slash, @env{CDPATH} is not used.
The @option{-P} option means to not follow symbolic links: symbolic links
The @option{-P} option means not to follow symbolic links: symbolic links
are resolved while @code{cd} is traversing @var{directory} and before
processing an instance of @samp{..} in @var{directory}.
processing an instance of @file{..} in @var{directory}.
By default, or when the @option{-L} option is supplied, symbolic links
in @var{directory} are resolved after @code{cd} processes an instance
of @samp{..} in @var{directory}.
of @file{..} in @var{directory}.
If @samp{..} appears in @var{directory}, it is processed by removing the
If @file{..} appears in @var{directory}, @code{cd} processes it by removing the
immediately preceding pathname component, back to a slash or the beginning
of @var{directory}.
of @var{directory},
and verifying that the portion of @var{directory}
it has processed to
that point is still a valid directory name after removing the pathname
component.
If it is not a valid directory name, @code{cd} returns a non-zero status.
If the @option{-e} option is supplied with @option{-P}
and the current working directory cannot be successfully determined
after a successful directory change, @code{cd} will return a non-zero
status.
and @code{cd} cannot successfully determine the current working directory
after a successful directory change, it will return a non-zero status.
On systems that support it, the @option{-@@} option presents the extended
attributes associated with a file as a directory.
@@ -6171,7 +6178,7 @@ if the directory name initially supplied does not exist.
@item dotglob
If set, Bash includes filenames beginning with a @samp{.} in
the results of filename expansion.
The filenames @samp{.} and @samp{..} must always be matched explicitly,
The filenames @file{.} and @file{..} must always be matched explicitly,
even if @code{dotglob} is set.
@item execfail
@@ -6255,7 +6262,7 @@ and upper-case and lower-case ASCII characters will collate together.
@item globskipdots
If set, filename expansion will never match the filenames
@samp{.} and @samp{..}, even if the pattern begins with a @samp{.}.
@file{.} and @file{..}, even if the pattern begins with a @samp{.}.
This option is enabled by default.
@item globstar
@@ -6354,7 +6361,7 @@ or when filtering possible completions as part of programmable completion.
@item noexpand_translation
If set, Bash
encloses the translated results of $"..." quoting in single quotes
encloses the translated results of $"@dots{}" quoting in single quotes
instead of double quotes.
If the string is not translated, this has no effect.
@@ -6887,7 +6894,7 @@ when an interactive shell is invoked in
@item EPOCHREALTIME
Each time this parameter is referenced, it expands to the number of seconds
since the Unix Epoch as a floating point value with micro-second granularity
since the Unix Epoch as a floating-point value with micro-second granularity
(see the documentation for the C library function @code{time} for the
definition of Epoch).
Assignments to @env{EPOCHREALTIME} are ignored.
@@ -6974,7 +6981,10 @@ Controls how the results of filename expansion are sorted.
The value of this variable specifies the sort criteria and sort order for
the results of filename expansion.
If this variable is unset or set to the null string, filename expansion
uses the historical behavior of sorting by name.
uses the historical behavior of sorting by name,
in ascending lexicographic order as determined by the
@code{LC_COLLATE} shell variable.
If set, a valid value begins with an optional @samp{+}, which is ignored,
or @samp{-}, which reverses the sort order from ascending to descending,
followed by a sort specifier.
@@ -6998,14 +7008,15 @@ For example, a value of @code{-mtime} sorts the results in descending
order by modification time (newest first).
The @samp{numeric} specifier treats names consisting solely of digits as
numbers and sorts them using the numeric value (so "2" will sort before
"10", for example).
numbers and sorts them using their numeric value
(so "2" will sort before "10", for example).
When using @samp{numeric}, names containing non-digits sort after all
the all-digit names and are sorted by name using the traditional behavior.
A sort specifier of @samp{nosort} disables sorting completely; the results
are returned in the order they are read from the file system,
and any leading @samp{-} is ignored.
A sort specifier of @samp{nosort} disables sorting completely;
Bash returns the results
in the order they are read from the file system,
ignoring any leading @samp{-}.
If the sort specifier is missing, it defaults to @var{name},
so a value of @samp{+} is equivalent to the null string,
@@ -7025,8 +7036,8 @@ subsequently reset.
Up to three characters which control history expansion, quick
substitution, and tokenization (@pxref{History Interaction}).
The first character is the
@dfn{history expansion} character, that is, the character which signifies the
start of a history expansion, normally @samp{!}.
@dfn{history expansion} character,
the character which begins a history expansion, normally @samp{!}.
The second character is the
character which signifies "quick substitution" when seen as the first
character on a line, normally @samp{^}.
@@ -7034,7 +7045,7 @@ The optional third character is the
character which indicates that the remainder of the line is a comment when
found as the first character of a word, usually @samp{#}.
The history
comment character causes history substitution to be skipped for the
comment character disables history substitution for the
remaining words on the line.
It does not necessarily cause the shell
parser to treat the rest of the line as a comment.
@@ -7723,7 +7734,7 @@ When invoked as an interactive login shell, or as a non-interactive
shell with the @option{--login} option, it first attempts to read
and execute commands from @file{/etc/profile} and @file{~/.profile}, in
that order.
The @option{--noprofile} option may be used to inhibit this behavior.
The @option{--noprofile} option will inhibit this behavior.
When invoked as an interactive shell with the name @code{sh}, Bash
looks for the variable @env{ENV}, expands its value if it is defined,
@@ -7735,8 +7746,8 @@ no effect.
A non-interactive shell invoked with the name @code{sh} does not attempt
to read any other startup files.
When invoked as @code{sh}, Bash enters @sc{posix} mode after
the startup files are read.
When invoked as @code{sh}, Bash enters @sc{posix} mode after reading
the startup files.
@subsubheading Invoked in @sc{posix} mode
@@ -7759,7 +7770,7 @@ determines it is being run non-interactively in this fashion,
it reads and executes commands from @file{~/.bashrc}, if that
file exists and is readable.
It will not do this if invoked as @code{sh}.
The @option{--norc} option may be used to inhibit this behavior, and the
The @option{--norc} option will inhibit this behavior, and the
@option{--rcfile} option
will make Bash use a different file instead of
@file{~/.bashrc}, but neither
@@ -7970,10 +7981,10 @@ If the operating system on which Bash is running provides these
special files, Bash will use them; otherwise it will emulate them
internally with this behavior:
If the @var{file} argument to one of the primaries is of the form
@file{/dev/fd/@var{N}}, then file descriptor @var{N} is checked.
@file{/dev/fd/@var{N}}, then Bash checks file descriptor @var{N}.
If the @var{file} argument to one of the primaries is one of
@file{/dev/stdin}, @file{/dev/stdout}, or @file{/dev/stderr}, file
descriptor 0, 1, or 2, respectively, is checked.
@file{/dev/stdin}, @file{/dev/stdout}, or @file{/dev/stderr},
Bash checks file descriptor 0, 1, or 2, respectively.
When used with @code{[[}, the @samp{<} and @samp{>} operators sort
lexicographically using the current locale.
@@ -8202,9 +8213,8 @@ Shell variables are allowed as operands; parameter expansion is
performed before the expression is evaluated.
Within an expression, shell variables may also be referenced by name
without using the parameter expansion syntax.
This means you can use
.Q x ,
where \fIx\fP is a shell variable name, in an arithmetic expression,
This means you can use @var{x},
where @var{x} is a shell variable name, in an arithmetic expression,
and the shell will evaluate its value as an expression and use the
result.
A shell variable that is null or unset evaluates to 0 when referenced
@@ -9019,6 +9029,9 @@ completes.
@item
Bash permanently removes jobs from the jobs table after notifying the
user of their termination via the @code{wait} or @code{jobs} builtins.
It removes the job from the jobs list after notifying the user of its
termination, but the status is still available via @code{wait}, as long
as @code{wait} is supplied a @sc{pid} argument.
@item
The @code{vi} editing mode will invoke the @code{vi} editor directly when
@@ -9266,7 +9279,7 @@ The trap command is run once for each child that exits.
@item
Bash removes an exited background process's status from the list of such
statuses after the @code{wait} builtin is used to obtain it.
statuses after the @code{wait} builtin returns it.
@end enumerate
@@ -9463,7 +9476,7 @@ The @code{unset} builtin will unset the array @code{a} given an argument like
Bash-5.2 will unset an element with key @samp{@@} (associative arrays)
or remove all the elements without unsetting the array (indexed arrays).
@item
Arithmetic commands ( ((...)) ) and the expressions in an arithmetic for
Arithmetic commands ( ((@dots{})) ) and the expressions in an arithmetic for
statement can be expanded more than once.
@item
Expressions used as arguments to arithmetic operators in the @code{[[}
@@ -9472,7 +9485,7 @@ conditional command can be expanded more than once.
The expressions in substring parameter brace expansion can be
expanded more than once.
@item
The expressions in the $(( ... )) word expansion can be expanded
The expressions in the $(( @dots{} )) word expansion can be expanded
more than once.
@item
Arithmetic expressions used as indexed array subscripts can be
@@ -9657,7 +9670,7 @@ 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 @option{-b} option to the @code{set} builtin is enabled,
Bash reports such changes immediately (@pxref{The Set Builtin}).
Bash reports status changes immediately (@pxref{The Set Builtin}).
Bash executes any trap on @code{SIGCHLD}
for each child process that terminates.
@@ -10100,7 +10113,7 @@ You may need to
supply the @option{--srcdir=PATH} argument to tell @code{configure}
where the source files are.
@code{configure} automatically checks for the
source code in the directory that @code{configure} is in and in `..'.
source code in the directory that @code{configure} is in and in @file{..}.
If you have to use a @code{make} that does not support the @code{VPATH}
variable, you can compile Bash for one architecture at a
doc/bashref.vr
+3 -3
View File
@@ -79,7 +79,7 @@
\entry{GROUPS}{91}{\code {GROUPS}}
\entry{histchars}{91}{\code {histchars}}
\entry{HISTCMD}{91}{\code {HISTCMD}}
\entry{HISTCONTROL}{91}{\code {HISTCONTROL}}
\entry{HISTCONTROL}{92}{\code {HISTCONTROL}}
\entry{HISTFILE}{92}{\code {HISTFILE}}
\entry{HISTFILESIZE}{92}{\code {HISTFILESIZE}}
\entry{HISTIGNORE}{92}{\code {HISTIGNORE}}
@@ -94,7 +94,7 @@
\entry{LANG}{93}{\code {LANG}}
\entry{LC_ALL}{93}{\code {LC_ALL}}
\entry{LC_COLLATE}{93}{\code {LC_COLLATE}}
\entry{LC_CTYPE}{93}{\code {LC_CTYPE}}
\entry{LC_CTYPE}{94}{\code {LC_CTYPE}}
\entry{LC_MESSAGES}{94}{\code {LC_MESSAGES}}
\entry{LC_NUMERIC}{94}{\code {LC_NUMERIC}}
\entry{LC_TIME}{94}{\code {LC_TIME}}
@@ -121,7 +121,7 @@
\entry{READLINE_MARK}{95}{\code {READLINE_MARK}}
\entry{READLINE_POINT}{95}{\code {READLINE_POINT}}
\entry{REPLY}{95}{\code {REPLY}}
\entry{SECONDS}{95}{\code {SECONDS}}
\entry{SECONDS}{96}{\code {SECONDS}}
\entry{SHELL}{96}{\code {SHELL}}
\entry{SHELLOPTS}{96}{\code {SHELLOPTS}}
\entry{SHLVL}{96}{\code {SHLVL}}
doc/bashref.vrs
+3 -3
View File
@@ -108,7 +108,7 @@
\initial {H}
\entry{\code {histchars}}{91}
\entry{\code {HISTCMD}}{91}
\entry{\code {HISTCONTROL}}{91}
\entry{\code {HISTCONTROL}}{92}
\entry{\code {HISTFILE}}{92}
\entry{\code {HISTFILESIZE}}{92}
\entry{\code {HISTIGNORE}}{92}
@@ -134,7 +134,7 @@
\entry{\code {LANG}}{8, 93}
\entry{\code {LC_ALL}}{93}
\entry{\code {LC_COLLATE}}{93}
\entry{\code {LC_CTYPE}}{93}
\entry{\code {LC_CTYPE}}{94}
\entry{\code {LC_MESSAGES}}{8, 94}
\entry{\code {LC_NUMERIC}}{94}
\entry{\code {LC_TIME}}{94}
@@ -182,7 +182,7 @@
\entry{\code {revert-all-at-newline}}{138}
\initial {S}
\entry{\code {search-ignore-case}}{138}
\entry{\code {SECONDS}}{95}
\entry{\code {SECONDS}}{96}
\entry{\code {SHELL}}{96}
\entry{\code {SHELLOPTS}}{96}
\entry{\code {SHLVL}}{96}
doc/builtins.0
+336 -330
View File
File diff suppressed because it is too large Load Diff
doc/builtins.ps
+3208 -3095
View File
File diff suppressed because it is too large Load Diff
doc/rbash.ps
+44 -42
View File
@@ -1,6 +1,6 @@
%!PS-Adobe-3.0
%%Creator: groff version 1.23.0
%%CreationDate: Thu Apr 4 17:50:31 2024
%%CreationDate: Thu Oct 17 11:28:25 2024
%%DocumentNeededResources: font Times-Italic
%%+ font Times-Roman
%%+ font Times-Bold
@@ -271,53 +271,55 @@ BP
E F1(\(1\)).95 E/F2 10.95/Times-Bold@0 SF -.219(NA)72 84 S(ME).219 E F1
(rbash \255 restricted bash, see)108 96 Q/F3 10/Times-Bold@0 SF(bash)2.5
E F1(\(1\))A F2(RESTRICTED SHELL)72 112.8 Q F1(If)108 124.8 Q F3(bash)
3.582 E F1 1.081(is started with the name)3.581 F F3(rbash)3.581 E F1
3.581(,o)C 3.581(rt)-3.581 G(he)-3.581 E F3<ad72>3.581 E F1 1.081
(option is supplied at in)3.581 F -.2(vo)-.4 G 1.081
(cation, the shell becomes re-).2 F 2.976(stricted. A)108 136.8 R .476
(restricted shell is used to set up an en)2.976 F .476
(vironment more controlled than the standard shell.)-.4 F .477(It be-)
5.477 F(ha)108 148.8 Q -.15(ve)-.2 G 2.5(si).15 G(dentically to)-2.5 E
F3(bash)2.5 E F1(with the e)2.5 E(xception that the follo)-.15 E
3.572 E F1 1.071(is started with the name)3.571 F F3(rbash)3.571 E F1
3.571(,o)C 3.571(rt)-3.571 G(he)-3.571 E F3<ad72>3.571 E F1 1.071
(option is supplied at in)3.571 F -.2(vo)-.4 G 1.071
(cation, the shell becomes).2 F F0 -.37(re)3.571 G(-).37 E(stricted)108
136.8 Q F1 5.445(.A)C .445(restricted shell is used to set up an en)-2.5
F .445(vironment more controlled than the standard shell.)-.4 F .445
(It be-)5.445 F(ha)108 148.8 Q -.15(ve)-.2 G 2.5(si).15 G(dentically to)
-2.5 E F3(bash)2.5 E F1(with the e)2.5 E(xception that the follo)-.15 E
(wing are disallo)-.25 E(wed or not performed:)-.25 E<83>108 165.6 Q
(changing directories with)144 165.6 Q F3(cd)2.5 E F1<83>108 182.4 Q
(setting or unsetting the v)144 182.4 Q(alues of)-.25 E/F4 9
(Changing directories with)144 165.6 Q F3(cd)2.5 E F1(.)A<83>108 182.4 Q
(Setting or unsetting the v)144 182.4 Q(alues of)-.25 E/F4 9
/Times-Bold@0 SF(SHELL)2.5 E/F5 9/Times-Roman@0 SF(,)A F4 -.666(PA)2.25
G(TH)-.189 E F5(,)A F4(HISTFILE)2.25 E F5(,)A F4(ENV)2.25 E F5(,)A F1
(or)2.25 E F4 -.27(BA)2.5 G(SH_ENV).27 E F1<83>108 199.2 Q
(specifying command names containing)144 199.2 Q F3(/)2.5 E F1<83>108
216 Q(specifying a \214lename containing a)144 216 Q F3(/)2.5 E F1
(or)2.25 E F4 -.27(BA)2.5 G(SH_ENV).27 E F5(.)A F1<83>108 199.2 Q
(Specifying command names containing)144 199.2 Q F3(/)2.5 E F1(.)A<83>
108 216 Q(Specifying a \214lename containing a)144 216 Q F3(/)2.5 E F1
(as an ar)2.5 E(gument to the)-.18 E F3(.)2.5 E F1 -.2(bu)5 G
(iltin command).2 E<83>108 232.8 Q
(specifying a \214lename containing a slash as an ar)144 232.8 Q
(gument to the)-.18 E F3(history)2.5 E F1 -.2(bu)2.5 G(iltin command).2
E<83>108 249.6 Q .45
(specifying a \214lename containing a slash as an ar)144 249.6 R .449
(gument to the)-.18 F F3<ad70>2.949 E F1 .449(option to the)2.949 F F3
(hash)2.949 E F1 -.2(bu)2.949 G .449(iltin com-).2 F(mand)144 261.6 Q
<83>108 278.4 Q(importing function de\214nitions from the shell en)144
278.4 Q(vironment at startup)-.4 E<83>108 295.2 Q(parsing the v)144
295.2 Q(alue of)-.25 E F4(SHELLOPTS)2.5 E F1(from the shell en)2.25 E
(vironment at startup)-.4 E<83>108 312 Q(redirecting output using the >\
, >|, <>, >&, &>, and >> redirection operators)144 312 Q<83>108 328.8 Q
(using the)144 328.8 Q F3(exec)2.5 E F1 -.2(bu)2.5 G
(iltin command to replace the shell with another command).2 E<83>108
345.6 Q(adding or deleting b)144 345.6 Q(uiltin commands with the)-.2 E
F3<ad66>2.5 E F1(and)2.5 E F3<ad64>2.5 E F1(options to the)2.5 E F3
(enable)2.5 E F1 -.2(bu)2.5 G(iltin command).2 E<83>108 362.4 Q
(using the)144 362.4 Q F3(enable)2.5 E F1 -.2(bu)2.5 G
(iltin command to enable disabled shell b).2 E(uiltins)-.2 E<83>108
379.2 Q(specifying the)144 379.2 Q F3<ad70>2.5 E F1(option to the)2.5 E
F3(command)2.5 E F1 -.2(bu)2.5 G(iltin command).2 E<83>108 396 Q
(turning of)144 396 Q 2.5(fr)-.25 G(estricted mode with)-2.5 E F3
(set +r)2.5 E F1(or)2.5 E F3(shopt \255u r)2.5 E(estricted_shell)-.18 E
F1(.)A(These restrictions are enforced after an)108 412.8 Q 2.5(ys)-.15
G(tartup \214les are read.)-2.5 E .429
(When a command that is found to be a shell script is e)108 429.6 R -.15
(iltin command.).2 E<83>108 232.8 Q(Using the)144 232.8 Q F3<ad70>2.5 E
F1(option to the)2.5 E F3(.)2.5 E F1 -.2(bu)5 G
(iltin command to specify a search path.).2 E<83>108 249.6 Q
(Specifying a \214lename containing a slash as an ar)144 249.6 Q
(gument to the)-.18 E F3(history)2.5 E F1 -.2(bu)2.5 G(iltin command.).2
E<83>108 266.4 Q .351
(Specifying a \214lename containing a slash as an ar)144 266.4 R .351
(gument to the)-.18 F F3<ad70>2.851 E F1 .351(option to the)2.851 F F3
(hash)2.851 E F1 -.2(bu)2.851 G .351(iltin com-).2 F(mand.)144 278.4 Q
<83>108 295.2 Q(Importing function de\214nitions from the shell en)144
295.2 Q(vironment at startup.)-.4 E<83>108 312 Q -.15(Pa)144 312 S
(rsing the v).15 E(alue of)-.25 E F4(SHELLOPTS)2.5 E F1
(from the shell en)2.25 E(vironment at startup.)-.4 E<83>108 328.8 Q(Re\
directing output using the >, >|, <>, >&, &>, and >> redirection operat\
ors.)144 328.8 Q<83>108 345.6 Q(Using the)144 345.6 Q F3(exec)2.5 E F1
-.2(bu)2.5 G(iltin command to replace the shell with another command.).2
E<83>108 362.4 Q(Adding or deleting b)144 362.4 Q
(uiltin commands with the)-.2 E F3<ad66>2.5 E F1(and)2.5 E F3<ad64>2.5 E
F1(options to the)2.5 E F3(enable)2.5 E F1 -.2(bu)2.5 G(iltin command.)
.2 E<83>108 379.2 Q(Using the)144 379.2 Q F3(enable)2.5 E F1 -.2(bu)2.5
G(iltin command to enable disabled shell b).2 E(uiltins.)-.2 E<83>108
396 Q(Specifying the)144 396 Q F3<ad70>2.5 E F1(option to the)2.5 E F3
(command)2.5 E F1 -.2(bu)2.5 G(iltin command.).2 E<83>108 412.8 Q -.45
(Tu)144 412.8 S(rning of).45 E 2.5(fr)-.25 G(estricted mode with)-2.5 E
F3(set +r)2.5 E F1(or)2.5 E F3(shopt \255u r)2.5 E(estricted_shell)-.18
E F1(.)A(These restrictions are enforced after an)108 429.6 Q 2.5(ys)
-.15 G(tartup \214les are read.)-2.5 E .429
(When a command that is found to be a shell script is e)108 446.4 R -.15
(xe)-.15 G(cuted,).15 E F3(rbash)2.929 E F1 .429(turns of)2.929 F 2.929
(fa)-.25 G .729 -.15(ny r)-2.929 H .429(estrictions in the shell).15 F
(spa)108 441.6 Q(wned to e)-.15 E -.15(xe)-.15 G(cute the script.).15 E
F2(SEE ALSO)72 458.4 Q F1(bash\(1\))108 470.4 Q 157.215(Bash-5.2 2021)72
(spa)108 458.4 Q(wned to e)-.15 E -.15(xe)-.15 G(cute the script.).15 E
F2(SEE ALSO)72 475.2 Q F1(bash\(1\))108 487.2 Q 157.215(Bash-5.2 2021)72
768 R(No)2.5 E -.15(ve)-.15 G(mber 22).15 E(1)190.545 E 0 Cg EP
%%Trailer
end
doc/version.texi
+2 -2
View File
@@ -2,10 +2,10 @@
Copyright (C) 1988-2024 Free Software Foundation, Inc.
@end ignore
@set LASTCHANGE Mon Oct 14 11:41:52 EDT 2024
@set LASTCHANGE Tue Oct 15 16:54:10 EDT 2024
@set EDITION 5.3
@set VERSION 5.3
@set UPDATED 14 October 2024
@set UPDATED 15 October 2024
@set UPDATED-MONTH October 2024
lib/readline/doc/history.dvi
BIN
View File
Binary file not shown.
lib/readline/doc/history.html
+3 -3
View File
@@ -1,6 +1,6 @@
<HTML>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- Created on October, 12 2024 by texi2html 1.64 -->
<!-- Created on October, 17 2024 by texi2html 1.64 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -2263,7 +2263,7 @@ to permit their use in free software.
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="history.html#SEC_About"> ? </A>]</TD>
</TR></TABLE>
<H1>About this document</H1>
This document was generated by <I>Chet Ramey</I> on <I>October, 12 2024</I>
This document was generated by <I>Chet Ramey</I> on <I>October, 17 2024</I>
using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
"><I>texi2html</I></A>
<P></P>
@@ -2425,7 +2425,7 @@ the following structure:
<BR>
<FONT SIZE="-1">
This document was generated
by <I>Chet Ramey</I> on <I>October, 12 2024</I>
by <I>Chet Ramey</I> on <I>October, 17 2024</I>
using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
"><I>texi2html</I></A>
lib/readline/doc/history.info
+1 -1
View File
@@ -1,7 +1,7 @@
This is history.info, produced by makeinfo version 7.1 from
history.texi.
This document describes the GNU History library (version 8.3, 10 October
This document describes the GNU History library (version 8.3, 15 October
2024), a programming tool that provides a consistent user interface for
recalling lines of previously typed input.
lib/readline/doc/history.log
+8 -8
View File
@@ -1,11 +1,11 @@
This is pdfTeX, Version 3.141592653-2.6-1.40.26 (TeX Live 2024/MacPorts 2024.70613_0) (preloaded format=etex 2024.4.9) 12 OCT 2024 13:36
This is pdfTeX, Version 3.141592653-2.6-1.40.26 (TeX Live 2024/MacPorts 2024.70613_0) (preloaded format=etex 2024.4.9) 17 OCT 2024 11:28
entering extended mode
restricted \write18 enabled.
file:line:error style messages enabled.
%&-line parsing enabled.
**\nonstopmode \input ././history.texi
(././history.texi
(/usr/local/src/bash/bash-20241011/lib/readline/doc/texinfo.tex
(/usr/local/src/bash/bash-20241015/lib/readline/doc/texinfo.tex
Loading texinfo [version 2015-11-22.14]:
\outerhsize=\dimen16
\outervsize=\dimen17
@@ -161,16 +161,16 @@ This is `epsf.tex' v2.7.4 <14 February 2011>
texinfo.tex: doing @include of version.texi
(/usr/local/src/bash/bash-20241011/lib/readline/doc/version.texi) [1] [2]
(/usr/local/src/bash/bash-20241011/lib/readline/doc/history.toc) [-1]
(/usr/local/src/bash/bash-20241015/lib/readline/doc/version.texi) [1] [2]
(/usr/local/src/bash/bash-20241015/lib/readline/doc/history.toc) [-1]
texinfo.tex: doing @include of hsuser.texi
(/usr/local/src/bash/bash-20241011/lib/readline/doc/hsuser.texi Chapter 1
(/usr/local/src/bash/bash-20241015/lib/readline/doc/hsuser.texi Chapter 1
\openout0 = `history.toc'.
(/usr/local/src/bash/bash-20241011/lib/readline/doc/history.aux)
(/usr/local/src/bash/bash-20241015/lib/readline/doc/history.aux)
\openout1 = `history.aux'.
@cpindfile=@write2
@@ -185,7 +185,7 @@ texinfo.tex: doing @include of hsuser.texi
])
texinfo.tex: doing @include of hstech.texi
(/usr/local/src/bash/bash-20241011/lib/readline/doc/hstech.texi Chapter 2
(/usr/local/src/bash/bash-20241015/lib/readline/doc/hstech.texi Chapter 2
[3
@numsubsecentry{Modifiers}{1.1.3}{Modifiers}{3}
] [4
@@ -227,7 +227,7 @@ y List}{7}
texinfo.tex: doing @include of fdl.texi
(/usr/local/src/bash/bash-20241011/lib/readline/doc/fdl.texi [13
(/usr/local/src/bash/bash-20241015/lib/readline/doc/fdl.texi [13
@appentry{GNU Free Documentation License}{A}{GNU Free Documentation License}{13
}
] [14] [15] [16] [17] [18] [19]) Appendix B [20] Appendix C [21
lib/readline/doc/history.pdf
BIN
View File
Binary file not shown.
lib/readline/doc/history.ps
+3 -3
View File
@@ -1,7 +1,7 @@
%!PS-Adobe-2.0
%%Creator: dvips(k) 2024.1 (TeX Live 2024) Copyright 2024 Radical Eye Software
%%Title: history.dvi
%%CreationDate: Sat Oct 12 17:36:36 2024
%%CreationDate: Thu Oct 17 15:28:47 2024
%%Pages: 25
%%PageOrder: Ascend
%%BoundingBox: 0 0 596 842
@@ -12,7 +12,7 @@
%DVIPSWebPage: (www.radicaleye.com)
%DVIPSCommandLine: dvips -D 300 -o history.ps history.dvi
%DVIPSParameters: dpi=300
%DVIPSSource: TeX output 2024.10.12:1336
%DVIPSSource: TeX output 2024.10.17:1128
%%BeginProcSet: tex.pro 0 0
%!
/TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S
@@ -5251,7 +5251,7 @@ b(Case)e(W)-6 b(estern)23 b(Reserv)n(e)f(Univ)n(ersit)n(y)75
b(oundation)p 75 2570 1800 9 v eop end
%%Page: 2 2
TeXDict begin 2 1 bop 75 2207 a Fq(This)17 b(do)q(cumen)o(t)i(describ)q
(es)f(the)g(GNU)g(History)f(library)f(\(v)o(ersion)h(8.3,)g(10)g(Octob)
(es)f(the)g(GNU)g(History)f(library)f(\(v)o(ersion)h(8.3,)g(15)g(Octob)
q(er)i(2024\),)e(a)g(pro-)75 2262 y(gramming)10 b(to)q(ol)g(that)g(pro)
o(vides)h(a)g(consisten)o(t)f(user)i(in)o(terface)e(for)h(recalling)f
(lines)g(of)h(previously)g(t)o(yp)q(ed)75 2316 y(input.)75
lib/readline/doc/readline.0
+182 -176
View File
@@ -39,33 +39,39 @@ RREETTUURRNN VVAALLUUEE
line, it is treated as a newline.
NNOOTTAATTIIOONN
This section uses an emacs-style notation to denote keystrokes. Con-
trol keys are denoted by C-_k_e_y, e.g., C-n means Control-N. Similarly,
_m_e_t_a keys are denoted by M-_k_e_y, so M-x means Meta-X.
This section uses Emacs-style editing concepts and uses its notation
for keystrokes. Control keys are denoted by C-_k_e_y, e.g., C-n means
Control-N. Similarly, _m_e_t_a keys are denoted by M-_k_e_y, so M-x means
Meta-X. The Meta key is often labeled "Alt" or "Option".
On keyboards without a _M_e_t_a key, M-_x means ESC _x, i.e., press the Es-
cape key then the _x key. This makes ESC the _m_e_t_a _p_r_e_f_i_x. The combina-
tion M-C-_x means ESC-Control-_x, or press the Escape key then hold the
Control key while pressing the _x key.
On keyboards without a _M_e_t_a key, M-_x means ESC _x, i.e., press and re-
lease the Escape key, then press and release the _x key, in sequence.
This makes ESC the _m_e_t_a _p_r_e_f_i_x. The combination M-C-_x means ESC-Con-
trol-_x: press and release the Escape key, then press and hold the Con-
trol key while pressing the _x key, then release both.
On some keyboards, the Meta key modifier produces meta characters with
the eighth bit (0200) set (you can use the eennaabbllee--mmeettaa--kkeeyy variable to
control whether or not it does this, if the keyboard allows it). On
many others, the terminal or terminal emulator converts the metafied
key to a key sequence beginning with ESC as described in the preceding
On some keyboards, the Meta key modifier produces characters with the
eighth bit (0200) set. You can use the eennaabbllee--mmeettaa--kkeeyy variable to
control whether or not it does this, if the keyboard allows it. On
many others, the terminal or terminal emulator converts the metafied
key to a key sequence beginning with ESC as described in the preceding
paragraph.
If your _M_e_t_a key produces a key sequence with the ESC meta prefix, you
can make M-_k_e_y key bindings you specify (see RReeaaddlliinnee KKeeyy BBiinnddiinnggss be-
If your _M_e_t_a key produces a key sequence with the ESC meta prefix, you
can make M-_k_e_y key bindings you specify (see RReeaaddlliinnee KKeeyy BBiinnddiinnggss be-
low) do the same thing by setting the ffoorrccee--mmeettaa--pprreeffiixx variable.
Readline commands may be given numeric _a_r_g_u_m_e_n_t_s, which normally act as
a repeat count. Sometimes, however, it is the sign of the argument
that is significant. Passing a negative argument to a command that
acts in the forward direction (e.g., kkiillll--lliinnee) makes that command act
in a backward direction. Commands whose behavior with arguments devi-
RReeaaddlliinnee commands may be given numeric _a_r_g_u_m_e_n_t_s, which normally act as
a repeat count. Sometimes, however, it is the sign of the argument
that is significant. Passing a negative argument to a command that
acts in the forward direction (e.g., kkiillll--lliinnee) makes that command act
in a backward direction. Commands whose behavior with arguments devi-
ates from this are noted below.
The _p_o_i_n_t is the current cursor position, and _m_a_r_k refers to a saved
cursor position. The text between the point and mark is referred to as
the _r_e_g_i_o_n.
When a command is described as _k_i_l_l_i_n_g text, the text deleted is saved
for possible future retrieval (_y_a_n_k_i_n_g). The killed text is saved in a
_k_i_l_l _r_i_n_g. Consecutive kills accumulate the deleted text into one
@@ -73,12 +79,12 @@ NNOOTTAATTIIOONN
separate the chunks of text on the kill ring.
IINNIITTIIAALLIIZZAATTIIOONN FFIILLEE
Readline is customized by putting commands in an initialization file
RReeaaddlliinnee is customized by putting commands in an initialization file
(the _i_n_p_u_t_r_c file). The name of this file is taken from the value of
the IINNPPUUTTRRCC environment variable. If that variable is unset, the de-
fault is _~_/_._i_n_p_u_t_r_c. If that file does not exist or cannot be read,
readline looks for _/_e_t_c_/_i_n_p_u_t_r_c. When a program which uses the read-
line library starts up, rreeaaddlliinnee reads the initialization file and sets
rreeaaddlliinnee looks for _/_e_t_c_/_i_n_p_u_t_r_c. When a program which uses the rreeaadd--
lliinnee library starts up, rreeaaddlliinnee reads the initialization file and sets
the key bindings and variables found there, before reading any user in-
put.
@@ -97,25 +103,26 @@ IINNIITTIIAALLIIZZAATTIIOONN FFIILLEE
or
C-Meta-u: universal-argument
into the _i_n_p_u_t_r_c would make M-C-u execute the readline command _u_n_i_v_e_r_-
into the _i_n_p_u_t_r_c would make M-C-u execute the rreeaaddlliinnee command _u_n_i_v_e_r_-
_s_a_l_-_a_r_g_u_m_e_n_t.
Key bindings may contain the following symbolic character names: _D_E_L,
_E_S_C, _E_S_C_A_P_E, _L_F_D, _N_E_W_L_I_N_E, _R_E_T, _R_E_T_U_R_N, _R_U_B_O_U_T, _S_P_A_C_E, _S_P_C, and _T_A_B.
_E_S_C, _E_S_C_A_P_E, _L_F_D, _N_E_W_L_I_N_E, _R_E_T, _R_E_T_U_R_N, _R_U_B_O_U_T(a_d_e_s_t_r_u_c_t_i_v_ebackspace),
_S_P_A_C_E, _S_P_C, and _T_A_B.
In addition to command names, readline allows keys to be bound to a
In addition to command names, rreeaaddlliinnee allows keys to be bound to a
string that is inserted when the key is pressed (a _m_a_c_r_o). The differ-
ence between a macro and a command is that a macro is enclosed in sin-
ence between a macro and a command is that a macro is enclosed in sin-
gle or double quotes.
KKeeyy BBiinnddiinnggss
The syntax for controlling key bindings in the _i_n_p_u_t_r_c file is simple.
All that is required is the name of the command or the text of a macro
and a key sequence to which it should be bound. The key sequence may
be specified in one of two ways: as a symbolic key name, possibly with
_M_e_t_a_- or _C_o_n_t_r_o_l_- prefixes, or as a key sequence composed of one or
more characters enclosed in double quotes. The key sequence and name
are separated by a colon. There can be no whitespace between the name
The syntax for controlling key bindings in the _i_n_p_u_t_r_c file is simple.
All that is required is the name of the command or the text of a macro
and a key sequence to which it should be bound. The key sequence may
be specified in one of two ways: as a symbolic key name, possibly with
_M_e_t_a_- or _C_o_n_t_r_o_l_- prefixes, or as a key sequence composed of one or
more characters enclosed in double quotes. The key sequence and name
are separated by a colon. There can be no whitespace between the name
and the colon.
When using the form kkeeyynnaammee:_f_u_n_c_t_i_o_n_-_n_a_m_e or _m_a_c_r_o, _k_e_y_n_a_m_e is the name
@@ -125,15 +132,15 @@ IINNIITTIIAALLIIZZAATTIIOONN FFIILLEE
Meta-Rubout: backward-kill-word
Control-o: "> output"
In the above example, _C_-_u is bound to the function uunniivveerrssaall--aarrgguummeenntt,
_M_-_D_E_L is bound to the function bbaacckkwwaarrdd--kkiillll--wwoorrdd, and _C_-_o is bound to
run the macro expressed on the right hand side (that is, to insert the
In the above example, _C_-_u is bound to the function uunniivveerrssaall--aarrgguummeenntt,
_M_-_D_E_L is bound to the function bbaacckkwwaarrdd--kkiillll--wwoorrdd, and _C_-_o is bound to
run the macro expressed on the right hand side (that is, to insert the
text "> output" into the line).
In the second form, ""kkeeyysseeqq"":_f_u_n_c_t_i_o_n_-_n_a_m_e or _m_a_c_r_o, kkeeyysseeqq differs
from kkeeyynnaammee above in that strings denoting an entire key sequence may
be specified by placing the sequence within double quotes. Some GNU
Emacs style key escapes can be used, as in the following example, but
In the second form, ""kkeeyysseeqq"":_f_u_n_c_t_i_o_n_-_n_a_m_e or _m_a_c_r_o, kkeeyysseeqq differs
from kkeeyynnaammee above in that strings denoting an entire key sequence may
be specified by placing the sequence within double quotes. Some GNU
Emacs style key escapes can be used, as in the following example, but
none of the symbolic character names are recognized.
"\C-u": universal-argument
@@ -141,21 +148,21 @@ IINNIITTIIAALLIIZZAATTIIOONN FFIILLEE
"\e[11~": "Function Key 1"
In this example, _C_-_u is again bound to the function uunniivveerrssaall--aarrgguummeenntt.
_C_-_x _C_-_r is bound to the function rree--rreeaadd--iinniitt--ffiillee, and _E_S_C _[ _1 _1 _~ is
_C_-_x _C_-_r is bound to the function rree--rreeaadd--iinniitt--ffiillee, and _E_S_C _[ _1 _1 _~ is
bound to insert the text "Function Key 1".
The full set of GNU Emacs style escape sequences available when speci-
The full set of GNU Emacs style escape sequences available when speci-
fying key sequences is
\\CC-- A control prefix.
\\MM-- Adding the meta prefix or converting the following char-
acter to a meta character, as described below under
\\MM-- Adding the meta prefix or converting the following char-
acter to a meta character, as described below under
ffoorrccee--mmeettaa--pprreeffiixx.
\\ee An escape character.
\\\\ Backslash.
\\"" Literal ", a double quote.
\\'' Literal ', a single quote.
In addition to the GNU Emacs style escape sequences, a second set of
In addition to the GNU Emacs style escape sequences, a second set of
backslash escapes is available:
\\aa alert (bell)
\\bb backspace
@@ -165,92 +172,92 @@ IINNIITTIIAALLIIZZAATTIIOONN FFIILLEE
\\rr carriage return
\\tt horizontal tab
\\vv vertical tab
\\_n_n_n The eight-bit character whose value is the octal value
\\_n_n_n The eight-bit character whose value is the octal value
_n_n_n (one to three 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).
When entering the text of a macro, single or double quotes must be used
to indicate a macro definition. Unquoted text is assumed to be a func-
tion name. Tthe backslash escapes described above are expanded in the
macro body. Backslash will quote any other character in the macro
tion name. Tthe backslash escapes described above are expanded in the
macro body. Backslash will quote any other character in the macro
text, including " and '.
BBaasshh will display or modify the current readline key bindings with the
BBaasshh will display or modify the current rreeaaddlliinnee key bindings with the
bbiinndd builtin command. The --oo eemmaaccss or --oo vvii options to the sseett builtin
will change the editing mode during interactive use. Other programs
using this library provide similar mechanisms. A user may always edit
the _i_n_p_u_t_r_c file and have readline re-read it if a program does not
will change the editing mode during interactive use. Other programs
using this library provide similar mechanisms. A user may always edit
the _i_n_p_u_t_r_c file and have rreeaaddlliinnee re-read it if a program does not
provide any other means to incorporate new bindings.
VVaarriiaabblleess
Readline has variables that can be used to further customize its behav-
RReeaaddlliinnee has variables that can be used to further customize its behav-
ior. A variable may be set in the _i_n_p_u_t_r_c file with a statement of the
form
sseett _v_a_r_i_a_b_l_e_-_n_a_m_e _v_a_l_u_e
Except where noted, readline variables can take the values OOnn or OOffff
(without regard to case). Unrecognized variable names are ignored.
When readline reads a variable value, empty or null values, "on" (case-
insensitive), and "1" are equivalent to OOnn. All other values are
Except where noted, rreeaaddlliinnee variables can take the values OOnn or OOffff
(without regard to case). Unrecognized variable names are ignored.
When rreeaaddlliinnee reads a variable value, empty or null values, "on" (case-
insensitive), and "1" are equivalent to OOnn. All other values are
equivalent to OOffff.
The variables and their default values are:
aaccttiivvee--rreeggiioonn--ssttaarrtt--ccoolloorr
A string variable that controls the text color and background
when displaying the text in the active region (see the descrip-
tion of eennaabbllee--aaccttiivvee--rreeggiioonn below). This string must not take
A string variable that controls the text color and background
when displaying the text in the active region (see the descrip-
tion of eennaabbllee--aaccttiivvee--rreeggiioonn below). This string must not take
up any physical character positions on the display, so it should
consist only of terminal escape sequences. It is output to the
terminal before displaying the text in the active region. This
variable is reset to the default value whenever the terminal
type changes. The default value is the string that puts the
terminal in standout mode, as obtained from the terminal's ter-
consist only of terminal escape sequences. It is output to the
terminal before displaying the text in the active region. This
variable is reset to the default value whenever the terminal
type changes. The default value is the string that puts the
terminal in standout mode, as obtained from the terminal's ter-
minfo description. A sample value might be "\e[01;33m".
aaccttiivvee--rreeggiioonn--eenndd--ccoolloorr
A string variable that "undoes" the effects of aaccttiivvee--rree--
ggiioonn--ssttaarrtt--ccoolloorr and restores "normal" terminal display appear-
ance after displaying text in the active region. This string
must not take up any physical character positions on the dis-
play, so it should consist only of terminal escape sequences.
It is output to the terminal after displaying the text in the
active region. This variable is reset to the default value
whenever the terminal type changes. The default value is the
string that restores the terminal from standout mode, as ob-
A string variable that "undoes" the effects of aaccttiivvee--rree--
ggiioonn--ssttaarrtt--ccoolloorr and restores "normal" terminal display appear-
ance after displaying text in the active region. This string
must not take up any physical character positions on the dis-
play, so it should consist only of terminal escape sequences.
It is output to the terminal after displaying the text in the
active region. This variable is reset to the default value
whenever the terminal type changes. The default value is the
string that restores the terminal from standout mode, as ob-
tained from the terminal's terminfo description. A sample value
might be "\e[0m".
bbeellll--ssttyyllee ((aauuddiibbllee))
Controls what happens when readline wants to ring the terminal
bell. If set to nnoonnee, readline never rings the bell. If set to
vviissiibbllee, readline uses a visible bell if one is available. If
set to aauuddiibbllee, readline attempts to ring the terminal's bell.
Controls what happens when rreeaaddlliinnee wants to ring the terminal
bell. If set to nnoonnee, rreeaaddlliinnee never rings the bell. If set to
vviissiibbllee, rreeaaddlliinnee uses a visible bell if one is available. If
set to aauuddiibbllee, rreeaaddlliinnee attempts to ring the terminal's bell.
bbiinndd--ttttyy--ssppeecciiaall--cchhaarrss ((OOnn))
If set to OOnn, readline attempts to bind the control characters
that are treated specially by the kernel's terminal driver to
their readline equivalents. These override the default readline
If set to OOnn, rreeaaddlliinnee attempts to bind the control characters
that are treated specially by the kernel's terminal driver to
their rreeaaddlliinnee equivalents. These override the default rreeaaddlliinnee
bindings described here. Type "stty -a" at a bbaasshh prompt to see
your current terminal settings, including the special control
your current terminal settings, including the special control
characters (usually cccchhaarrss).
bblliinnkk--mmaattcchhiinngg--ppaarreenn ((OOffff))
If set to OOnn, readline attempts to briefly move the cursor to an
If set to OOnn, rreeaaddlliinnee attempts to briefly move the cursor to an
opening parenthesis when a closing parenthesis is inserted.
ccoolloorreedd--ccoommpplleettiioonn--pprreeffiixx ((OOffff))
If set to OOnn, when listing completions, readline displays the
If set to OOnn, when listing completions, rreeaaddlliinnee displays the
common prefix of the set of possible completions using a differ-
ent color. The color definitions are taken from the value of
ent color. The color definitions are taken from the value of
the LLSS__CCOOLLOORRSS environment variable. If there is a color defini-
tion in $$LLSS__CCOOLLOORRSS for the custom suffix "readline-colored-com-
pletion-prefix", readline uses this color for the common prefix
tion in $$LLSS__CCOOLLOORRSS for the custom suffix ".readline-colored-com-
pletion-prefix", rreeaaddlliinnee uses this color for the common prefix
instead of its default.
ccoolloorreedd--ssttaattss ((OOffff))
If set to OOnn, readline displays possible completions using dif-
If set to OOnn, rreeaaddlliinnee displays possible completions using dif-
ferent colors to indicate their file type. The color defini-
tions are taken from the value of the LLSS__CCOOLLOORRSS environment
variable.
ccoommmmeenntt--bbeeggiinn (("##"))
The string that the readline iinnsseerrtt--ccoommmmeenntt command inserts.
The string that the rreeaaddlliinnee iinnsseerrtt--ccoommmmeenntt command inserts.
This command is bound to MM--## in emacs mode and to ## in vi com-
mand mode.
ccoommpplleettiioonn--ddiissppllaayy--wwiiddtthh ((--11))
@@ -260,16 +267,16 @@ IINNIITTIIAALLIIZZAATTIIOONN FFIILLEE
will cause matches to be displayed one per line. The default
value is -1.
ccoommpplleettiioonn--iiggnnoorree--ccaassee ((OOffff))
If set to OOnn, readline performs filename matching and completion
If set to OOnn, rreeaaddlliinnee performs filename matching and completion
in a case-insensitive fashion.
ccoommpplleettiioonn--mmaapp--ccaassee ((OOffff))
If set to OOnn, and ccoommpplleettiioonn--iiggnnoorree--ccaassee is enabled, readline
If set to OOnn, and ccoommpplleettiioonn--iiggnnoorree--ccaassee is enabled, rreeaaddlliinnee
treats hyphens (_-) and underscores (__) as equivalent when per-
forming case-insensitive filename matching and completion.
ccoommpplleettiioonn--pprreeffiixx--ddiissppllaayy--lleennggtthh ((00))
The maximum length in characters of the common prefix of a list
of possible completions that is displayed without modification.
When set to a value greater than zero, readline replaces common
When set to a value greater than zero, rreeaaddlliinnee replaces common
prefixes longer than this value with an ellipsis when displaying
possible completions.
ccoommpplleettiioonn--qquueerryy--iitteemmss ((110000))
@@ -277,30 +284,30 @@ IINNIITTIIAALLIIZZAATTIIOONN FFIILLEE
ber of possible completions generated by the ppoossssiibbllee--ccoommppllee--
ttiioonnss command. It may be set to any integer value greater than
or equal to zero. If the number of possible completions is
greater than or equal to the value of this variable, readline
greater than or equal to the value of this variable, rreeaaddlliinnee
will ask whether or not the user wishes to view them; otherwise
readline simply lists them on the terminal. A zero value means
readline should never ask; negative values are treated as zero.
rreeaaddlliinnee simply lists them on the terminal. A zero value means
rreeaaddlliinnee should never ask; negative values are treated as zero.
ccoonnvveerrtt--mmeettaa ((OOnn))
If set to OOnn, readline will convert characters it reads that
If set to OOnn, rreeaaddlliinnee will convert characters it reads that
have the eighth bit set to an ASCII key sequence by clearing the
eighth bit and prefixing it with an escape character (converting
the character to have the _m_e_t_a _p_r_e_f_i_x). The default is _O_n, but
readline will set it to _O_f_f if the locale contains characters
the character to have the meta prefix). The default is _O_n, but
rreeaaddlliinnee will set it to _O_f_f if the locale contains characters
whose encodings may include bytes with the eighth bit set. This
variable is dependent on the LLCC__CCTTYYPPEE locale category, and may
change if the locale changes. This variable also affects key
bindings; see the description of ffoorrccee--mmeettaa--pprreeffiixx below.
ddiissaabbllee--ccoommpplleettiioonn ((OOffff))
If set to OOnn, readline will inhibit word completion. Completion
If set to OOnn, rreeaaddlliinnee will inhibit word completion. Completion
characters will be inserted into the line as if they had been
mapped to sseellff--iinnsseerrtt.
eecchhoo--ccoonnttrrooll--cchhaarraacctteerrss ((OOnn))
When set to OOnn, on operating systems that indicate they support
it, readline echoes a character corresponding to a signal gener-
it, rreeaaddlliinnee echoes a character corresponding to a signal gener-
ated from the keyboard.
eeddiittiinngg--mmooddee ((eemmaaccss))
Controls whether readline uses a set of key bindings similar to
Controls whether rreeaaddlliinnee uses a set of key bindings similar to
_E_m_a_c_s or _v_i. eeddiittiinngg--mmooddee can be set to either eemmaaccss or vvii.
eemmaaccss--mmooddee--ssttrriinngg ((@@))
If the _s_h_o_w_-_m_o_d_e_-_i_n_-_p_r_o_m_p_t variable is enabled, this string is
@@ -312,29 +319,26 @@ IINNIITTIIAALLIIZZAATTIIOONN FFIILLEE
can be used to embed a terminal control sequence into the mode
string.
eennaabbllee--aaccttiivvee--rreeggiioonn ((OOnn))
The _p_o_i_n_t is the current cursor position, and _m_a_r_k refers to a
saved cursor position. The text between the point and mark is
referred to as the _r_e_g_i_o_n. When this variable is set to _O_n,
readline allows certain commands to designate the region as _a_c_-
_t_i_v_e. When the region is active, readline highlights the text
in the region using the value of the aaccttiivvee--rreeggiioonn--ssttaarrtt--ccoolloorr,
which defaults to the string that enables the terminal's stand-
out mode. The active region shows the text inserted by brack-
eted-paste and any matching text found by incremental and non-
incremental history searches.
When this variable is set to _O_n, rreeaaddlliinnee allows certain com-
mands to designate the region as _a_c_t_i_v_e. When the region is ac-
tive, rreeaaddlliinnee highlights the text in the region using the value
of the aaccttiivvee--rreeggiioonn--ssttaarrtt--ccoolloorr, which defaults to the string
that enables the terminal's standout mode. The active region
shows the text inserted by bracketed-paste and any matching text
found by incremental and non-incremental history searches.
eennaabbllee--bbrraacckkeetteedd--ppaassttee ((OOnn))
When set to OOnn, readline configures the terminal to insert each
When set to OOnn, rreeaaddlliinnee configures the terminal to insert each
paste into the editing buffer as a single string of characters,
instead of treating each character as if it had been read from
the keyboard. This is called _b_r_a_c_k_e_t_e_d_-_p_a_s_t_e _m_o_d_e; it prevents
readline from executing any editing commands bound to key se-
rreeaaddlliinnee from executing any editing commands bound to key se-
quences appearing in the pasted text.
eennaabbllee--kkeeyyppaadd ((OOffff))
When set to OOnn, readline will try to enable the application key-
When set to OOnn, rreeaaddlliinnee will try to enable the application key-
pad when it is called. Some systems need this to enable the ar-
row keys.
eennaabbllee--mmeettaa--kkeeyy ((OOnn))
When set to OOnn, readline will try to enable any meta modifier
When set to OOnn, rreeaaddlliinnee will try to enable any meta modifier
key the terminal claims to support. On many terminals, the Meta
key is used to send eight-bit characters; this variable checks
for the terminal capability that indicates the terminal can en-
@@ -342,17 +346,17 @@ IINNIITTIIAALLIIZZAATTIIOONN FFIILLEE
(0200) if the Meta key is held down when the character is typed
(a meta character).
eexxppaanndd--ttiillddee ((OOffff))
If set to OOnn, readline performs tilde expansion when it attempts
If set to OOnn, rreeaaddlliinnee performs tilde expansion when it attempts
word completion.
ffoorrccee--mmeettaa--pprreeffiixx ((OOffff))
If set to OOnn, readline modifies its behavior when binding key
If set to OOnn, rreeaaddlliinnee modifies its behavior when binding key
sequences containing \M- or Meta- (see KKeeyy BBiinnddiinnggss above) by
converting a key sequence of the form \M-_C or Meta-_C to the two-
character sequence EESSCC_C (adding the _m_e_t_a _p_r_e_f_i_x). If
ffoorrccee--mmeettaa--pprreeffiixx is set to OOffff (the default), readline uses the
character sequence EESSCC _C (adding the meta prefix). If
ffoorrccee--mmeettaa--pprreeffiixx is set to OOffff (the default), rreeaaddlliinnee uses the
value of the ccoonnvveerrtt--mmeettaa variable to determine whether to per-
form this conversion: if ccoonnvveerrtt--mmeettaa is OOnn, readline performs
the conversion described above; if it is OOffff, readline converts
form this conversion: if ccoonnvveerrtt--mmeettaa is OOnn, rreeaaddlliinnee performs
the conversion described above; if it is OOffff, rreeaaddlliinnee converts
_C to a meta character by setting the eighth bit (0200).
hhiissttoorryy--pprreesseerrvvee--ppooiinntt ((OOffff))
If set to OOnn, the history code attempts to place point at the
@@ -367,16 +371,16 @@ IINNIITTIIAALLIIZZAATTIIOONN FFIILLEE
to a non-numeric value will set the maximum number of history
entries to 500.
hhoorriizzoonnttaall--ssccrroollll--mmooddee ((OOffff))
Setting this variable to OOnn makes readline use a single line for
Setting this variable to OOnn makes rreeaaddlliinnee use a single line for
display, scrolling the input horizontally on a single screen
line when it becomes longer than the screen width rather than
wrapping to a new line. This setting is automatically enabled
for terminals of height 1.
iinnppuutt--mmeettaa ((OOffff))
If set to OOnn, readline will enable eight-bit input (that is, it
If set to OOnn, rreeaaddlliinnee will enable eight-bit input (that is, it
will not clear the eighth bit in the characters it reads), re-
gardless of what the terminal claims it can support. The de-
fault is _O_f_f, but readline will set it to _O_n if the locale con-
fault is _O_f_f, but rreeaaddlliinnee will set it to _O_n if the locale con-
tains characters whose encodings may include bytes with the
eighth bit set. This variable is dependent on the LLCC__CCTTYYPPEE lo-
cale category, and its value may change if the locale changes.
@@ -387,34 +391,34 @@ IINNIITTIIAALLIIZZAATTIIOONN FFIILLEE
mand. If this variable has not been given a value, the charac-
ters _E_S_C and _C_-_J will terminate an incremental search.
kkeeyymmaapp ((eemmaaccss))
Set the current readline keymap. The set of valid keymap names
Set the current rreeaaddlliinnee keymap. The set of valid keymap names
is _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_-_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; _e_m_a_c_s is
equivalent to _e_m_a_c_s_-_s_t_a_n_d_a_r_d. The default value is _e_m_a_c_s; the
value of eeddiittiinngg--mmooddee also affects the default keymap.
kkeeyysseeqq--ttiimmeeoouutt ((550000))
Specifies the duration _r_e_a_d_l_i_n_e will wait for a character when
Specifies the duration rreeaaddlliinnee will wait for a character when
reading an ambiguous key sequence (one that can form a complete
key sequence using the input read so far, or can take additional
input to complete a longer key sequence). If readline does not
input to complete a longer key sequence). If rreeaaddlliinnee does not
receive any input within the timeout, it will use the shorter
but complete key sequence. The value is specified in millisec-
onds, so a value of 1000 means that readline will wait one sec-
onds, so a value of 1000 means that rreeaaddlliinnee will wait one sec-
ond for additional input. If this variable is set to a value
less than or equal to zero, or to a non-numeric value, readline
less than or equal to zero, or to a non-numeric value, rreeaaddlliinnee
will wait until another key is pressed to decide which key se-
quence to complete.
mmaarrkk--ddiirreeccttoorriieess ((OOnn))
If set to OOnn, completed directory names have a slash appended.
mmaarrkk--mmooddiiffiieedd--lliinneess ((OOffff))
If set to OOnn, readline displays history lines that have been
If set to OOnn, rreeaaddlliinnee displays history lines that have been
modified with a preceding asterisk (**).
mmaarrkk--ssyymmlliinnkkeedd--ddiirreeccttoorriieess ((OOffff))
If set to OOnn, completed names which are symbolic links to direc-
tories have a slash appended, subject to the value of mmaarrkk--ddii--
rreeccttoorriieess.
mmaattcchh--hhiiddddeenn--ffiilleess ((OOnn))
This variable, when set to OOnn, forces readline to match files
This variable, when set to OOnn, forces rreeaaddlliinnee to match files
whose names begin with a "." (hidden files) when performing
filename completion. If set to OOffff, the user must include the
leading "." in the filename to be completed.
@@ -423,28 +427,28 @@ IINNIITTIIAALLIIZZAATTIIOONN FFIILLEE
list of possible completions (which may be empty) before cycling
through the list.
oouuttppuutt--mmeettaa ((OOffff))
If set to OOnn, readline will display characters with the eighth
If set to OOnn, rreeaaddlliinnee will display characters with the eighth
bit set directly rather than as a meta-prefixed escape sequence.
The default is _O_f_f, but readline will set it to _O_n if the locale
The default is _O_f_f, but rreeaaddlliinnee will set it to _O_n if the locale
contains characters whose encodings may include bytes with the
eighth bit set. This variable is dependent on the LLCC__CCTTYYPPEE lo-
cale category, and its value may change if the locale changes.
ppaaggee--ccoommpplleettiioonnss ((OOnn))
If set to OOnn, readline uses an internal _m_o_r_e-like pager to dis-
If set to OOnn, rreeaaddlliinnee uses an internal _m_o_r_e-like pager to dis-
play a screenful of possible completions at a time.
pprreeffeerr--vviissiibbllee--bbeellll
See bbeellll--ssttyyllee.
pprriinntt--ccoommpplleettiioonnss--hhoorriizzoonnttaallllyy ((OOffff))
If set to OOnn, readline will display completions with matches
If set to OOnn, rreeaaddlliinnee will display completions with matches
sorted horizontally in alphabetical order, rather than down the
screen.
rreevveerrtt--aallll--aatt--nneewwlliinnee ((OOffff))
If set to OOnn, readline will undo all changes to history lines
If set to OOnn, rreeaaddlliinnee will undo all changes to history lines
before returning when executing aacccceepptt--lliinnee. By default, his-
tory lines may be modified and retain individual undo lists
across calls to rreeaaddlliinnee(()).
sseeaarrcchh--iiggnnoorree--ccaassee ((OOffff))
If set to OOnn, readline performs incremental and non-incremental
If set to OOnn, rreeaaddlliinnee performs incremental and non-incremental
history list searches in a case-insensitive fashion.
sshhooww--aallll--iiff--aammbbiigguuoouuss ((OOffff))
This alters the default behavior of the completion functions.
@@ -466,7 +470,7 @@ IINNIITTIIAALLIIZZAATTIIOONN FFIILLEE
If set to OOnn, this alters the default completion behavior when
inserting a single match into the line. It's only active when
performing completion in the middle of a word. If enabled,
readline does not insert characters from the completion that
rreeaaddlliinnee does not insert characters from the completion that
match characters after point in the word being completed, so
portions of the word following the cursor are not duplicated.
vvii--ccmmdd--mmooddee--ssttrriinngg ((((ccmmdd))))
@@ -493,22 +497,22 @@ IINNIITTIIAALLIIZZAATTIIOONN FFIILLEE
pletions.
CCoonnddiittiioonnaall CCoonnssttrruuccttss
Readline implements a facility similar in spirit to the conditional
RReeaaddlliinnee implements a facility similar in spirit to the conditional
compilation features of the C preprocessor which allows key bindings
and variable settings to be performed as the result of tests. There
are four parser directives available.
$$iiff The $$iiff construct allows bindings to be made based on the edit-
ing mode, the terminal being used, or the application using
readline. The text of the test, after any comparison operator,
rreeaaddlliinnee. The text of the test, after any comparison operator,
extends to the end of the line; unless otherwise noted, no char-
acters are required to isolate it.
mmooddee The mmooddee== form of the $$iiff directive is used to test
whether readline is in emacs or vi mode. This may be
whether rreeaaddlliinnee is in emacs or vi mode. This may be
used in conjunction with the sseett kkeeyymmaapp command, for in-
stance, to set bindings in the _e_m_a_c_s_-_s_t_a_n_d_a_r_d and
_e_m_a_c_s_-_c_t_l_x keymaps only if readline is starting out in
_e_m_a_c_s_-_c_t_l_x keymaps only if rreeaaddlliinnee is starting out in
emacs mode.
tteerrmm The tteerrmm== form may be used to include terminal-specific
@@ -521,8 +525,8 @@ IINNIITTIIAALLIIZZAATTIIOONN FFIILLEE
vveerrssiioonn
The vveerrssiioonn test may be used to perform comparisons
against specific readline versions. The vveerrssiioonn expands
to the current readline version. The set of comparison
against specific rreeaaddlliinnee versions. The vveerrssiioonn expands
to the current rreeaaddlliinnee version. The set of comparison
operators includes ==, (and ====), !!==, <<==, >>==, <<, and >>.
The version number supplied on the right side of the op-
erator consists of a major version number, an optional
@@ -533,7 +537,7 @@ IINNIITTIIAALLIIZZAATTIIOONN FFIILLEE
_a_p_p_l_i_c_a_t_i_o_n
The _a_p_p_l_i_c_a_t_i_o_n construct is used to include application-
specific settings. Each program using the readline li-
specific settings. Each program using the rreeaaddlliinnee li-
brary sets the _a_p_p_l_i_c_a_t_i_o_n _n_a_m_e, and an initialization
file can test for a particular value. This could be used
to bind key sequences to functions useful for a specific
@@ -548,7 +552,7 @@ IINNIITTIIAALLIIZZAATTIIOONN FFIILLEE
_v_a_r_i_a_b_l_e
The _v_a_r_i_a_b_l_e construct provides simple equality tests for
readline variables and values. The permitted comparison
rreeaaddlliinnee variables and values. The permitted comparison
operators are _=, _=_=, and _!_=. The variable name must be
separated from the comparison operator by whitespace; the
operator may be separated from the value on the right
@@ -570,13 +574,13 @@ IINNIITTIIAALLIIZZAATTIIOONN FFIILLEE
$$iinncclluuddee _/_e_t_c_/_i_n_p_u_t_r_c
SSEEAARRCCHHIINNGG
Readline provides commands for searching through the command history
RReeaaddlliinnee provides commands for searching through the command history
for lines containing a specified string. There are two search modes:
_i_n_c_r_e_m_e_n_t_a_l and _n_o_n_-_i_n_c_r_e_m_e_n_t_a_l.
Incremental searches begin before the user has finished typing the
search string. As each character of the search string is typed, read-
line displays the next entry from the history matching the string typed
search string. As each character of the search string is typed, rreeaadd--
lliinnee displays the next entry from the history matching the string typed
so far. An incremental search requires only as many characters as
needed to find the desired history entry. When using emacs editing
mode, type CC--rr to search backward in the history for a particular
@@ -591,15 +595,15 @@ SSEEAARRCCHHIINNGG
To find other matching entries in the history list, type CC--rr or CC--ss as
appropriate. This will search backward or forward in the history for
the next entry matching the search string typed so far. Any other key
sequence bound to a readline command will terminate the search and exe-
sequence bound to a rreeaaddlliinnee command will terminate the search and exe-
cute that command. For instance, a newline will terminate the search
and accept the line, thereby executing the command from the history
list. A movement command will terminate the search, make the last line
found the current line, and begin editing.
Readline remembers the last incremental search string. If two CC--rrs are
RReeaaddlliinnee remembers the last incremental search string. If two CC--rrs are
typed without any intervening characters defining a new search string,
readline uses any remembered search string.
rreeaaddlliinnee uses any remembered search string.
Non-incremental searches read the entire search string before starting
to search for matching history entries. The search string may be typed
@@ -613,10 +617,11 @@ EEDDIITTIINNGG CCOOMMMMAANNDDSS
In the following descriptions, _p_o_i_n_t refers to the current cursor posi-
tion, and _m_a_r_k refers to a cursor position saved by the sseett--mmaarrkk com-
mand. The text between the point and mark is referred to as the _r_e_-
_g_i_o_n. Readline has the concept of an _a_c_t_i_v_e _r_e_g_i_o_n: when the region is
active, readline redisplay uses the value of the aaccttiivvee--rree--
ggiioonn--ssttaarrtt--ccoolloorr vvaarriiaabbllee ttoo ddeennoottee tthhee rreeggiioonn.. SSeevveerraall ccoommmmaannddss sseett
tthhee rreeggiioonn ttoo aaccttiivvee;; tthhoossee aarree nnootteedd bbeellooww..
_g_i_o_n. RReeaaddlliinnee has the concept of an _a_c_t_i_v_e _r_e_g_i_o_n: when the region is
active, rreeaaddlliinnee redisplay highlights the region using the value of the
aaccttiivvee--rreeggiioonn--ssttaarrtt--ccoolloorr variable. The eennaabbllee--aaccttiivvee--rreeggiioonn variable
turns this on and off. Several commands set the region to active;
those are noted below.
CCoommmmaannddss ffoorr MMoovviinngg
bbeeggiinnnniinngg--ooff--lliinnee ((CC--aa))
@@ -638,14 +643,14 @@ EEDDIITTIINNGG CCOOMMMMAANNDDSS
pprreevviioouuss--ssccrreeeenn--lliinnee
Attempt to move point to the same physical screen column on the
previous physical screen line. This will not have the desired
effect if the current readline line does not take up more than
effect if the current rreeaaddlliinnee line does not take up more than
one physical line or if point is not greater than the length of
the prompt plus the screen width.
nneexxtt--ssccrreeeenn--lliinnee
Attempt to move point to the same physical screen column on the
next physical screen line. This will not have the desired ef-
fect if the current readline line does not take up more than one
physical line or if the length of the current readline line is
fect if the current rreeaaddlliinnee line does not take up more than one
physical line or if the length of the current rreeaaddlliinnee line is
not greater than the length of the prompt plus the screen width.
cclleeaarr--ddiissppllaayy ((MM--CC--ll))
Clear the screen and, if possible, the terminal's scrollback
@@ -751,12 +756,13 @@ EEDDIITTIINNGG CCOOMMMMAANNDDSS
_e_n_d_-_o_f_-_f_i_l_e ((uussuuaallllyy CC--dd))
The character indicating end-of-file as set, for example, by
_s_t_t_y(1). If this character is read when there are no characters
on the line, and point is at the beginning of the line, readline
on the line, and point is at the beginning of the line, rreeaaddlliinnee
interprets it as the end of input and returns EEOOFF.
ddeelleettee--cchhaarr ((CC--dd))
Delete the character at point. If this function is bound to the
same character as the tty EEOOFF character, as CC--dd commonly is, see
above for the effects.
above for the effects. This may also be bound to the Delete key
on some keyboards.
bbaacckkwwaarrdd--ddeelleettee--cchhaarr ((RRuubboouutt))
Delete the character behind the cursor. When given a numeric
argument, save the deleted text on the kill ring.
@@ -774,7 +780,7 @@ EEDDIITTIINNGG CCOOMMMMAANNDDSS
bbrraacckkeetteedd--ppaassttee--bbeeggiinn
This function is intended to be bound to the "bracketed paste"
escape sequence sent by some terminals, and such a binding is
assigned by default. It allows readline to insert the pasted
assigned by default. It allows rreeaaddlliinnee to insert the pasted
text as a single unit without treating each character as if it
had been read from the keyboard. The pasted characters are in-
serted as if each one was bound to sseellff--iinnsseerrtt instead of exe-
@@ -888,10 +894,10 @@ EEDDIITTIINNGG CCOOMMMMAANNDDSS
back to filename completion. GGddbb, on the other hand, allows
completion of program functions and variables, and only attempts
filename completion under certain circumstances. The default
readline completion is filename completion.
rreeaaddlliinnee completion is filename completion.
ppoossssiibbllee--ccoommpplleettiioonnss ((MM--??))
List the possible completions of the text before point. When
displaying completions, readline sets the number of columns used
displaying completions, rreeaaddlliinnee sets the number of columns used
for display to the value of ccoommpplleettiioonn--ddiissppllaayy--wwiiddtthh, the value
of the environment variable CCOOLLUUMMNNSS, or the screen width, in
that order.
@@ -973,11 +979,11 @@ EEDDIITTIINNGG CCOOMMMMAANNDDSS
those defined for keys like Home and End. CSI sequences begin
with a Control Sequence Indicator (CSI), usually ESC-[. If this
sequence is bound to "\e[", keys producing CSI sequences will
have no effect unless explicitly bound to a readline command,
have no effect unless explicitly bound to a rreeaaddlliinnee command,
instead of inserting stray characters into the editing buffer.
This is unbound by default, but usually bound to ESC-[.
iinnsseerrtt--ccoommmmeenntt ((MM--##))
Without a numeric argument, insert the value of the readline
Without a numeric argument, insert the value of the rreeaaddlliinnee
ccoommmmeenntt--bbeeggiinn variable at the beginning of the current line. If
a numeric argument is supplied, this command acts as a toggle:
if the characters at the beginning of the line do not match the
@@ -989,28 +995,28 @@ EEDDIITTIINNGG CCOOMMMMAANNDDSS
causes the comment character to be removed, the line will be ex-
ecuted by the shell.
dduummpp--ffuunnccttiioonnss
Print all of the functions and their key bindings to the read-
line output stream. If a numeric argument is supplied, the out-
Print all of the functions and their key bindings to the rreeaadd--
lliinnee output stream. If a numeric argument is supplied, the out-
put is formatted in such a way that it can be made part of an
_i_n_p_u_t_r_c file.
dduummpp--vvaarriiaabblleess
Print all of the settable variables and their values to the
readline output stream. If a numeric argument is supplied, the
rreeaaddlliinnee output stream. If a numeric argument is supplied, the
output is formatted in such a way that it can be made part of an
_i_n_p_u_t_r_c file.
dduummpp--mmaaccrrooss
Print all of the readline key sequences bound to macros and the
strings they output to the readline output stream. If a numeric
Print all of the rreeaaddlliinnee key sequences bound to macros and the
strings they output to the rreeaaddlliinnee output stream. If a numeric
argument is supplied, the output is formatted in such a way that
it can be made part of an _i_n_p_u_t_r_c file.
eexxeeccuuttee--nnaammeedd--ccoommmmaanndd ((MM--xx))
Read a bindable readline command name from the input and execute
Read a bindable rreeaaddlliinnee command name from the input and execute
the function to which it's bound, as if the key sequence to
which it was bound appeared in the input. If this function is
supplied with a numeric argument, it passes that argument to the
function it executes.
eemmaaccss--eeddiittiinngg--mmooddee ((CC--ee))
When in vvii command mode, this switches readline to eemmaaccss editing
When in vvii command mode, this switches rreeaaddlliinnee to eemmaaccss editing
mode.
vvii--eeddiittiinngg--mmooddee ((MM--CC--jj))
When in eemmaaccss editing mode, this switches to vvii editing mode.
@@ -1026,7 +1032,7 @@ DDEEFFAAUULLTT KKEEYY BBIINNDDIINNGGSS
tion by _s_t_t_y(1) or the terminal driver, such as C-Z or C-C, retain that
function. Upper and lower case metafied characters are bound to the
same function in the emacs mode meta keymap. The remaining characters
are unbound, which causes readline to ring the bell (subject to the
are unbound, which causes rreeaaddlliinnee to ring the bell (subject to the
setting of the bbeellll--ssttyyllee variable).
EEmmaaccss MMooddee
@@ -1243,7 +1249,7 @@ AAUUTTHHOORRSS
chet.ramey@case.edu
BBUUGG RREEPPOORRTTSS
If you find a bug in rreeaaddlliinnee,, you should report it. But first, you
If you find a bug in rreeaaddlliinnee, you should report it. But first, you
should make sure that it really is a bug, and that it appears in the
latest version of the rreeaaddlliinnee library that you have.
lib/readline/doc/readline.3
+135 -116
View File
@@ -104,28 +104,34 @@ If an
is read with a non\-empty line, it is treated as a newline.
.SH NOTATION
.LP
This section uses an emacs-style notation to denote keystrokes.
This section uses Emacs-style editing concepts and uses its
notation for keystrokes.
Control keys are denoted by C\-\fIkey\fP, e.g., C\-n means Control\-N.
Similarly,
.I meta
keys are denoted by M\-\fIkey\fP, so M\-x means Meta\-X.
The Meta key is often labeled
.Q Alt
or
.Q Option .
.PP
On keyboards without a
.I Meta
key, M\-\fIx\fP means ESC \fIx\fP, i.e., press the Escape key
then the
key, M\-\fIx\fP means ESC \fIx\fP, i.e., press and release
the Escape key, then press and release the
.I x
key.
key, in sequence.
This makes ESC the \fImeta prefix\fP.
The combination M\-C\-\fIx\fP means ESC\-Control\-\fIx\fP,
or press the Escape key
then hold the Control key while pressing the
The combination M\-C\-\fIx\fP means ESC\-Control\-\fIx\fP:
press and release the Escape key,
then press and hold the Control key while pressing the
.I x
key.
key, then release both.
.PP
On some keyboards, the Meta key modifier produces meta characters with
the eighth bit (0200) set (you can use the \fBenable\-meta\-key\fP variable
to control whether or not it does this, if the keyboard allows it).
On some keyboards, the Meta key modifier produces characters with
the eighth bit (0200) set.
You can use the \fBenable\-meta\-key\fP variable
to control whether or not it does this, if the keyboard allows it.
On many others, the terminal or terminal emulator converts the metafied
key to a key sequence beginning with ESC as described in the
preceding paragraph.
@@ -135,7 +141,8 @@ you can make M-\fIkey\fP key bindings you specify (see
.B "Readline Key Bindings"
below) do the same thing by setting the \fBforce\-meta\-prefix\fP variable.
.PP
Readline commands may be given numeric
.B Readline
commands may be given numeric
.IR arguments ,
which normally act as a repeat count.
Sometimes, however, it is the sign of the argument that is significant.
@@ -145,6 +152,10 @@ makes that command act in a backward direction.
Commands whose behavior with arguments deviates from this are noted
below.
.PP
The \fIpoint\fP is the current cursor position, and \fImark\fP refers
to a saved cursor position.
The text between the point and mark is referred to as the \fIregion\fP.
.PP
When a command is described as \fIkilling\fP text, the text
deleted is saved for possible future retrieval
(\fIyanking\fP).
@@ -155,16 +166,17 @@ Commands which do not kill text separate the chunks of text
on the kill ring.
.SH INITIALIZATION FILE
.LP
Readline is customized by putting commands in an initialization
.B Readline
is customized by putting commands in an initialization
file (the \fIinputrc\fP file).
The name of this file is taken from the value of the
.B INPUTRC
environment variable.
If that variable is unset, the default is
.IR \*~/.inputrc .
If that file does not exist or cannot be read, readline looks for
If that file does not exist or cannot be read, \fBreadline\fP looks for
.IR /etc/inputrc .
When a program which uses the readline library starts up,
When a program which uses the \fBreadline\fP library starts up,
\fBreadline\fP reads the initialization file
and sets the key bindings and variables found there,
before reading any user input.
@@ -194,7 +206,7 @@ C\-Meta\-u: universal\-argument
.LP
into the
.I inputrc
would make M\-C\-u execute the readline command
would make M\-C\-u execute the \fBreadline\fP command
.IR universal\-argument .
.PP
Key bindings may contain the following symbolic character names:
@@ -211,7 +223,7 @@ Key bindings may contain the following symbolic character names:
and
.IR TAB .
.PP
In addition to command names, readline allows keys to be bound
In addition to command names, \fBreadline\fP allows keys to be bound
to a string that is inserted when the key is pressed (a \fImacro\fP).
The difference between a macro and a command is that a macro is
enclosed in single or double quotes.
@@ -365,7 +377,7 @@ Backslash will quote any other character in the macro text,
including \*" and \*'.
.PP
.B Bash
will display or modify the current readline key bindings with the
will display or modify the current \fBreadline\fP key bindings with the
.B bind
builtin command.
The
@@ -379,10 +391,11 @@ will change the editing mode during interactive use.
Other programs using this library provide similar mechanisms.
A user may always edit the
.I inputrc
file and have readline re-read it if a program does not provide
file and have \fBreadline\fP re-read it if a program does not provide
any other means to incorporate new bindings.
.SS Variables
Readline has variables that can be used to further customize its
.B Readline
has variables that can be used to further customize its
behavior.
A variable may be set in the
.I inputrc
@@ -392,13 +405,13 @@ file with a statement of the form
\fBset\fP \fIvariable\-name\fP \fIvalue\fP
.RE
.PP
Except where noted, readline variables can take the values
Except where noted, \fBreadline\fP variables can take the values
.B On
or
.B Off
(without regard to case).
Unrecognized variable names are ignored.
When readline reads a variable value, empty or null values,
When \fBreadline\fP reads a variable value, empty or null values,
.Q "on"
(case-insensitive), and
.Q 1
@@ -440,37 +453,37 @@ A sample value might be
.Q \ee[0m .
.TP
.B bell\-style (audible)
Controls what happens when readline wants to ring the terminal bell.
If set to \fBnone\fP, readline never rings the bell.
If set to \fBvisible\fP, readline uses a visible bell if one is available.
If set to \fBaudible\fP, readline attempts to ring the terminal's bell.
Controls what happens when \fBreadline\fP wants to ring the terminal bell.
If set to \fBnone\fP, \fBreadline\fP never rings the bell.
If set to \fBvisible\fP, \fBreadline\fP uses a visible bell if one is available.
If set to \fBaudible\fP, \fBreadline\fP attempts to ring the terminal's bell.
.TP
.B bind\-tty\-special\-chars (On)
If set to \fBOn\fP, readline attempts to bind
If set to \fBOn\fP, \fBreadline\fP attempts to bind
the control characters that are treated specially by the kernel's
terminal driver to their readline equivalents.
These override the default readline bindings described here.
terminal driver to their \fBreadline\fP equivalents.
These override the default \fBreadline\fP bindings described here.
Type
.Q "stty \-a"
at a \fBbash\fP prompt to see your current terminal settings,
including the special control characters (usually \fBcchars\fP).
.TP
.B blink\-matching\-paren (Off)
If set to \fBOn\fP, readline attempts to briefly move the cursor to an
If set to \fBOn\fP, \fBreadline\fP attempts to briefly move the cursor to an
opening parenthesis when a closing parenthesis is inserted.
.TP
.B colored\-completion\-prefix (Off)
If set to \fBOn\fP, when listing completions, readline displays the
If set to \fBOn\fP, when listing completions, \fBreadline\fP displays the
common prefix of the set of possible completions using a different color.
The color definitions are taken from the value of the \fBLS_COLORS\fP
environment variable.
If there is a color definition in \fB$LS_COLORS\fP for the custom suffix
.Q readline-colored-completion-prefix ,
readline uses this color for
.Q .readline-colored-completion-prefix ,
\fBreadline\fP uses this color for
the common prefix instead of its default.
.TP
.B colored\-stats (Off)
If set to \fBOn\fP, readline displays possible completions using different
If set to \fBOn\fP, \fBreadline\fP displays possible completions using different
colors to indicate their file type.
The color definitions are taken from the value of the \fBLS_COLORS\fP
environment variable.
@@ -480,7 +493,7 @@ environment variable.
.TP
.BR comment\-begin\ ( \c
.Q \fB#\fP \fB)\fP
The string that the readline
The string that the \fBreadline\fP
.B insert\-comment
command inserts.
This command is bound to
@@ -498,11 +511,12 @@ A value of 0 will cause matches to be displayed one per line.
The default value is \-1.
.TP
.B completion\-ignore\-case (Off)
If set to \fBOn\fP, readline performs filename matching and completion
If set to \fBOn\fP, \fBreadline\fP performs filename matching and completion
in a case\-insensitive fashion.
.TP
.B completion\-map\-case (Off)
If set to \fBOn\fP, and \fBcompletion\-ignore\-case\fP is enabled, readline
If set to \fBOn\fP, and \fBcompletion\-ignore\-case\fP is enabled,
\fBreadline\fP
treats hyphens (\fI\-\fP) and underscores (\fI_\fP) as equivalent when
performing case\-insensitive filename matching and completion.
.TP
@@ -510,7 +524,7 @@ performing case\-insensitive filename matching and completion.
The maximum
length in characters of the common prefix of a list of possible
completions that is displayed without modification.
When set to a value greater than zero, readline
When set to a value greater than zero, \fBreadline\fP
replaces common prefixes longer than this value
with an ellipsis when displaying possible completions.
.TP
@@ -521,17 +535,17 @@ generated by the \fBpossible\-completions\fP command.
It may be set to any integer value greater than or equal to zero.
If the number of possible completions is greater than
or equal to the value of this variable,
readline will ask whether or not the user wishes to view them;
otherwise readline simply lists them on the terminal.
A zero value means readline should never ask; negative values are
\fBreadline\fP will ask whether or not the user wishes to view them;
otherwise \fBreadline\fP simply lists them on the terminal.
A zero value means \fBreadline\fP should never ask; negative values are
treated as zero.
.TP
.B convert\-meta (On)
If set to \fBOn\fP, readline will convert characters it reads
If set to \fBOn\fP, \fBreadline\fP will convert characters it reads
that have the eighth bit set to an ASCII key sequence by
clearing the eighth bit and prefixing it with an escape character
(converting the character to have the \fImeta prefix\fP).
The default is \fIOn\fP, but readline will set it to \fIOff\fP
(converting the character to have the meta prefix).
The default is \fIOn\fP, but \fBreadline\fP will set it to \fIOff\fP
if the locale contains
characters whose encodings may include bytes with the eighth bit set.
This variable is dependent on the \fBLC_CTYPE\fP locale category, and
@@ -540,17 +554,17 @@ This variable also affects key bindings; see the description of
\fBforce\-meta\-prefix\fP below.
.TP
.B disable\-completion (Off)
If set to \fBOn\fP, readline will inhibit word completion.
If set to \fBOn\fP, \fBreadline\fP will inhibit word completion.
Completion characters will be inserted into the line as if they
had been mapped to \fBself-insert\fP.
.TP
.B echo\-control\-characters (On)
When set to \fBOn\fP, on operating systems that indicate they support it,
readline echoes a character corresponding to a signal generated from the
\fBreadline\fP echoes a character corresponding to a signal generated from the
keyboard.
.TP
.B editing\-mode (emacs)
Controls whether readline uses a set of key bindings similar
Controls whether \fBreadline\fP uses a set of key bindings similar
to \fIEmacs\fP or \fIvi\fP.
.B editing\-mode
can be set to either
@@ -570,32 +584,30 @@ non-printing characters, which can be used to embed a terminal control
sequence into the mode string.
.TP
.B enable\-active\-region (On)
The \fIpoint\fP is the current cursor position, and \fImark\fP refers
to a saved cursor position.
The text between the point and mark is referred to as the \fIregion\fP.
When this variable is set to \fIOn\fP, readline allows certain commands
When this variable is set to \fIOn\fP, \fBreadline\fP allows certain commands
to designate the region as \fIactive\fP.
When the region is active, readline highlights the text in the region using
When the region is active, \fBreadline\fP highlights
the text in the region using
the value of the \fBactive\-region\-start\-color\fP, which defaults to the
string that enables the terminal's standout mode.
The active region shows the text inserted by bracketed-paste and any
matching text found by incremental and non-incremental history searches.
.TP
.B enable\-bracketed\-paste (On)
When set to \fBOn\fP, readline configures the terminal to insert each
When set to \fBOn\fP, \fBreadline\fP configures the terminal to insert each
paste into the editing buffer as a single string of characters, instead
of treating each character as if it had been read from the keyboard.
This is called \fIbracketed\-paste mode\fP;
it prevents readline from executing any editing commands bound to key
it prevents \fBreadline\fP from executing any editing commands bound to key
sequences appearing in the pasted text.
.TP
.B enable\-keypad (Off)
When set to \fBOn\fP, readline will try to enable the application
When set to \fBOn\fP, \fBreadline\fP will try to enable the application
keypad when it is called.
Some systems need this to enable the arrow keys.
.TP
.B enable\-meta\-key (On)
When set to \fBOn\fP, readline will try to enable any meta modifier
When set to \fBOn\fP, \fBreadline\fP will try to enable any meta modifier
key the terminal claims to support.
On many terminals, the Meta key is used to send eight-bit characters;
this variable checks for the terminal capability that indicates the
@@ -604,24 +616,24 @@ character (0200) if the Meta key is held down when the character is
typed (a meta character).
.TP
.B expand\-tilde (Off)
If set to \fBOn\fP, readline performs tilde expansion when it
If set to \fBOn\fP, \fBreadline\fP performs tilde expansion when it
attempts word completion.
.TP
.B force\-meta\-prefix (Off)
If set to \fBOn\fP, readline modifies its behavior when binding key
If set to \fBOn\fP, \fBreadline\fP modifies its behavior when binding key
sequences containing \eM- or Meta-
(see \fBKey Bindings\fP above) by converting a key sequence of the form
\eM\-\fIC\fP or Meta\-\fIC\fP to the two-character sequence
\fBESC\fP\fIC\fP (adding the \fImeta prefix\fP).
\fBESC\fP \fIC\fP (adding the meta prefix).
If
.B force\-meta\-prefix
is set to \fBOff\fP (the default),
readline uses the value of the
\fBreadline\fP uses the value of the
.B convert\-meta
variable to determine whether to perform this conversion:
if \fBconvert\-meta\fP is \fBOn\fP,
readline performs the conversion described above;
if it is \fBOff\fP, readline converts \fIC\fP to a meta character by
\fBreadline\fP performs the conversion described above;
if it is \fBOff\fP, \fBreadline\fP converts \fIC\fP to a meta character by
setting the eighth bit (0200).
.TP
.B history\-preserve\-point (Off)
@@ -640,17 +652,17 @@ Setting \fIhistory\-size\fP to a non-numeric value will set
the maximum number of history entries to 500.
.TP
.B horizontal\-scroll\-mode (Off)
Setting this variable to \fBOn\fP makes readline use a single line
Setting this variable to \fBOn\fP makes \fBreadline\fP use a single line
for display, scrolling the input horizontally on a single screen line
when it becomes longer than the screen width rather than wrapping to
a new line.
This setting is automatically enabled for terminals of height 1.
.TP
.B input\-meta (Off)
If set to \fBOn\fP, readline will enable eight-bit input (that is, it
If set to \fBOn\fP, \fBreadline\fP will enable eight-bit input (that is, it
will not clear the eighth bit in the characters it reads),
regardless of what the terminal claims it can support.
The default is \fIOff\fP, but readline will set it to \fIOn\fP
The default is \fIOff\fP, but \fBreadline\fP will set it to \fIOn\fP
if the locale contains characters whose encodings may include bytes
with the eighth bit set.
This variable is dependent on the \fBLC_CTYPE\fP locale category, and
@@ -665,7 +677,7 @@ If this variable has not been given a value, the characters
\fIESC\fP and \fIC\-J\fP will terminate an incremental search.
.TP
.B keymap (emacs)
Set the current readline keymap.
Set the current \fBreadline\fP keymap.
The set of valid keymap names is
\fIemacs, emacs\-standard, emacs\-meta, emacs\-ctlx, vi,
vi\-command\fP, and
@@ -678,23 +690,24 @@ the value of
also affects the default keymap.
.TP
.B keyseq\-timeout (500)
Specifies the duration \fIreadline\fP will wait for a character when
Specifies the duration \fBreadline\fP will wait for a character when
reading an ambiguous key sequence
(one that can form a complete key sequence using the input read so far,
or can take additional input to complete a longer key sequence).
If readline does not receive any input within the timeout, it will use the
shorter but complete key sequence.
If \fBreadline\fP does not receive any input within the timeout,
it will use the shorter but complete key sequence.
The value is specified in milliseconds, so a value of 1000 means that
readline will wait one second for additional input.
\fBreadline\fP will wait one second for additional input.
If this variable is set to a value less than or equal to zero, or to a
non-numeric value, readline will wait until another key is pressed to
non-numeric value, \fBreadline\fP will wait until another key is pressed to
decide which key sequence to complete.
.TP
.B mark\-directories (On)
If set to \fBOn\fP, completed directory names have a slash appended.
.TP
.B mark\-modified\-lines (Off)
If set to \fBOn\fP, readline displays history lines that have been modified
If set to \fBOn\fP, \fBreadline\fP displays history lines
that have been modified
with a preceding asterisk (\fB*\fP).
.TP
.B mark\-symlinked\-directories (Off)
@@ -702,7 +715,7 @@ If set to \fBOn\fP, completed names which are symbolic links to directories
have a slash appended, subject to the value of \fBmark\-directories\fP.
.TP
.B match\-hidden\-files (On)
This variable, when set to \fBOn\fP, forces readline to match files whose
This variable, when set to \fBOn\fP, forces \fBreadline\fP to match files whose
names begin with a
.Q .
(hidden files) when performing filename completion.
@@ -716,35 +729,35 @@ list of possible completions (which may be empty) before cycling through
the list.
.TP
.B output\-meta (Off)
If set to \fBOn\fP, readline will display characters with the
If set to \fBOn\fP, \fBreadline\fP will display characters with the
eighth bit set directly rather than as a meta-prefixed escape
sequence.
The default is \fIOff\fP, but readline will set it to \fIOn\fP
The default is \fIOff\fP, but \fBreadline\fP will set it to \fIOn\fP
if the locale contains characters whose encodings may include
bytes with the eighth bit set.
This variable is dependent on the \fBLC_CTYPE\fP locale category, and
its value may change if the locale changes.
.TP
.B page\-completions (On)
If set to \fBOn\fP, readline uses an internal \fImore\fP-like pager
If set to \fBOn\fP, \fBreadline\fP uses an internal \fImore\fP-like pager
to display a screenful of possible completions at a time.
.TP
.B prefer\-visible\-bell
See \fBbell\-style\fP.
.TP
.B print\-completions\-horizontally (Off)
If set to \fBOn\fP, readline will display completions with matches
If set to \fBOn\fP, \fBreadline\fP will display completions with matches
sorted horizontally in alphabetical order, rather than down the screen.
.TP
.B revert\-all\-at\-newline (Off)
If set to \fBOn\fP, readline will undo all changes to history lines
If set to \fBOn\fP, \fBreadline\fP will undo all changes to history lines
before returning when executing \fBaccept\-line\fP.
By default,
history lines may be modified and retain individual undo lists across
calls to \fBreadline()\fP.
.TP
.B search\-ignore\-case (Off)
If set to \fBOn\fP, readline performs incremental and non-incremental
If set to \fBOn\fP, \fBreadline\fP performs incremental and non-incremental
history list searches in a case\-insensitive fashion.
.TP
.B show\-all\-if\-ambiguous (Off)
@@ -773,7 +786,7 @@ The mode strings are user-settable (e.g., \fIemacs\-mode\-string\fP).
If set to \fBOn\fP, this alters the default completion behavior when
inserting a single match into the line.
It's only active when performing completion in the middle of a word.
If enabled, readline does not insert characters from the completion
If enabled, \fBreadline\fP does not insert characters from the completion
that match characters after point in the word being completed,
so portions of the word following the cursor are not duplicated.
.TP
@@ -803,7 +816,8 @@ by \fIstat\fP(2) is appended to the filename when listing possible
completions.
.PD
.SS Conditional Constructs
Readline implements a facility similar in spirit to the conditional
.B Readline
implements a facility similar in spirit to the conditional
compilation features of the C preprocessor which allows key
bindings and variable settings to be performed as the result
of tests.
@@ -814,7 +828,7 @@ The
.B $if
construct allows bindings to be made based on the
editing mode, the terminal being used, or the application using
readline.
\fBreadline\fP.
The text of the test, after any comparison operator,
extends to the end of the line;
unless otherwise noted, no characters are required to isolate it.
@@ -822,11 +836,11 @@ unless otherwise noted, no characters are required to isolate it.
.TP
.B mode
The \fBmode=\fP form of the \fB$if\fP directive is used to test
whether readline is in emacs or vi mode.
whether \fBreadline\fP is in emacs or vi mode.
This may be used in conjunction
with the \fBset keymap\fP command, for instance, to set bindings in
the \fIemacs\-standard\fP and \fIemacs\-ctlx\fP keymaps only if
readline is starting out in emacs mode.
\fBreadline\fP is starting out in emacs mode.
.TP
.B term
The \fBterm=\fP form may be used to include terminal-specific
@@ -846,8 +860,8 @@ for instance.
.TP
.B version
The \fBversion\fP test may be used to perform comparisons against
specific readline versions.
The \fBversion\fP expands to the current readline version.
specific \fBreadline\fP versions.
The \fBversion\fP expands to the current \fBreadline\fP version.
The set of comparison operators includes
.BR = ,
(and
@@ -869,7 +883,7 @@ and from the version number argument by whitespace.
.I application
The \fIapplication\fP construct is used to include
application-specific settings.
Each program using the readline
Each program using the \fBreadline\fP
library sets the \fIapplication name\fP, and an initialization
file can test for a particular value.
This could be used to bind key sequences to functions useful for
@@ -889,7 +903,7 @@ key sequence that quotes the current or previous word in \fBbash\fP:
.RE
.TP
.I variable
The \fIvariable\fP construct provides simple equality tests for readline
The \fIvariable\fP construct provides simple equality tests for \fBreadline\fP
variables and values.
The permitted comparison operators are \fI=\fP, \fI==\fP, and \fI!=\fP.
The variable name must be separated from the comparison operator by
@@ -919,7 +933,8 @@ For example, the following directive would read \fI/etc/inputrc\fP:
.fi
.RE
.SH SEARCHING
Readline provides commands for searching through the command history
.B Readline
provides commands for searching through the command history
for lines containing a specified string.
There are two search modes:
.I incremental
@@ -928,7 +943,7 @@ and
.PP
Incremental searches begin before the user has finished typing the
search string.
As each character of the search string is typed, readline displays
As each character of the search string is typed, \fBreadline\fP displays
the next entry from the history matching the string typed so far.
An incremental search requires only as many characters as needed to
find the desired history entry.
@@ -947,16 +962,17 @@ To find other matching entries in the history list, type \fBC\-r\fP or
\fBC\-s\fP as appropriate.
This will search backward or forward in the history for the next
entry matching the search string typed so far.
Any other key sequence bound to a readline command will terminate
Any other key sequence bound to a \fBreadline\fP command will terminate
the search and execute that command.
For instance, a newline will terminate the search and accept
the line, thereby executing the command from the history list.
A movement command will terminate the search, make the last line found
the current line, and begin editing.
.PP
Readline remembers the last incremental search string.
.B Readline
remembers the last incremental search string.
If two \fBC\-r\fPs are typed without any intervening characters defining
a new search string, readline uses any remembered search string.
a new search string, \fBreadline\fP uses any remembered search string.
.PP
Non-incremental searches read the entire search string before starting
to search for matching history entries.
@@ -971,10 +987,12 @@ In the following descriptions, \fIpoint\fP refers to the current cursor
position, and \fImark\fP refers to a cursor position saved by the
\fBset\-mark\fP command.
The text between the point and mark is referred to as the \fIregion\fP.
Readline has the concept of an \fIactive region\fP:
when the region is active, readline redisplay uses the
value of the \fBactive\-region\-start\-color variable
to denote the region.
.B Readline
has the concept of an \fIactive region\fP:
when the region is active, \fBreadline\fP redisplay
highlights the region using the
value of the \fBactive-region-start-color\fP variable.
The \fBenable\-active\-region\fP variable turns this on and off.
Several commands set the region to active; those are noted below.
.SS Commands for Moving
.PD 0
@@ -1005,15 +1023,16 @@ Words are composed of alphanumeric characters (letters and digits).
Attempt to move point to the same physical screen column on the previous
physical screen line.
This will not have the desired effect if the current
readline line does not take up more than one physical line or if point is not
greater than the length of the prompt plus the screen width.
\fBreadline\fP line does not take up more than one physical line or if
point is not greater than the length of the prompt plus the screen width.
.TP
.B next\-screen\-line
Attempt to move point to the same physical screen column on the next
physical screen line.
This will not have the desired effect if the current
readline line does not take up more than one physical line or if the length
of the current readline line is not greater than the length of the prompt
\fBreadline\fP line does not take up more than one physical line or if
the length of the current \fBreadline\fP line is
not greater than the length of the prompt
plus the screen width.
.TP
.B clear\-display (M\-C\-l)
@@ -1160,7 +1179,7 @@ history expansion had been specified.
The character indicating end-of-file as set, for example, by
.IR stty (1).
If this character is read when there are no characters
on the line, and point is at the beginning of the line, readline
on the line, and point is at the beginning of the line, \fBreadline\fP
interprets it as the end of input and returns
.SM
.BR EOF .
@@ -1197,8 +1216,8 @@ This function is intended to be bound to the
.Q "bracketed paste"
escape
sequence sent by some terminals, and such a binding is assigned by default.
It allows readline to insert the pasted text as a single unit without treating
each character as if it had been read from the keyboard.
It allows \fBreadline\fP to insert the pasted text as a single unit
without treating each character as if it had been read from the keyboard.
The pasted characters
are inserted as if each one was bound to \fBself\-insert\fP instead of
executing any editing commands.
@@ -1355,11 +1374,11 @@ If none of these produces a match, it falls back to filename completion.
on the other hand,
allows completion of program functions and variables, and
only attempts filename completion under certain circumstances.
The default readline completion is filename completion.
The default \fBreadline\fP completion is filename completion.
.TP
.B possible\-completions (M\-?)
List the possible completions of the text before point.
When displaying completions, readline sets the number of columns used
When displaying completions, \fBreadline\fP sets the number of columns used
for display to the value of \fBcompletion-display-width\fP, the value of
the environment variable
.BR COLUMNS ,
@@ -1476,12 +1495,12 @@ CSI sequences begin with a Control Sequence Indicator (CSI), usually ESC\-[.
If this sequence is bound to
.Q \ee[ ,
keys producing CSI sequences will have no effect
unless explicitly bound to a readline command, instead of inserting
unless explicitly bound to a \fBreadline\fP command, instead of inserting
stray characters into the editing buffer.
This is unbound by default, but usually bound to ESC\-[.
.TP
.B insert\-comment (M\-#)
Without a numeric argument, insert the value of the readline
Without a numeric argument, insert the value of the \fBreadline\fP
.B comment\-begin
variable at the beginning of the current line.
If a numeric argument is supplied, this command acts as a toggle: if
@@ -1497,28 +1516,28 @@ will be executed by the shell.
.TP
.B dump\-functions
Print all of the functions and their key bindings
to the readline output stream.
to the \fBreadline\fP output stream.
If a numeric argument is supplied,
the output is formatted in such a way that it can be made part
of an \fIinputrc\fP file.
.TP
.B dump\-variables
Print all of the settable variables and their values
to the readline output stream.
to the \fBreadline\fP output stream.
If a numeric argument is supplied,
the output is formatted in such a way that it can be made part
of an \fIinputrc\fP file.
.TP
.B dump\-macros
Print all of the readline key sequences bound to macros and the
Print all of the \fBreadline\fP key sequences bound to macros and the
strings they output
to the readline output stream.
to the \fBreadline\fP output stream.
If a numeric argument is supplied,
the output is formatted in such a way that it can be made part
of an \fIinputrc\fP file.
.TP
.B execute\-named\-command (M-x)
Read a bindable readline command name from the input and execute the
Read a bindable \fBreadline\fP command name from the input and execute the
function to which it's bound, as if the key sequence to which it was
bound appeared in the input.
If this function is supplied with a numeric argument, it passes that
@@ -1527,7 +1546,7 @@ argument to the function it executes.
.B emacs\-editing\-mode (C\-e)
When in
.B vi
command mode, this switches readline to
command mode, this switches \fBreadline\fP to
.B emacs
editing mode.
.TP
@@ -1558,7 +1577,7 @@ or the terminal driver, such as C-Z or C-C,
retain that function.
Upper and lower case metafied characters are bound to the same function in
the emacs mode meta keymap.
The remaining characters are unbound, which causes readline
The remaining characters are unbound, which causes \fBreadline\fP
to ring the bell (subject to the setting of the
.B bell\-style
variable).
@@ -1792,7 +1811,7 @@ Chet Ramey, Case Western Reserve University
chet.ramey@case.edu
.SH BUG REPORTS
If you find a bug in
.B readline,
.BR readline ,
you should report it. But first, you should
make sure that it really is a bug, and that it appears in the latest
version of the
lib/readline/doc/readline.dvi
BIN
View File
Binary file not shown.
lib/readline/doc/readline.html
+29 -27
View File
@@ -1,6 +1,6 @@
<HTML>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- Created on October, 11 2024 by texi2html 1.64 -->
<!-- Created on October, 18 2024 by texi2html 1.64 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -99,8 +99,8 @@ command line editing interface.
<!--docid::SEC2::-->
<P>
The following paragraphs describe the notation used to represent
keystrokes.
The following paragraphs use Emacs style to
describe the notation used to represent keystrokes.
</P><P>
The text <KBD>C-k</KBD> is read as `Control-K' and describes the character
@@ -110,17 +110,17 @@ is depressed.
The text <KBD>M-k</KBD> is read as `Meta-K' and describes the character
produced when the Meta key (if you have one) is depressed, and the <KBD>k</KBD>
key is pressed (a <EM>meta character</EM>).
The Meta key is labeled <KBD>ALT</KBD> on many keyboards.
key is pressed (a <EM>meta character</EM>), then both are released.
The Meta key is labeled <KBD>ALT</KBD> or <KBD>Option</KBD> on many keyboards.
On keyboards with two keys labeled <KBD>ALT</KBD> (usually to either side of
the space bar), the <KBD>ALT</KBD> on the left side is generally set to
work as a Meta key.
The <KBD>ALT</KBD> key on the right may also be configured to work as a
Meta key or may be configured as some other modifier, such as a
One of the <KBD>ALT</KBD> keys may also be configured
as some other modifier, such as a
Compose key for typing accented characters.
</P><P>
On some keyboards, the Meta key modifier produces meta characters with
On some keyboards, the Meta key modifier produces characters with
the eighth bit (0200) set.
You can use the <CODE>enable-meta-key</CODE> variable
to control whether or not it does this, if the keyboard allows it.
@@ -528,7 +528,7 @@ commands in an <EM>inputrc</EM> file, conventionally in their home directory.
The name of this file is taken from the value of the
environment variable <CODE>INPUTRC</CODE>.
If that variable is unset, the default is <TT>`~/.inputrc'</TT>.
If that file does not exist or cannot be read, readline looks for
If that file does not exist or cannot be read, Readline looks for
<TT>`/etc/inputrc'</TT>.
</P><P>
@@ -672,7 +672,7 @@ common prefix of the set of possible completions using a different color.
The color definitions are taken from the value of the <CODE>LS_COLORS</CODE>
environment variable.
If there is a color definition in <CODE>LS_COLORS</CODE> for the custom suffix
<SAMP>`readline-colored-completion-prefix'</SAMP>, Readline uses this color for
<SAMP>`.readline-colored-completion-prefix'</SAMP>, Readline uses this color for
the common prefix instead of its default.
The default is <SAMP>`off'</SAMP>.
<P>
@@ -723,7 +723,7 @@ The default value is <SAMP>`off'</SAMP>.
The maximum
length in characters of the common prefix of a list of possible
completions that is displayed without modification.
When set to a value greater than zero, readline
When set to a value greater than zero, Readline
replaces common prefixes longer than this value
with an ellipsis when displaying possible completions.
<P>
@@ -856,7 +856,7 @@ sequences containing <KBD>\M-</KBD> or <CODE>Meta-</CODE>
(see <CODE>Key Bindings</CODE> in <A HREF="readline.html#SEC10">1.3.1 Readline Init File Syntax</A>)
by converting a key sequence of the form
<KBD>\M-</KBD><VAR>C</VAR> or <CODE>Meta-</CODE><VAR>C</VAR> to the two-character sequence
<KBD>ESC</KBD><VAR>C</VAR> (adding the meta prefix).
<KBD>ESC</KBD> <VAR>C</VAR> (adding the meta prefix).
If <CODE>force-meta-prefix</CODE> is set to <SAMP>`off'</SAMP> (the default),
Readline uses the value of the <CODE>convert-meta</CODE> variable to determine
whether to perform this conversion:
@@ -1074,7 +1074,7 @@ The default value is <SAMP>`off'</SAMP>.
If set to <SAMP>`on'</SAMP>, this alters the default completion behavior when
inserting a single match into the line.
It's only active when performing completion in the middle of a word.
If enabled, readline does not insert characters from the completion
If enabled, Readline does not insert characters from the completion
that match characters after point in the word being completed,
so portions of the word following the cursor are not duplicated.
For instance, if this is enabled, attempting completion when the cursor
@@ -1171,7 +1171,7 @@ This key binding syntax recognizes a number of symbolic character names:
<VAR>NEWLINE</VAR>,
<VAR>RET</VAR>,
<VAR>RETURN</VAR>,
<VAR>RUBOUT</VAR>,
<VAR>RUBOUT</VAR> (a destructive backspace),
<VAR>SPACE</VAR>,
<VAR>SPC</VAR>,
and
@@ -1562,9 +1562,10 @@ position, and <EM>mark</EM> refers to a cursor position saved by the
<CODE>set-mark</CODE> command.
The text between the point and mark is referred to as the <EM>region</EM>.
Readline has the concept of an <EM>active region</EM>:
when the region is active, Readline redisplay uses the
value of the <CODE>active-region-start-color</CODE> variable
to denote the region.
when the region is active,
Readline redisplay highlights the region using the
value of the <CODE>active-region-start-color</CODE> variable.
The <CODE>enable-active-region</CODE> variable turns this on and off.
Several commands set the region to active; those are noted below.
</P><P>
@@ -1896,6 +1897,7 @@ Delete the character at point.
If this function is bound to the
same character as the tty EOF character, as <KBD>C-d</KBD>
commonly is, see above for the effects.
This may also be bound to the Delete key on some keyboards.
<P>
<A NAME="IDX111"></A>
@@ -2486,7 +2488,7 @@ This command is unbound by default.
<A NAME="IDX221"></A>
<DT><CODE>execute-named-command (M-x)</CODE>
<DD><A NAME="IDX222"></A>
Read a bindable readline command name from the input and execute the
Read a bindable Readline command name from the input and execute the
function to which it's bound, as if the key sequence to which it was
bound appeared in the input.
If this function is supplied with a numeric argument, it passes that
@@ -2649,8 +2651,8 @@ Since it's possible to enter characters into the line while quoting
them to disable any Readline editing function they might normally have,
this line may include embedded newlines and other special characters.
If <VAR>prompt</VAR> is <CODE>NULL</CODE> or the empty string,
<CODE>readline</CODE> does not display a prompt.
The line <CODE>readline</CODE> returns is allocated with <CODE>malloc()</CODE>;
<CODE>readline()</CODE> does not display a prompt.
The line <CODE>readline()</CODE> returns is allocated with <CODE>malloc()</CODE>;
the caller should <CODE>free()</CODE> the line when it has finished with it.
The declaration for <CODE>readline</CODE> in ANSI C is
</P><P>
@@ -2666,9 +2668,9 @@ text remains.
This means that lines consisting of a newline return the empty string.
</P><P>
If <CODE>readline</CODE> encounters an <CODE>EOF</CODE> while reading the line,
If Readline encounters an <CODE>EOF</CODE> while reading the line,
and the line is empty at that point,
then <CODE>readline</CODE> returns <CODE>(char *)NULL</CODE>.
then <CODE>readline()</CODE> returns <CODE>(char *)NULL</CODE>.
Otherwise, the line is ended just as if a newline had been typed.
</P><P>
@@ -3201,7 +3203,7 @@ twice in succession, for example.
<DL>
<DT><U>Variable:</U> rl_hook_func_t * <B>rl_startup_hook</B>
<DD>If non-zero, this is the address of a function to call just
before <CODE>readline</CODE> prints the first prompt.
before Readline prints the first prompt.
</DL>
</P><P>
@@ -3209,7 +3211,7 @@ before <CODE>readline</CODE> prints the first prompt.
<DL>
<DT><U>Variable:</U> rl_hook_func_t * <B>rl_pre_input_hook</B>
<DD>If non-zero, this is the address of a function to call after
the first prompt has been printed and just before <CODE>readline</CODE>
the first prompt has been printed and just before Readline
starts reading input characters.
</DL>
</P><P>
@@ -3415,7 +3417,7 @@ macro.
<DT><CODE>RL_STATE_COMPLETING</CODE>
<DD>Readline is performing word completion.
<DT><CODE>RL_STATE_SIGHANDLER</CODE>
<DD>Readline is currently executing the readline signal handler.
<DD>Readline is currently executing the Readline signal handler.
<DT><CODE>RL_STATE_UNDOING</CODE>
<DD>Readline is performing an undo.
<DT><CODE>RL_STATE_INPUTPENDING</CODE>
@@ -8127,7 +8129,7 @@ to permit their use in free software.
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="readline.html#SEC_About"> ? </A>]</TD>
</TR></TABLE>
<H1>About this document</H1>
This document was generated by <I>Chet Ramey</I> on <I>October, 11 2024</I>
This document was generated by <I>Chet Ramey</I> on <I>October, 18 2024</I>
using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
"><I>texi2html</I></A>
<P></P>
@@ -8289,7 +8291,7 @@ the following structure:
<BR>
<FONT SIZE="-1">
This document was generated
by <I>Chet Ramey</I> on <I>October, 11 2024</I>
by <I>Chet Ramey</I> on <I>October, 18 2024</I>
using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
"><I>texi2html</I></A>
lib/readline/doc/readline.info
+100 -99
View File
@@ -1,6 +1,6 @@
This is readline.info, produced by makeinfo version 7.1 from rlman.texi.
This manual describes the GNU Readline Library (version 8.3, 10 October
This manual describes the GNU Readline Library (version 8.3, 15 October
2024), a library which aids in the consistency of user interface across
discrete programs which provide a command line interface.
@@ -63,27 +63,26 @@ File: readline.info, Node: Introduction and Notation, Next: Readline Interacti
1.1 Introduction to Line Editing
================================
The following paragraphs describe the notation used to represent
keystrokes.
The following paragraphs use Emacs style to describe the notation used
to represent keystrokes.
The text ‘C-k’ is read as 'Control-K' and describes the character
produced when the <k> key is pressed while the Control key is depressed.
The text ‘M-k’ is read as 'Meta-K' and describes the character
produced when the Meta key (if you have one) is depressed, and the <k>
key is pressed (a “meta character”). The Meta key is labeled <ALT> on
many keyboards. On keyboards with two keys labeled <ALT> (usually to
either side of the space bar), the <ALT> on the left side is generally
set to work as a Meta key. The <ALT> key on the right may also be
configured to work as a Meta key or may be configured as some other
modifier, such as a Compose key for typing accented characters.
key is pressed (a “meta character”), then both are released. The Meta
key is labeled <ALT> or <Option> on many keyboards. On keyboards with
two keys labeled <ALT> (usually to either side of the space bar), the
<ALT> on the left side is generally set to work as a Meta key. One of
the <ALT> keys may also be configured as some other modifier, such as a
Compose key for typing accented characters.
On some keyboards, the Meta key modifier produces meta characters
with the eighth bit (0200) set. You can use the ‘enable-meta-key’
variable to control whether or not it does this, if the keyboard allows
it. On many others, the terminal or terminal emulator converts the
metafied key to a key sequence beginning with <ESC> as described in the
next paragraph.
On some keyboards, the Meta key modifier produces characters with the
eighth bit (0200) set. You can use the ‘enable-meta-key’ variable to
control whether or not it does this, if the keyboard allows it. On many
others, the terminal or terminal emulator converts the metafied key to a
key sequence beginning with <ESC> as described in the next paragraph.
If you do not have a Meta or <ALT> key, or another key working as a
Meta key, you can generally achieve the latter effect by typing <ESC>
@@ -328,7 +327,7 @@ putting commands in an “inputrc” file, conventionally in their home
directory. The name of this file is taken from the value of the
environment variable ‘INPUTRC’. If that variable is unset, the default
is ‘~/.inputrc’. If that file does not exist or cannot be read,
readline looks for ‘/etc/inputrc’.
Readline looks for ‘/etc/inputrc’.
When a program which uses the Readline library starts up, Readline
reads the init file and sets any variables and key bindings it contains.
@@ -428,9 +427,9 @@ Variable Settings
different color. The color definitions are taken from the
value of the ‘LS_COLORS’ environment variable. If there is a
color definition in ‘LS_COLORS’ for the custom suffix
‘readline-colored-completion-prefix’, Readline uses this color
for the common prefix instead of its default. The default is
‘off’.
‘.readline-colored-completion-prefix’, Readline uses this
color for the common prefix instead of its default. The
default is ‘off’.
‘colored-stats’
If set to ‘on’, Readline displays possible completions using
@@ -463,7 +462,7 @@ Variable Settings
‘completion-prefix-display-length’
The maximum length in characters of the common prefix of a
list of possible completions that is displayed without
modification. When set to a value greater than zero, readline
modification. When set to a value greater than zero, Readline
replaces common prefixes longer than this value with an
ellipsis when displaying possible completions.
@@ -562,7 +561,7 @@ Variable Settings
key sequences containing ‘\M-’ or ‘Meta-’ (see ‘Key Bindings’
in *note Readline Init File Syntax::) by converting a key
sequence of the form ‘\M-’C or ‘Meta-’C to the two-character
sequence ‘ESC’C (adding the meta prefix). If
sequence ‘ESC’ C (adding the meta prefix). If
‘force-meta-prefix’ is set to ‘off’ (the default), Readline
uses the value of the ‘convert-meta’ variable to determine
whether to perform this conversion: if ‘convert-meta’ is ‘on’,
@@ -722,7 +721,7 @@ Variable Settings
If set to ‘on’, this alters the default completion behavior
when inserting a single match into the line. It's only active
when performing completion in the middle of a word. If
enabled, readline does not insert characters from the
enabled, Readline does not insert characters from the
completion that match characters after point in the word being
completed, so portions of the word following the cursor are
not duplicated. For instance, if this is enabled, attempting
@@ -792,7 +791,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
@@ -1090,9 +1089,10 @@ unbound by default.
position, and “mark” refers to a cursor position saved by the ‘set-mark’
command. The text between the point and mark is referred to as the
“region”. Readline has the concept of an _active region_: when the
region is active, Readline redisplay uses the value of the
‘active-region-start-color’ variable to denote the region. Several
commands set the region to active; those are noted below.
region is active, Readline redisplay highlights the region using the
value of the ‘active-region-start-color’ variable. The
‘enable-active-region’ variable turns this on and off. Several commands
set the region to active; those are noted below.

File: readline.info, Node: Commands For Moving, Next: Commands For History, Up: Bindable Readline Commands
@@ -1273,7 +1273,8 @@ File: readline.info, Node: Commands For Text, Next: Commands For Killing, Pre
‘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
@@ -1591,7 +1592,7 @@ File: readline.info, Node: Miscellaneous Commands, Prev: Keyboard Macros, Up:
default.
‘execute-named-command (M-x)’
Read a bindable readline command name from the input and execute
Read a bindable Readline command name from the input and execute
the function to which it's bound, as if the key sequence to which
it was bound appeared in the input. If this function is supplied
with a numeric argument, it passes that argument to the function it
@@ -1688,10 +1689,10 @@ returns a single line of text from the user. Since it's possible to
enter characters into the line while quoting them to disable any
Readline editing function they might normally have, this line may
include embedded newlines and other special characters. If PROMPT is
‘NULL’ or the empty string, ‘readline’ does not display a prompt. The
line ‘readline’ returns is allocated with ‘malloc()’; the caller should
‘free()’ the line when it has finished with it. The declaration for
‘readline’ in ANSI C is
‘NULL’ or the empty string, ‘readline()’ does not display a prompt. The
line ‘readline()’ returns is allocated with ‘malloc()’; the caller
should ‘free()’ the line when it has finished with it. The declaration
for ‘readline’ in ANSI C is
char *readline (const char *PROMPT);
@@ -1701,8 +1702,8 @@ in order to read a line of text from the user. The line returned has
the final newline removed, so only the text remains. This means that
lines consisting of a newline return the empty string.
If ‘readline’ encounters an ‘EOF’ while reading the line, and the
line is empty at that point, then ‘readline’ returns ‘(char *)NULL’.
If Readline encounters an ‘EOF’ while reading the line, and the line
is empty at that point, then ‘readline()’ returns ‘(char *)NULL’.
Otherwise, the line is ended just as if a newline had been typed.
Readline performs some expansion on the PROMPT before it is displayed
@@ -2027,11 +2028,11 @@ These variables are available to function writers.
-- Variable: rl_hook_func_t * rl_startup_hook
If non-zero, this is the address of a function to call just before
‘readline’ prints the first prompt.
Readline prints the first prompt.
-- Variable: rl_hook_func_t * rl_pre_input_hook
If non-zero, this is the address of a function to call after the
first prompt has been printed and just before ‘readline’ starts
first prompt has been printed and just before Readline starts
reading input characters.
-- Variable: rl_hook_func_t * rl_event_hook
@@ -2172,7 +2173,7 @@ These variables are available to function writers.
‘RL_STATE_COMPLETING’
Readline is performing word completion.
‘RL_STATE_SIGHANDLER’
Readline is currently executing the readline signal handler.
Readline is currently executing the Readline signal handler.
‘RL_STATE_UNDOING’
Readline is performing an undo.
‘RL_STATE_INPUTPENDING’
@@ -4884,7 +4885,7 @@ Function and Variable Index
* active-region-start-color: Readline Init File Syntax.
(line 35)
* 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.
@@ -4899,9 +4900,9 @@ Function and Variable Index
(line 68)
* blink-matching-paren: Readline Init File Syntax.
(line 76)
* bracketed-paste-begin (): Commands For Text. (line 37)
* bracketed-paste-begin (): Commands For Text. (line 38)
* call-last-kbd-macro (C-x e): Keyboard Macros. (line 13)
* capitalize-word (M-c): Commands For Text. (line 68)
* capitalize-word (M-c): Commands For Text. (line 69)
* character-search (C-]): Miscellaneous Commands.
(line 41)
* character-search-backward (M-C-]): Miscellaneous Commands.
@@ -4944,7 +4945,7 @@ Function and Variable Index
(line 149)
* do-lowercase-version (M-A, M-B, M-X, ...): Miscellaneous Commands.
(line 14)
* downcase-word (M-l): Commands For Text. (line 64)
* downcase-word (M-l): Commands For Text. (line 65)
* dump-functions (): Miscellaneous Commands.
(line 68)
* dump-macros (): Miscellaneous Commands.
@@ -4982,7 +4983,7 @@ Function and Variable Index
(line 105)
* force-meta-prefix: Readline Init File Syntax.
(line 216)
* 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 32)
@@ -5044,7 +5045,7 @@ Function and Variable Index
(line 98)
* output-meta: Readline Init File Syntax.
(line 322)
* overwrite-mode (): Commands For Text. (line 72)
* overwrite-mode (): Commands For Text. (line 73)
* page-completions: Readline Init File Syntax.
(line 331)
* possible-completions (M-?): Commands For Completion.
@@ -5055,7 +5056,7 @@ Function and Variable Index
(line 12)
* previous-screen-line (): Commands For Moving. (line 28)
* 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)
* readline: Basic Behavior. (line 11)
@@ -5361,7 +5362,7 @@ Function and Variable Index
(line 28)
* search-ignore-case: Readline Init File Syntax.
(line 351)
* self-insert (a, b, A, 1, !, ...): Commands For Text. (line 34)
* self-insert (a, b, A, 1, !, ...): Commands For Text. (line 35)
* set-mark (C-@): Miscellaneous Commands.
(line 33)
* show-all-if-ambiguous: Readline Init File Syntax.
@@ -5375,11 +5376,11 @@ Function and Variable Index
* skip-csi-sequence (): Miscellaneous Commands.
(line 50)
* start-kbd-macro (C-x (): Keyboard Macros. (line 6)
* tab-insert (M-<TAB>): Commands For Text. (line 31)
* tab-insert (M-<TAB>): Commands For Text. (line 32)
* tilde-expand (M-~): Miscellaneous Commands.
(line 30)
* transpose-chars (C-t): Commands For Text. (line 49)
* transpose-words (M-t): Commands For Text. (line 55)
* transpose-chars (C-t): Commands For Text. (line 50)
* transpose-words (M-t): Commands For Text. (line 56)
* undo (C-_ or C-x C-u): Miscellaneous Commands.
(line 23)
* universal-argument (): Numeric Arguments. (line 10)
@@ -5389,7 +5390,7 @@ Function and Variable Index
(line 16)
* unix-word-rubout (C-w): Commands For Killing.
(line 32)
* upcase-word (M-u): Commands For Text. (line 60)
* upcase-word (M-u): Commands For Text. (line 61)
* vi-cmd-mode-string: Readline Init File Syntax.
(line 390)
* vi-editing-mode (M-C-j): Miscellaneous Commands.
@@ -5413,56 +5414,56 @@ Tag Table:
Node: Top863
Node: Command Line Editing1588
Node: Introduction and Notation2240
Node: Readline Interaction4594
Node: Readline Bare Essentials5786
Node: Readline Movement Commands7598
Node: Readline Killing Commands8598
Node: Readline Arguments10625
Node: Searching11686
Node: Readline Init File13917
Node: Readline Init File Syntax15115
Node: Conditional Init Constructs41480
Node: Sample Init File45869
Node: Bindable Readline Commands48994
Node: Commands For Moving50312
Node: Commands For History52242
Node: Commands For Text57447
Node: Commands For Killing61226
Node: Numeric Arguments63682
Node: Commands For Completion64838
Node: Keyboard Macros66925
Node: Miscellaneous Commands67630
Node: Readline vi Mode71954
Node: Programming with GNU Readline73851
Node: Basic Behavior74837
Node: Custom Functions78900
Node: Readline Typedefs80422
Node: Function Writing82308
Node: Readline Variables83614
Node: Readline Convenience Functions98580
Node: Function Naming99656
Node: Keymaps100987
Node: Binding Keys104149
Node: Associating Function Names and Bindings108974
Node: Allowing Undoing112804
Node: Redisplay115554
Node: Modifying Text119856
Node: Character Input121395
Node: Terminal Management124552
Node: Utility Functions126439
Node: Miscellaneous Functions129549
Node: Alternate Interface133439
Node: A Readline Example136334
Node: Alternate Interface Example138252
Node: Readline Signal Handling141871
Node: Custom Completers151421
Node: How Completing Works152141
Node: Completion Functions155517
Node: Completion Variables159184
Node: A Short Completion Example177502
Node: GNU Free Documentation License190171
Node: Concept Index215348
Node: Function and Variable Index216869
Node: Readline Interaction4596
Node: Readline Bare Essentials5788
Node: Readline Movement Commands7600
Node: Readline Killing Commands8600
Node: Readline Arguments10627
Node: Searching11688
Node: Readline Init File13919
Node: Readline Init File Syntax15117
Node: Conditional Init Constructs41510
Node: Sample Init File45899
Node: Bindable Readline Commands49024
Node: Commands For Moving50408
Node: Commands For History52338
Node: Commands For Text57543
Node: Commands For Killing61388
Node: Numeric Arguments63844
Node: Commands For Completion65000
Node: Keyboard Macros67087
Node: Miscellaneous Commands67792
Node: Readline vi Mode72116
Node: Programming with GNU Readline74013
Node: Basic Behavior74999
Node: Custom Functions79062
Node: Readline Typedefs80584
Node: Function Writing82470
Node: Readline Variables83776
Node: Readline Convenience Functions98730
Node: Function Naming99806
Node: Keymaps101137
Node: Binding Keys104299
Node: Associating Function Names and Bindings109124
Node: Allowing Undoing112954
Node: Redisplay115704
Node: Modifying Text120006
Node: Character Input121545
Node: Terminal Management124702
Node: Utility Functions126589
Node: Miscellaneous Functions129699
Node: Alternate Interface133589
Node: A Readline Example136484
Node: Alternate Interface Example138402
Node: Readline Signal Handling142021
Node: Custom Completers151571
Node: How Completing Works152291
Node: Completion Functions155667
Node: Completion Variables159334
Node: A Short Completion Example177652
Node: GNU Free Documentation License190321
Node: Concept Index215498
Node: Function and Variable Index217019

End Tag Table
lib/readline/doc/readline.pdf
BIN
View File
Binary file not shown.
lib/readline/doc/readline.ps
+558 -554
View File
File diff suppressed because it is too large Load Diff
lib/readline/doc/readline_3.pdf
BIN
View File
Binary file not shown.
lib/readline/doc/rlman.aux
+44 -44
View File
@@ -9,17 +9,17 @@
@xrdef{Command Line Editing-pg}{1}
@xrdef{Introduction and Notation-pg}{1}
@xrdef{Readline Interaction-pg}{1}
@xrdef{Readline Bare Essentials-pg}{1}
@xrdef{Readline Movement Commands-title}{Readline Movement Commands}
@xrdef{Readline Movement Commands-snt}{Section@tie 1.2.2}
@xrdef{Readline Killing Commands-title}{Readline Killing Commands}
@xrdef{Readline Killing Commands-snt}{Section@tie 1.2.3}
@xrdef{Readline Bare Essentials-pg}{2}
@xrdef{Readline Movement Commands-pg}{2}
@xrdef{Readline Killing Commands-pg}{2}
@xrdef{Readline Arguments-title}{Readline Arguments}
@xrdef{Readline Arguments-snt}{Section@tie 1.2.4}
@xrdef{Searching-title}{Searching for Commands in the History}
@xrdef{Searching-snt}{Section@tie 1.2.5}
@xrdef{Readline Killing Commands-pg}{3}
@xrdef{Readline Arguments-pg}{3}
@xrdef{Searching-pg}{3}
@xrdef{Readline Init File-title}{Readline Init File}
@@ -30,127 +30,127 @@
@xrdef{Readline Init File Syntax-pg}{4}
@xrdef{Conditional Init Constructs-title}{Conditional Init Constructs}
@xrdef{Conditional Init Constructs-snt}{Section@tie 1.3.2}
@xrdef{Conditional Init Constructs-pg}{12}
@xrdef{Conditional Init Constructs-pg}{14}
@xrdef{Sample Init File-title}{Sample Init File}
@xrdef{Sample Init File-snt}{Section@tie 1.3.3}
@xrdef{Sample Init File-pg}{13}
@xrdef{Sample Init File-pg}{15}
@xrdef{Bindable Readline Commands-title}{Bindable Readline Commands}
@xrdef{Bindable Readline Commands-snt}{Section@tie 1.4}
@xrdef{Commands For Moving-title}{Commands For Moving}
@xrdef{Commands For Moving-snt}{Section@tie 1.4.1}
@xrdef{Bindable Readline Commands-pg}{16}
@xrdef{Commands For Moving-pg}{16}
@xrdef{Bindable Readline Commands-pg}{18}
@xrdef{Commands For Moving-pg}{18}
@xrdef{Commands For History-title}{Commands For Manipulating The History}
@xrdef{Commands For History-snt}{Section@tie 1.4.2}
@xrdef{Commands For History-pg}{17}
@xrdef{Commands For History-pg}{19}
@xrdef{Commands For Text-title}{Commands For Changing Text}
@xrdef{Commands For Text-snt}{Section@tie 1.4.3}
@xrdef{Commands For Text-pg}{18}
@xrdef{Commands For Text-pg}{21}
@xrdef{Commands For Killing-title}{Killing And Yanking}
@xrdef{Commands For Killing-snt}{Section@tie 1.4.4}
@xrdef{Commands For Killing-pg}{19}
@xrdef{Commands For Killing-pg}{22}
@xrdef{Numeric Arguments-title}{Specifying Numeric Arguments}
@xrdef{Numeric Arguments-snt}{Section@tie 1.4.5}
@xrdef{Numeric Arguments-pg}{20}
@xrdef{Commands For Completion-title}{Letting Readline Type For You}
@xrdef{Commands For Completion-snt}{Section@tie 1.4.6}
@xrdef{Numeric Arguments-pg}{23}
@xrdef{Keyboard Macros-title}{Keyboard Macros}
@xrdef{Keyboard Macros-snt}{Section@tie 1.4.7}
@xrdef{Commands For Completion-pg}{21}
@xrdef{Keyboard Macros-pg}{21}
@xrdef{Miscellaneous Commands-title}{Some Miscellaneous Commands}
@xrdef{Miscellaneous Commands-snt}{Section@tie 1.4.8}
@xrdef{Miscellaneous Commands-pg}{22}
@xrdef{Commands For Completion-pg}{24}
@xrdef{Keyboard Macros-pg}{24}
@xrdef{Miscellaneous Commands-pg}{25}
@xrdef{Readline vi Mode-title}{Readline vi Mode}
@xrdef{Readline vi Mode-snt}{Section@tie 1.5}
@xrdef{Readline vi Mode-pg}{23}
@xrdef{Readline vi Mode-pg}{26}
@xrdef{Programming with GNU Readline-title}{Programming with GNU Readline}
@xrdef{Programming with GNU Readline-snt}{Chapter@tie 2}
@xrdef{Basic Behavior-title}{Basic Behavior}
@xrdef{Basic Behavior-snt}{Section@tie 2.1}
@xrdef{Programming with GNU Readline-pg}{24}
@xrdef{Basic Behavior-pg}{24}
@xrdef{Programming with GNU Readline-pg}{27}
@xrdef{Basic Behavior-pg}{27}
@xrdef{Custom Functions-title}{Custom Functions}
@xrdef{Custom Functions-snt}{Section@tie 2.2}
@xrdef{Custom Functions-pg}{25}
@xrdef{Custom Functions-pg}{28}
@xrdef{Readline Typedefs-title}{Readline Typedefs}
@xrdef{Readline Typedefs-snt}{Section@tie 2.2.1}
@xrdef{Function Writing-title}{Writing a New Function}
@xrdef{Function Writing-snt}{Section@tie 2.2.2}
@xrdef{Readline Typedefs-pg}{26}
@xrdef{Function Writing-pg}{26}
@xrdef{Readline Typedefs-pg}{29}
@xrdef{Readline Variables-title}{Readline Variables}
@xrdef{Readline Variables-snt}{Section@tie 2.3}
@xrdef{Readline Variables-pg}{27}
@xrdef{Function Writing-pg}{30}
@xrdef{Readline Variables-pg}{30}
@xrdef{Readline Convenience Functions-title}{Readline Convenience Functions}
@xrdef{Readline Convenience Functions-snt}{Section@tie 2.4}
@xrdef{Function Naming-title}{Naming a Function}
@xrdef{Function Naming-snt}{Section@tie 2.4.1}
@xrdef{Keymaps-title}{Selecting a Keymap}
@xrdef{Keymaps-snt}{Section@tie 2.4.2}
@xrdef{Readline Convenience Functions-pg}{32}
@xrdef{Function Naming-pg}{32}
@xrdef{Readline Convenience Functions-pg}{36}
@xrdef{Function Naming-pg}{36}
@xrdef{Keymaps-pg}{36}
@xrdef{Binding Keys-title}{Binding Keys}
@xrdef{Binding Keys-snt}{Section@tie 2.4.3}
@xrdef{Keymaps-pg}{33}
@xrdef{Binding Keys-pg}{33}
@xrdef{Binding Keys-pg}{37}
@xrdef{Associating Function Names and Bindings-title}{Associating Function Names and Bindings}
@xrdef{Associating Function Names and Bindings-snt}{Section@tie 2.4.4}
@xrdef{Associating Function Names and Bindings-pg}{35}
@xrdef{Associating Function Names and Bindings-pg}{39}
@xrdef{Allowing Undoing-title}{Allowing Undoing}
@xrdef{Allowing Undoing-snt}{Section@tie 2.4.5}
@xrdef{Allowing Undoing-pg}{36}
@xrdef{Allowing Undoing-pg}{40}
@xrdef{Redisplay-title}{Redisplay}
@xrdef{Redisplay-snt}{Section@tie 2.4.6}
@xrdef{Redisplay-pg}{37}
@xrdef{Redisplay-pg}{41}
@xrdef{Modifying Text-title}{Modifying Text}
@xrdef{Modifying Text-snt}{Section@tie 2.4.7}
@xrdef{Modifying Text-pg}{38}
@xrdef{Character Input-title}{Character Input}
@xrdef{Character Input-snt}{Section@tie 2.4.8}
@xrdef{Modifying Text-pg}{43}
@xrdef{Character Input-pg}{43}
@xrdef{Terminal Management-title}{Terminal Management}
@xrdef{Terminal Management-snt}{Section@tie 2.4.9}
@xrdef{Character Input-pg}{39}
@xrdef{Terminal Management-pg}{39}
@xrdef{Terminal Management-pg}{44}
@xrdef{Utility Functions-title}{Utility Functions}
@xrdef{Utility Functions-snt}{Section@tie 2.4.10}
@xrdef{Utility Functions-pg}{40}
@xrdef{Utility Functions-pg}{45}
@xrdef{Miscellaneous Functions-title}{Miscellaneous Functions}
@xrdef{Miscellaneous Functions-snt}{Section@tie 2.4.11}
@xrdef{Miscellaneous Functions-pg}{41}
@xrdef{Miscellaneous Functions-pg}{46}
@xrdef{Alternate Interface-title}{Alternate Interface}
@xrdef{Alternate Interface-snt}{Section@tie 2.4.12}
@xrdef{Alternate Interface-pg}{42}
@xrdef{Alternate Interface-pg}{47}
@xrdef{A Readline Example-title}{A Readline Example}
@xrdef{A Readline Example-snt}{Section@tie 2.4.13}
@xrdef{A Readline Example-pg}{43}
@xrdef{A Readline Example-pg}{48}
@xrdef{Alternate Interface Example-title}{Alternate Interface Example}
@xrdef{Alternate Interface Example-snt}{Section@tie 2.4.14}
@xrdef{Alternate Interface Example-pg}{44}
@xrdef{Alternate Interface Example-pg}{50}
@xrdef{Readline Signal Handling-title}{Readline Signal Handling}
@xrdef{Readline Signal Handling-snt}{Section@tie 2.5}
@xrdef{Readline Signal Handling-pg}{47}
@xrdef{Readline Signal Handling-pg}{52}
@xrdef{Custom Completers-title}{Custom Completers}
@xrdef{Custom Completers-snt}{Section@tie 2.6}
@xrdef{How Completing Works-title}{How Completing Works}
@xrdef{How Completing Works-snt}{Section@tie 2.6.1}
@xrdef{Custom Completers-pg}{49}
@xrdef{Custom Completers-pg}{55}
@xrdef{How Completing Works-pg}{55}
@xrdef{Completion Functions-title}{Completion Functions}
@xrdef{Completion Functions-snt}{Section@tie 2.6.2}
@xrdef{How Completing Works-pg}{50}
@xrdef{Completion Functions-pg}{50}
@xrdef{Completion Functions-pg}{56}
@xrdef{Completion Variables-title}{Completion Variables}
@xrdef{Completion Variables-snt}{Section@tie 2.6.3}
@xrdef{Completion Variables-pg}{52}
@xrdef{Completion Variables-pg}{57}
@xrdef{A Short Completion Example-title}{A Short Completion Example}
@xrdef{A Short Completion Example-snt}{Section@tie 2.6.4}
@xrdef{A Short Completion Example-pg}{56}
@xrdef{A Short Completion Example-pg}{63}
@xrdef{GNU Free Documentation License-title}{GNU Free Documentation License}
@xrdef{GNU Free Documentation License-snt}{Appendix@tie @char65{}}
@xrdef{GNU Free Documentation License-pg}{65}
@xrdef{GNU Free Documentation License-pg}{72}
@xrdef{Concept Index-title}{Concept Index}
@xrdef{Concept Index-snt}{}
@xrdef{Concept Index-pg}{73}
@xrdef{Concept Index-pg}{80}
@xrdef{Function and Variable Index-title}{Function and Variable Index}
@xrdef{Function and Variable Index-snt}{}
@xrdef{Function and Variable Index-pg}{74}
@xrdef{Function and Variable Index-pg}{81}
lib/readline/doc/rlman.cp
+9 -9
View File
@@ -1,11 +1,11 @@
\entry{interaction, readline}{1}{interaction, readline}
\entry{notation, readline}{1}{notation, readline}
\entry{command editing}{1}{command editing}
\entry{editing command lines}{1}{editing command lines}
\entry{killing text}{2}{killing text}
\entry{yanking text}{2}{yanking text}
\entry{kill ring}{2}{kill ring}
\entry{notation, readline}{2}{notation, readline}
\entry{command editing}{2}{command editing}
\entry{editing command lines}{2}{editing command lines}
\entry{killing text}{3}{killing text}
\entry{yanking text}{3}{yanking text}
\entry{kill ring}{3}{kill ring}
\entry{initialization file, readline}{4}{initialization file, readline}
\entry{variables, readline}{4}{variables, readline}
\entry{readline, function}{24}{readline, function}
\entry{application-specific completion functions}{49}{application-specific completion functions}
\entry{variables, readline}{5}{variables, readline}
\entry{readline, function}{27}{readline, function}
\entry{application-specific completion functions}{55}{application-specific completion functions}
lib/readline/doc/rlman.cps
+11 -11
View File
@@ -1,20 +1,20 @@
\initial {A}
\entry {application-specific completion functions}{49}
\entry{application-specific completion functions}{55}
\initial {C}
\entry {command editing}{1}
\entry{command editing}{2}
\initial {E}
\entry {editing command lines}{1}
\entry{editing command lines}{2}
\initial {I}
\entry {initialization file, readline}{4}
\entry {interaction, readline}{1}
\entry{initialization file, readline}{4}
\entry{interaction, readline}{1}
\initial {K}
\entry {kill ring}{2}
\entry {killing text}{2}
\entry{kill ring}{3}
\entry{killing text}{3}
\initial {N}
\entry {notation, readline}{1}
\entry{notation, readline}{2}
\initial {R}
\entry {readline, function}{24}
\entry{readline, function}{27}
\initial {V}
\entry {variables, readline}{4}
\entry{variables, readline}{5}
\initial {Y}
\entry {yanking text}{2}
\entry{yanking text}{3}
lib/readline/doc/rlman.fn
+263 -242
View File
@@ -1,245 +1,266 @@
\entry{active-region-start-color}{5}{active-region-start-color}
\entry{active-region-end-color}{5}{active-region-end-color}
\entry{bell-style}{5}{bell-style}
\entry{bind-tty-special-chars}{5}{bind-tty-special-chars}
\entry{blink-matching-paren}{5}{blink-matching-paren}
\entry{colored-completion-prefix}{5}{colored-completion-prefix}
\entry{colored-stats}{5}{colored-stats}
\entry{comment-begin}{5}{comment-begin}
\entry{completion-display-width}{5}{completion-display-width}
\entry{completion-ignore-case}{5}{completion-ignore-case}
\entry{completion-map-case}{5}{completion-map-case}
\entry{completion-prefix-display-length}{5}{completion-prefix-display-length}
\entry{blink-matching-paren}{6}{blink-matching-paren}
\entry{colored-completion-prefix}{6}{colored-completion-prefix}
\entry{colored-stats}{6}{colored-stats}
\entry{comment-begin}{6}{comment-begin}
\entry{completion-display-width}{6}{completion-display-width}
\entry{completion-ignore-case}{6}{completion-ignore-case}
\entry{completion-map-case}{6}{completion-map-case}
\entry{completion-prefix-display-length}{6}{completion-prefix-display-length}
\entry{completion-query-items}{6}{completion-query-items}
\entry{convert-meta}{6}{convert-meta}
\entry{disable-completion}{6}{disable-completion}
\entry{echo-control-characters}{6}{echo-control-characters}
\entry{editing-mode}{6}{editing-mode}
\entry{emacs-mode-string}{6}{emacs-mode-string}
\entry{enable-bracketed-paste}{6}{enable-bracketed-paste}
\entry{enable-keypad}{7}{enable-keypad}
\entry{expand-tilde}{7}{expand-tilde}
\entry{history-preserve-point}{7}{history-preserve-point}
\entry{history-size}{7}{history-size}
\entry{horizontal-scroll-mode}{7}{horizontal-scroll-mode}
\entry{input-meta}{7}{input-meta}
\entry{meta-flag}{7}{meta-flag}
\entry{isearch-terminators}{7}{isearch-terminators}
\entry{keymap}{8}{keymap}
\entry{mark-modified-lines}{8}{mark-modified-lines}
\entry{mark-symlinked-directories}{8}{mark-symlinked-directories}
\entry{match-hidden-files}{8}{match-hidden-files}
\entry{menu-complete-display-prefix}{8}{menu-complete-display-prefix}
\entry{output-meta}{8}{output-meta}
\entry{page-completions}{9}{page-completions}
\entry{revert-all-at-newline}{9}{revert-all-at-newline}
\entry{show-all-if-ambiguous}{9}{show-all-if-ambiguous}
\entry{show-all-if-unmodified}{9}{show-all-if-unmodified}
\entry{show-mode-in-prompt}{9}{show-mode-in-prompt}
\entry{skip-completed-text}{9}{skip-completed-text}
\entry{vi-cmd-mode-string}{10}{vi-cmd-mode-string}
\entry{vi-ins-mode-string}{10}{vi-ins-mode-string}
\entry{visible-stats}{10}{visible-stats}
\entry{beginning-of-line (C-a)}{16}{\code {beginning-of-line (C-a)}}
\entry{end-of-line (C-e)}{16}{\code {end-of-line (C-e)}}
\entry{forward-char (C-f)}{16}{\code {forward-char (C-f)}}
\entry{backward-char (C-b)}{16}{\code {backward-char (C-b)}}
\entry{forward-word (M-f)}{16}{\code {forward-word (M-f)}}
\entry{backward-word (M-b)}{16}{\code {backward-word (M-b)}}
\entry{previous-screen-line ()}{16}{\code {previous-screen-line ()}}
\entry{next-screen-line ()}{16}{\code {next-screen-line ()}}
\entry{clear-screen (C-l)}{16}{\code {clear-screen (C-l)}}
\entry{redraw-current-line ()}{17}{\code {redraw-current-line ()}}
\entry{accept-line (Newline or Return)}{17}{\code {accept-line (Newline or Return)}}
\entry{previous-history (C-p)}{17}{\code {previous-history (C-p)}}
\entry{next-history (C-n)}{17}{\code {next-history (C-n)}}
\entry{beginning-of-history (M-<)}{17}{\code {beginning-of-history (M-<)}}
\entry{end-of-history (M->)}{17}{\code {end-of-history (M->)}}
\entry{reverse-search-history (C-r)}{17}{\code {reverse-search-history (C-r)}}
\entry{forward-search-history (C-s)}{17}{\code {forward-search-history (C-s)}}
\entry{non-incremental-reverse-search-history (M-p)}{17}{\code {non-incremental-reverse-search-history (M-p)}}
\entry{non-incremental-forward-search-history (M-n)}{17}{\code {non-incremental-forward-search-history (M-n)}}
\entry{history-search-forward ()}{17}{\code {history-search-forward ()}}
\entry{history-search-backward ()}{17}{\code {history-search-backward ()}}
\entry{history-substring-search-forward ()}{17}{\code {history-substring-search-forward ()}}
\entry{history-substring-search-backward ()}{18}{\code {history-substring-search-backward ()}}
\entry{yank-nth-arg (M-C-y)}{18}{\code {yank-nth-arg (M-C-y)}}
\entry{yank-last-arg (M-. or M-_)}{18}{\code {yank-last-arg (M-. or M-_)}}
\entry{end-of-file (usually C-d)}{18}{\code {\i {end-of-file} (usually C-d)}}
\entry{delete-char (C-d)}{18}{\code {delete-char (C-d)}}
\entry{backward-delete-char (Rubout)}{18}{\code {backward-delete-char (Rubout)}}
\entry{forward-backward-delete-char ()}{18}{\code {forward-backward-delete-char ()}}
\entry{quoted-insert (C-q or C-v)}{18}{\code {quoted-insert (C-q or C-v)}}
\entry{tab-insert (M-TAB)}{19}{\code {tab-insert (M-\key {TAB})}}
\entry{self-insert (a, b, A, 1, !, ...{})}{19}{\code {self-insert (a, b, A, 1, !, \dots {})}}
\entry{bracketed-paste-begin ()}{19}{\code {bracketed-paste-begin ()}}
\entry{transpose-chars (C-t)}{19}{\code {transpose-chars (C-t)}}
\entry{transpose-words (M-t)}{19}{\code {transpose-words (M-t)}}
\entry{upcase-word (M-u)}{19}{\code {upcase-word (M-u)}}
\entry{downcase-word (M-l)}{19}{\code {downcase-word (M-l)}}
\entry{capitalize-word (M-c)}{19}{\code {capitalize-word (M-c)}}
\entry{overwrite-mode ()}{19}{\code {overwrite-mode ()}}
\entry{kill-line (C-k)}{19}{\code {kill-line (C-k)}}
\entry{backward-kill-line (C-x Rubout)}{20}{\code {backward-kill-line (C-x Rubout)}}
\entry{unix-line-discard (C-u)}{20}{\code {unix-line-discard (C-u)}}
\entry{kill-whole-line ()}{20}{\code {kill-whole-line ()}}
\entry{kill-word (M-d)}{20}{\code {kill-word (M-d)}}
\entry{backward-kill-word (M-DEL)}{20}{\code {backward-kill-word (M-\key {DEL})}}
\entry{unix-word-rubout (C-w)}{20}{\code {unix-word-rubout (C-w)}}
\entry{unix-filename-rubout ()}{20}{\code {unix-filename-rubout ()}}
\entry{delete-horizontal-space ()}{20}{\code {delete-horizontal-space ()}}
\entry{kill-region ()}{20}{\code {kill-region ()}}
\entry{copy-region-as-kill ()}{20}{\code {copy-region-as-kill ()}}
\entry{copy-backward-word ()}{20}{\code {copy-backward-word ()}}
\entry{copy-forward-word ()}{20}{\code {copy-forward-word ()}}
\entry{yank (C-y)}{20}{\code {yank (C-y)}}
\entry{yank-pop (M-y)}{20}{\code {yank-pop (M-y)}}
\entry{digit-argument (M-0, M-1, ...{} M--)}{20}{\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}}
\entry{universal-argument ()}{21}{\code {universal-argument ()}}
\entry{complete (TAB)}{21}{\code {complete (\key {TAB})}}
\entry{possible-completions (M-?)}{21}{\code {possible-completions (M-?)}}
\entry{insert-completions (M-*)}{21}{\code {insert-completions (M-*)}}
\entry{menu-complete ()}{21}{\code {menu-complete ()}}
\entry{menu-complete-backward ()}{21}{\code {menu-complete-backward ()}}
\entry{delete-char-or-list ()}{21}{\code {delete-char-or-list ()}}
\entry{start-kbd-macro (C-x ()}{21}{\code {start-kbd-macro (C-x ()}}
\entry{end-kbd-macro (C-x ))}{22}{\code {end-kbd-macro (C-x ))}}
\entry{call-last-kbd-macro (C-x e)}{22}{\code {call-last-kbd-macro (C-x e)}}
\entry{print-last-kbd-macro ()}{22}{\code {print-last-kbd-macro ()}}
\entry{re-read-init-file (C-x C-r)}{22}{\code {re-read-init-file (C-x C-r)}}
\entry{abort (C-g)}{22}{\code {abort (C-g)}}
\entry{do-lowercase-version (M-A, M-B, M-x, ...{})}{22}{\code {do-lowercase-version (M-A, M-B, M-\var {x}, \dots {})}}
\entry{prefix-meta (ESC)}{22}{\code {prefix-meta (\key {ESC})}}
\entry{undo (C-_ or C-x C-u)}{22}{\code {undo (C-_ or C-x C-u)}}
\entry{revert-line (M-r)}{22}{\code {revert-line (M-r)}}
\entry{tilde-expand (M-~)}{22}{\code {tilde-expand (M-~)}}
\entry{set-mark (C-@)}{22}{\code {set-mark (C-@)}}
\entry{exchange-point-and-mark (C-x C-x)}{22}{\code {exchange-point-and-mark (C-x C-x)}}
\entry{character-search (C-])}{22}{\code {character-search (C-])}}
\entry{character-search-backward (M-C-])}{22}{\code {character-search-backward (M-C-])}}
\entry{skip-csi-sequence ()}{23}{\code {skip-csi-sequence ()}}
\entry{insert-comment (M-#)}{23}{\code {insert-comment (M-#)}}
\entry{dump-functions ()}{23}{\code {dump-functions ()}}
\entry{dump-variables ()}{23}{\code {dump-variables ()}}
\entry{dump-macros ()}{23}{\code {dump-macros ()}}
\entry{emacs-editing-mode (C-e)}{23}{\code {emacs-editing-mode (C-e)}}
\entry{vi-editing-mode (M-C-j)}{23}{\code {vi-editing-mode (M-C-j)}}
\entry{readline}{24}{\code {readline}}
\entry{rl_add_defun}{32}{\code {rl_add_defun}}
\entry{rl_make_bare_keymap}{33}{\code {rl_make_bare_keymap}}
\entry{rl_copy_keymap}{33}{\code {rl_copy_keymap}}
\entry{rl_make_keymap}{33}{\code {rl_make_keymap}}
\entry{rl_discard_keymap}{33}{\code {rl_discard_keymap}}
\entry{rl_free_keymap}{33}{\code {rl_free_keymap}}
\entry{rl_empty_keymap}{33}{\code {rl_empty_keymap}}
\entry{rl_get_keymap}{33}{\code {rl_get_keymap}}
\entry{rl_set_keymap}{33}{\code {rl_set_keymap}}
\entry{rl_get_keymap_by_name}{33}{\code {rl_get_keymap_by_name}}
\entry{rl_get_keymap_name}{33}{\code {rl_get_keymap_name}}
\entry{rl_bind_key}{34}{\code {rl_bind_key}}
\entry{rl_bind_key_in_map}{34}{\code {rl_bind_key_in_map}}
\entry{rl_bind_key_if_unbound}{34}{\code {rl_bind_key_if_unbound}}
\entry{rl_bind_key_if_unbound_in_map}{34}{\code {rl_bind_key_if_unbound_in_map}}
\entry{rl_unbind_key}{34}{\code {rl_unbind_key}}
\entry{rl_unbind_key_in_map}{34}{\code {rl_unbind_key_in_map}}
\entry{rl_unbind_function_in_map}{34}{\code {rl_unbind_function_in_map}}
\entry{rl_unbind_command_in_map}{34}{\code {rl_unbind_command_in_map}}
\entry{rl_bind_keyseq}{34}{\code {rl_bind_keyseq}}
\entry{rl_bind_keyseq_in_map}{34}{\code {rl_bind_keyseq_in_map}}
\entry{rl_set_key}{35}{\code {rl_set_key}}
\entry{rl_bind_keyseq_if_unbound}{35}{\code {rl_bind_keyseq_if_unbound}}
\entry{rl_bind_keyseq_if_unbound_in_map}{35}{\code {rl_bind_keyseq_if_unbound_in_map}}
\entry{rl_generic_bind}{35}{\code {rl_generic_bind}}
\entry{rl_parse_and_bind}{35}{\code {rl_parse_and_bind}}
\entry{rl_read_init_file}{35}{\code {rl_read_init_file}}
\entry{rl_named_function}{35}{\code {rl_named_function}}
\entry{rl_function_of_keyseq}{35}{\code {rl_function_of_keyseq}}
\entry{rl_invoking_keyseqs}{35}{\code {rl_invoking_keyseqs}}
\entry{rl_invoking_keyseqs_in_map}{35}{\code {rl_invoking_keyseqs_in_map}}
\entry{rl_function_dumper}{36}{\code {rl_function_dumper}}
\entry{rl_list_funmap_names}{36}{\code {rl_list_funmap_names}}
\entry{rl_funmap_names}{36}{\code {rl_funmap_names}}
\entry{rl_add_funmap_entry}{36}{\code {rl_add_funmap_entry}}
\entry{rl_begin_undo_group}{36}{\code {rl_begin_undo_group}}
\entry{rl_end_undo_group}{36}{\code {rl_end_undo_group}}
\entry{rl_add_undo}{36}{\code {rl_add_undo}}
\entry{rl_free_undo_list}{36}{\code {rl_free_undo_list}}
\entry{rl_do_undo}{37}{\code {rl_do_undo}}
\entry{rl_modifying}{37}{\code {rl_modifying}}
\entry{rl_redisplay}{37}{\code {rl_redisplay}}
\entry{rl_forced_update_display}{37}{\code {rl_forced_update_display}}
\entry{rl_on_new_line}{37}{\code {rl_on_new_line}}
\entry{rl_on_new_line_with_prompt}{37}{\code {rl_on_new_line_with_prompt}}
\entry{rl_clear_visible_line}{37}{\code {rl_clear_visible_line}}
\entry{rl_reset_line_state}{37}{\code {rl_reset_line_state}}
\entry{rl_crlf}{37}{\code {rl_crlf}}
\entry{rl_show_char}{37}{\code {rl_show_char}}
\entry{rl_message}{37}{\code {rl_message}}
\entry{rl_clear_message}{38}{\code {rl_clear_message}}
\entry{rl_save_prompt}{38}{\code {rl_save_prompt}}
\entry{rl_restore_prompt}{38}{\code {rl_restore_prompt}}
\entry{rl_expand_prompt}{38}{\code {rl_expand_prompt}}
\entry{rl_set_prompt}{38}{\code {rl_set_prompt}}
\entry{rl_insert_text}{38}{\code {rl_insert_text}}
\entry{rl_delete_text}{38}{\code {rl_delete_text}}
\entry{rl_copy_text}{38}{\code {rl_copy_text}}
\entry{rl_kill_text}{38}{\code {rl_kill_text}}
\entry{rl_push_macro_input}{39}{\code {rl_push_macro_input}}
\entry{rl_read_key}{39}{\code {rl_read_key}}
\entry{rl_getc}{39}{\code {rl_getc}}
\entry{rl_stuff_char}{39}{\code {rl_stuff_char}}
\entry{rl_execute_next}{39}{\code {rl_execute_next}}
\entry{rl_clear_pending_input}{39}{\code {rl_clear_pending_input}}
\entry{rl_set_keyboard_input_timeout}{39}{\code {rl_set_keyboard_input_timeout}}
\entry{rl_prep_terminal}{39}{\code {rl_prep_terminal}}
\entry{rl_deprep_terminal}{39}{\code {rl_deprep_terminal}}
\entry{rl_tty_set_default_bindings}{39}{\code {rl_tty_set_default_bindings}}
\entry{rl_tty_unset_default_bindings}{40}{\code {rl_tty_unset_default_bindings}}
\entry{rl_tty_set_echoing}{40}{\code {rl_tty_set_echoing}}
\entry{rl_reset_terminal}{40}{\code {rl_reset_terminal}}
\entry{rl_save_state}{40}{\code {rl_save_state}}
\entry{rl_restore_state}{40}{\code {rl_restore_state}}
\entry{rl_free}{40}{\code {rl_free}}
\entry{rl_replace_line}{40}{\code {rl_replace_line}}
\entry{rl_extend_line_buffer}{40}{\code {rl_extend_line_buffer}}
\entry{rl_initialize}{40}{\code {rl_initialize}}
\entry{rl_ding}{40}{\code {rl_ding}}
\entry{rl_alphabetic}{40}{\code {rl_alphabetic}}
\entry{rl_display_match_list}{41}{\code {rl_display_match_list}}
\entry{_rl_uppercase_p}{41}{\code {_rl_uppercase_p}}
\entry{_rl_lowercase_p}{41}{\code {_rl_lowercase_p}}
\entry{_rl_digit_p}{41}{\code {_rl_digit_p}}
\entry{_rl_to_upper}{41}{\code {_rl_to_upper}}
\entry{_rl_to_lower}{41}{\code {_rl_to_lower}}
\entry{_rl_digit_value}{41}{\code {_rl_digit_value}}
\entry{rl_macro_bind}{41}{\code {rl_macro_bind}}
\entry{rl_macro_dumper}{41}{\code {rl_macro_dumper}}
\entry{rl_variable_bind}{41}{\code {rl_variable_bind}}
\entry{rl_variable_value}{42}{\code {rl_variable_value}}
\entry{rl_variable_dumper}{42}{\code {rl_variable_dumper}}
\entry{rl_set_paren_blink_timeout}{42}{\code {rl_set_paren_blink_timeout}}
\entry{rl_get_termcap}{42}{\code {rl_get_termcap}}
\entry{rl_clear_history}{42}{\code {rl_clear_history}}
\entry{rl_callback_handler_install}{42}{\code {rl_callback_handler_install}}
\entry{rl_callback_read_char}{42}{\code {rl_callback_read_char}}
\entry{rl_callback_sigcleanup}{43}{\code {rl_callback_sigcleanup}}
\entry{rl_callback_handler_remove}{43}{\code {rl_callback_handler_remove}}
\entry{rl_pending_signal}{48}{\code {rl_pending_signal}}
\entry{rl_cleanup_after_signal}{48}{\code {rl_cleanup_after_signal}}
\entry{rl_free_line_state}{48}{\code {rl_free_line_state}}
\entry{rl_reset_after_signal}{48}{\code {rl_reset_after_signal}}
\entry{rl_check_signals}{49}{\code {rl_check_signals}}
\entry{rl_echo_signal_char}{49}{\code {rl_echo_signal_char}}
\entry{rl_resize_terminal}{49}{\code {rl_resize_terminal}}
\entry{rl_set_screen_size}{49}{\code {rl_set_screen_size}}
\entry{rl_get_screen_size}{49}{\code {rl_get_screen_size}}
\entry{rl_reset_screen_size}{49}{\code {rl_reset_screen_size}}
\entry{rl_set_signals}{49}{\code {rl_set_signals}}
\entry{rl_clear_signals}{49}{\code {rl_clear_signals}}
\entry{rl_complete}{50}{\code {rl_complete}}
\entry{rl_complete_internal}{51}{\code {rl_complete_internal}}
\entry{rl_complete}{51}{\code {rl_complete}}
\entry{rl_possible_completions}{51}{\code {rl_possible_completions}}
\entry{rl_insert_completions}{51}{\code {rl_insert_completions}}
\entry{rl_completion_mode}{51}{\code {rl_completion_mode}}
\entry{rl_completion_matches}{51}{\code {rl_completion_matches}}
\entry{rl_filename_completion_function}{51}{\code {rl_filename_completion_function}}
\entry{rl_username_completion_function}{52}{\code {rl_username_completion_function}}
\entry{convert-meta}{7}{convert-meta}
\entry{disable-completion}{7}{disable-completion}
\entry{echo-control-characters}{7}{echo-control-characters}
\entry{editing-mode}{7}{editing-mode}
\entry{emacs-mode-string}{7}{emacs-mode-string}
\entry{enable-active-region The}{7}{enable-active-region The}
\entry{enable-bracketed-paste}{8}{enable-bracketed-paste}
\entry{enable-keypad}{8}{enable-keypad}
\entry{enable-meta-key}{8}{enable-meta-key}
\entry{expand-tilde}{8}{expand-tilde}
\entry{force-meta-prefix}{8}{force-meta-prefix}
\entry{history-preserve-point}{8}{history-preserve-point}
\entry{history-size}{9}{history-size}
\entry{horizontal-scroll-mode}{9}{horizontal-scroll-mode}
\entry{input-meta}{9}{input-meta}
\entry{meta-flag}{9}{meta-flag}
\entry{isearch-terminators}{9}{isearch-terminators}
\entry{keymap}{9}{keymap}
\entry{mark-modified-lines}{10}{mark-modified-lines}
\entry{mark-symlinked-directories}{10}{mark-symlinked-directories}
\entry{match-hidden-files}{10}{match-hidden-files}
\entry{menu-complete-display-prefix}{10}{menu-complete-display-prefix}
\entry{output-meta}{10}{output-meta}
\entry{page-completions}{10}{page-completions}
\entry{revert-all-at-newline}{10}{revert-all-at-newline}
\entry{search-ignore-case}{11}{search-ignore-case}
\entry{show-all-if-ambiguous}{11}{show-all-if-ambiguous}
\entry{show-all-if-unmodified}{11}{show-all-if-unmodified}
\entry{show-mode-in-prompt}{11}{show-mode-in-prompt}
\entry{skip-completed-text}{11}{skip-completed-text}
\entry{vi-cmd-mode-string}{11}{vi-cmd-mode-string}
\entry{vi-ins-mode-string}{12}{vi-ins-mode-string}
\entry{visible-stats}{12}{visible-stats}
\entry{beginning-of-line (C-a)}{18}{\code {beginning-of-line (C-a)}}
\entry{end-of-line (C-e)}{18}{\code {end-of-line (C-e)}}
\entry{forward-char (C-f)}{18}{\code {forward-char (C-f)}}
\entry{backward-char (C-b)}{18}{\code {backward-char (C-b)}}
\entry{forward-word (M-f)}{18}{\code {forward-word (M-f)}}
\entry{backward-word (M-b)}{18}{\code {backward-word (M-b)}}
\entry{previous-screen-line ()}{18}{\code {previous-screen-line ()}}
\entry{next-screen-line ()}{18}{\code {next-screen-line ()}}
\entry{clear-display (M-C-l)}{19}{\code {clear-display (M-C-l)}}
\entry{clear-screen (C-l)}{19}{\code {clear-screen (C-l)}}
\entry{redraw-current-line ()}{19}{\code {redraw-current-line ()}}
\entry{accept-line (Newline or Return)}{19}{\code {accept-line (Newline or Return)}}
\entry{previous-history (C-p)}{19}{\code {previous-history (C-p)}}
\entry{next-history (C-n)}{19}{\code {next-history (C-n)}}
\entry{beginning-of-history (M-<)}{19}{\code {beginning-of-history (M-<)}}
\entry{end-of-history (M->)}{19}{\code {end-of-history (M->)}}
\entry{reverse-search-history (C-r)}{19}{\code {reverse-search-history (C-r)}}
\entry{forward-search-history (C-s)}{19}{\code {forward-search-history (C-s)}}
\entry{non-incremental-reverse-search-history (M-p)}{19}{\code {non-incremental-reverse-search-history (M-p)}}
\entry{non-incremental-forward-search-history (M-n)}{19}{\code {non-incremental-forward-search-history (M-n)}}
\entry{history-search-backward ()}{20}{\code {history-search-backward ()}}
\entry{history-search-forward ()}{20}{\code {history-search-forward ()}}
\entry{history-substring-search-backward ()}{20}{\code {history-substring-search-backward ()}}
\entry{history-substring-search-forward ()}{20}{\code {history-substring-search-forward ()}}
\entry{yank-nth-arg (M-C-y)}{20}{\code {yank-nth-arg (M-C-y)}}
\entry{yank-last-arg (M-. or M-_)}{20}{\code {yank-last-arg (M-. or M-_)}}
\entry{operate-and-get-next (C-o)}{20}{\code {operate-and-get-next (C-o)}}
\entry{fetch-history ()}{21}{\code {fetch-history ()}}
\entry{end-of-file (usually C-d)}{21}{\code {\i {end-of-file} (usually C-d)}}
\entry{delete-char (C-d)}{21}{\code {delete-char (C-d)}}
\entry{backward-delete-char (Rubout)}{21}{\code {backward-delete-char (Rubout)}}
\entry{forward-backward-delete-char ()}{21}{\code {forward-backward-delete-char ()}}
\entry{quoted-insert (C-q or C-v)}{21}{\code {quoted-insert (C-q or C-v)}}
\entry{tab-insert (M-TAB)}{21}{\code {tab-insert (M-\key {TAB})}}
\entry{self-insert (a, b, A, 1, !, ...{})}{21}{\code {self-insert (a, b, A, 1, !, \dots {})}}
\entry{bracketed-paste-begin ()}{21}{\code {bracketed-paste-begin ()}}
\entry{transpose-chars (C-t)}{21}{\code {transpose-chars (C-t)}}
\entry{transpose-words (M-t)}{22}{\code {transpose-words (M-t)}}
\entry{upcase-word (M-u)}{22}{\code {upcase-word (M-u)}}
\entry{downcase-word (M-l)}{22}{\code {downcase-word (M-l)}}
\entry{capitalize-word (M-c)}{22}{\code {capitalize-word (M-c)}}
\entry{overwrite-mode ()}{22}{\code {overwrite-mode ()}}
\entry{kill-line (C-k)}{22}{\code {kill-line (C-k)}}
\entry{backward-kill-line (C-x Rubout)}{22}{\code {backward-kill-line (C-x Rubout)}}
\entry{unix-line-discard (C-u)}{22}{\code {unix-line-discard (C-u)}}
\entry{kill-whole-line ()}{22}{\code {kill-whole-line ()}}
\entry{kill-word (M-d)}{22}{\code {kill-word (M-d)}}
\entry{backward-kill-word (M-DEL)}{22}{\code {backward-kill-word (M-\key {DEL})}}
\entry{unix-word-rubout (C-w)}{23}{\code {unix-word-rubout (C-w)}}
\entry{unix-filename-rubout ()}{23}{\code {unix-filename-rubout ()}}
\entry{delete-horizontal-space ()}{23}{\code {delete-horizontal-space ()}}
\entry{kill-region ()}{23}{\code {kill-region ()}}
\entry{copy-region-as-kill ()}{23}{\code {copy-region-as-kill ()}}
\entry{copy-backward-word ()}{23}{\code {copy-backward-word ()}}
\entry{copy-forward-word ()}{23}{\code {copy-forward-word ()}}
\entry{yank (C-y)}{23}{\code {yank (C-y)}}
\entry{yank-pop (M-y)}{23}{\code {yank-pop (M-y)}}
\entry{digit-argument (M-0, M-1, ...{} M--)}{23}{\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}}
\entry{universal-argument ()}{23}{\code {universal-argument ()}}
\entry{complete (TAB)}{24}{\code {complete (\key {TAB})}}
\entry{possible-completions (M-?)}{24}{\code {possible-completions (M-?)}}
\entry{insert-completions (M-*)}{24}{\code {insert-completions (M-*)}}
\entry{menu-complete ()}{24}{\code {menu-complete ()}}
\entry{menu-complete-backward ()}{24}{\code {menu-complete-backward ()}}
\entry{delete-char-or-list ()}{24}{\code {delete-char-or-list ()}}
\entry{start-kbd-macro (C-x ()}{24}{\code {start-kbd-macro (C-x ()}}
\entry{end-kbd-macro (C-x ))}{24}{\code {end-kbd-macro (C-x ))}}
\entry{call-last-kbd-macro (C-x e)}{24}{\code {call-last-kbd-macro (C-x e)}}
\entry{print-last-kbd-macro ()}{24}{\code {print-last-kbd-macro ()}}
\entry{re-read-init-file (C-x C-r)}{25}{\code {re-read-init-file (C-x C-r)}}
\entry{abort (C-g)}{25}{\code {abort (C-g)}}
\entry{do-lowercase-version (M-A, M-B, M-x, ...{})}{25}{\code {do-lowercase-version (M-A, M-B, M-\var {x}, \dots {})}}
\entry{prefix-meta (ESC)}{25}{\code {prefix-meta (\key {ESC})}}
\entry{undo (C-_ or C-x C-u)}{25}{\code {undo (C-_ or C-x C-u)}}
\entry{revert-line (M-r)}{25}{\code {revert-line (M-r)}}
\entry{tilde-expand (M-~)}{25}{\code {tilde-expand (M-~)}}
\entry{set-mark (C-@)}{25}{\code {set-mark (C-@)}}
\entry{exchange-point-and-mark (C-x C-x)}{25}{\code {exchange-point-and-mark (C-x C-x)}}
\entry{character-search (C-])}{25}{\code {character-search (C-])}}
\entry{character-search-backward (M-C-])}{25}{\code {character-search-backward (M-C-])}}
\entry{skip-csi-sequence ()}{25}{\code {skip-csi-sequence ()}}
\entry{insert-comment (M-#)}{25}{\code {insert-comment (M-#)}}
\entry{dump-functions ()}{26}{\code {dump-functions ()}}
\entry{dump-variables ()}{26}{\code {dump-variables ()}}
\entry{dump-macros ()}{26}{\code {dump-macros ()}}
\entry{execute-named-command (M-x)}{26}{\code {execute-named-command (M-x)}}
\entry{emacs-editing-mode (C-e)}{26}{\code {emacs-editing-mode (C-e)}}
\entry{vi-editing-mode (M-C-j)}{26}{\code {vi-editing-mode (M-C-j)}}
\entry{readline}{27}{\code {readline}}
\entry{rl_add_defun}{36}{\code {rl_add_defun}}
\entry{rl_make_bare_keymap}{36}{\code {rl_make_bare_keymap}}
\entry{rl_copy_keymap}{36}{\code {rl_copy_keymap}}
\entry{rl_make_keymap}{37}{\code {rl_make_keymap}}
\entry{rl_discard_keymap}{37}{\code {rl_discard_keymap}}
\entry{rl_free_keymap}{37}{\code {rl_free_keymap}}
\entry{rl_empty_keymap}{37}{\code {rl_empty_keymap}}
\entry{rl_get_keymap}{37}{\code {rl_get_keymap}}
\entry{rl_set_keymap}{37}{\code {rl_set_keymap}}
\entry{rl_get_keymap_by_name}{37}{\code {rl_get_keymap_by_name}}
\entry{rl_get_keymap_name}{37}{\code {rl_get_keymap_name}}
\entry{rl_set_keymap_name}{37}{\code {rl_set_keymap_name}}
\entry{rl_bind_key}{38}{\code {rl_bind_key}}
\entry{rl_bind_key_in_map}{38}{\code {rl_bind_key_in_map}}
\entry{rl_bind_key_if_unbound}{38}{\code {rl_bind_key_if_unbound}}
\entry{rl_bind_key_if_unbound_in_map}{38}{\code {rl_bind_key_if_unbound_in_map}}
\entry{rl_unbind_key}{38}{\code {rl_unbind_key}}
\entry{rl_unbind_key_in_map}{38}{\code {rl_unbind_key_in_map}}
\entry{rl_unbind_function_in_map}{38}{\code {rl_unbind_function_in_map}}
\entry{rl_unbind_command_in_map}{38}{\code {rl_unbind_command_in_map}}
\entry{rl_bind_keyseq}{38}{\code {rl_bind_keyseq}}
\entry{rl_bind_keyseq_in_map}{38}{\code {rl_bind_keyseq_in_map}}
\entry{rl_set_key}{39}{\code {rl_set_key}}
\entry{rl_bind_keyseq_if_unbound}{39}{\code {rl_bind_keyseq_if_unbound}}
\entry{rl_bind_keyseq_if_unbound_in_map}{39}{\code {rl_bind_keyseq_if_unbound_in_map}}
\entry{rl_generic_bind}{39}{\code {rl_generic_bind}}
\entry{rl_parse_and_bind}{39}{\code {rl_parse_and_bind}}
\entry{rl_read_init_file}{39}{\code {rl_read_init_file}}
\entry{rl_named_function}{39}{\code {rl_named_function}}
\entry{rl_function_of_keyseq}{39}{\code {rl_function_of_keyseq}}
\entry{rl_function_of_keyseq_len}{39}{\code {rl_function_of_keyseq_len}}
\entry{rl_trim_arg_from_keyseq}{40}{\code {rl_trim_arg_from_keyseq}}
\entry{rl_invoking_keyseqs}{40}{\code {rl_invoking_keyseqs}}
\entry{rl_invoking_keyseqs_in_map}{40}{\code {rl_invoking_keyseqs_in_map}}
\entry{rl_print_keybinding}{40}{\code {rl_print_keybinding}}
\entry{rl_function_dumper}{40}{\code {rl_function_dumper}}
\entry{rl_list_funmap_names}{40}{\code {rl_list_funmap_names}}
\entry{rl_funmap_names}{40}{\code {rl_funmap_names}}
\entry{rl_add_funmap_entry}{40}{\code {rl_add_funmap_entry}}
\entry{rl_begin_undo_group}{41}{\code {rl_begin_undo_group}}
\entry{rl_end_undo_group}{41}{\code {rl_end_undo_group}}
\entry{rl_add_undo}{41}{\code {rl_add_undo}}
\entry{rl_free_undo_list}{41}{\code {rl_free_undo_list}}
\entry{rl_do_undo}{41}{\code {rl_do_undo}}
\entry{rl_modifying}{41}{\code {rl_modifying}}
\entry{rl_redisplay}{41}{\code {rl_redisplay}}
\entry{rl_forced_update_display}{41}{\code {rl_forced_update_display}}
\entry{rl_on_new_line}{42}{\code {rl_on_new_line}}
\entry{rl_on_new_line_with_prompt}{42}{\code {rl_on_new_line_with_prompt}}
\entry{rl_clear_visible_line}{42}{\code {rl_clear_visible_line}}
\entry{rl_reset_line_state}{42}{\code {rl_reset_line_state}}
\entry{rl_crlf}{42}{\code {rl_crlf}}
\entry{rl_show_char}{42}{\code {rl_show_char}}
\entry{rl_message}{42}{\code {rl_message}}
\entry{rl_clear_message}{42}{\code {rl_clear_message}}
\entry{rl_save_prompt}{42}{\code {rl_save_prompt}}
\entry{rl_restore_prompt}{42}{\code {rl_restore_prompt}}
\entry{rl_expand_prompt}{42}{\code {rl_expand_prompt}}
\entry{rl_set_prompt}{43}{\code {rl_set_prompt}}
\entry{rl_insert_text}{43}{\code {rl_insert_text}}
\entry{rl_delete_text}{43}{\code {rl_delete_text}}
\entry{rl_copy_text}{43}{\code {rl_copy_text}}
\entry{rl_kill_text}{43}{\code {rl_kill_text}}
\entry{rl_replace_line}{43}{\code {rl_replace_line}}
\entry{rl_push_macro_input}{43}{\code {rl_push_macro_input}}
\entry{rl_read_key}{43}{\code {rl_read_key}}
\entry{rl_getc}{44}{\code {rl_getc}}
\entry{rl_stuff_char}{44}{\code {rl_stuff_char}}
\entry{rl_execute_next}{44}{\code {rl_execute_next}}
\entry{rl_clear_pending_input}{44}{\code {rl_clear_pending_input}}
\entry{rl_set_keyboard_input_timeout}{44}{\code {rl_set_keyboard_input_timeout}}
\entry{rl_set_timeout}{44}{\code {rl_set_timeout}}
\entry{rl_timeout_remaining}{44}{\code {rl_timeout_remaining}}
\entry{rl_prep_terminal}{44}{\code {rl_prep_terminal}}
\entry{rl_deprep_terminal}{44}{\code {rl_deprep_terminal}}
\entry{rl_tty_set_default_bindings}{45}{\code {rl_tty_set_default_bindings}}
\entry{rl_tty_unset_default_bindings}{45}{\code {rl_tty_unset_default_bindings}}
\entry{rl_tty_set_echoing}{45}{\code {rl_tty_set_echoing}}
\entry{rl_reset_terminal}{45}{\code {rl_reset_terminal}}
\entry{rl_save_state}{45}{\code {rl_save_state}}
\entry{rl_restore_state}{45}{\code {rl_restore_state}}
\entry{rl_free}{45}{\code {rl_free}}
\entry{rl_extend_line_buffer}{45}{\code {rl_extend_line_buffer}}
\entry{rl_initialize}{45}{\code {rl_initialize}}
\entry{rl_ding}{45}{\code {rl_ding}}
\entry{rl_alphabetic}{45}{\code {rl_alphabetic}}
\entry{rl_display_match_list}{46}{\code {rl_display_match_list}}
\entry{_rl_uppercase_p}{46}{\code {_rl_uppercase_p}}
\entry{_rl_lowercase_p}{46}{\code {_rl_lowercase_p}}
\entry{_rl_digit_p}{46}{\code {_rl_digit_p}}
\entry{_rl_to_upper}{46}{\code {_rl_to_upper}}
\entry{_rl_to_lower}{46}{\code {_rl_to_lower}}
\entry{_rl_digit_value}{46}{\code {_rl_digit_value}}
\entry{rl_macro_bind}{46}{\code {rl_macro_bind}}
\entry{rl_macro_dumper}{46}{\code {rl_macro_dumper}}
\entry{rl_variable_bind}{46}{\code {rl_variable_bind}}
\entry{rl_variable_value}{47}{\code {rl_variable_value}}
\entry{rl_variable_dumper}{47}{\code {rl_variable_dumper}}
\entry{rl_set_paren_blink_timeout}{47}{\code {rl_set_paren_blink_timeout}}
\entry{rl_get_termcap}{47}{\code {rl_get_termcap}}
\entry{rl_reparse_colors}{47}{\code {rl_reparse_colors}}
\entry{rl_clear_history}{47}{\code {rl_clear_history}}
\entry{rl_activate_mark}{47}{\code {rl_activate_mark}}
\entry{rl_deactivate_mark}{47}{\code {rl_deactivate_mark}}
\entry{rl_keep_mark_active}{47}{\code {rl_keep_mark_active}}
\entry{rl_mark_active_p}{47}{\code {rl_mark_active_p}}
\entry{rl_callback_handler_install}{48}{\code {rl_callback_handler_install}}
\entry{rl_callback_read_char}{48}{\code {rl_callback_read_char}}
\entry{rl_callback_sigcleanup}{48}{\code {rl_callback_sigcleanup}}
\entry{rl_callback_handler_remove}{48}{\code {rl_callback_handler_remove}}
\entry{rl_pending_signal}{54}{\code {rl_pending_signal}}
\entry{rl_cleanup_after_signal}{54}{\code {rl_cleanup_after_signal}}
\entry{rl_free_line_state}{54}{\code {rl_free_line_state}}
\entry{rl_reset_after_signal}{54}{\code {rl_reset_after_signal}}
\entry{rl_check_signals}{54}{\code {rl_check_signals}}
\entry{rl_echo_signal_char}{54}{\code {rl_echo_signal_char}}
\entry{rl_resize_terminal}{54}{\code {rl_resize_terminal}}
\entry{rl_set_screen_size}{54}{\code {rl_set_screen_size}}
\entry{rl_get_screen_size}{55}{\code {rl_get_screen_size}}
\entry{rl_reset_screen_size}{55}{\code {rl_reset_screen_size}}
\entry{rl_set_signals}{55}{\code {rl_set_signals}}
\entry{rl_clear_signals}{55}{\code {rl_clear_signals}}
\entry{rl_complete}{56}{\code {rl_complete}}
\entry{rl_complete_internal}{56}{\code {rl_complete_internal}}
\entry{rl_complete}{56}{\code {rl_complete}}
\entry{rl_possible_completions}{56}{\code {rl_possible_completions}}
\entry{rl_insert_completions}{56}{\code {rl_insert_completions}}
\entry{rl_completion_mode}{57}{\code {rl_completion_mode}}
\entry{rl_completion_matches}{57}{\code {rl_completion_matches}}
\entry{rl_filename_completion_function}{57}{\code {rl_filename_completion_function}}
\entry{rl_username_completion_function}{57}{\code {rl_username_completion_function}}
lib/readline/doc/rlman.fns
+265 -244
View File
@@ -1,265 +1,286 @@
\initial {_}
\entry {\code {_rl_digit_p}}{41}
\entry {\code {_rl_digit_value}}{41}
\entry {\code {_rl_lowercase_p}}{41}
\entry {\code {_rl_to_lower}}{41}
\entry {\code {_rl_to_upper}}{41}
\entry {\code {_rl_uppercase_p}}{41}
\entry{\code {_rl_digit_p}}{46}
\entry{\code {_rl_digit_value}}{46}
\entry{\code {_rl_lowercase_p}}{46}
\entry{\code {_rl_to_lower}}{46}
\entry{\code {_rl_to_upper}}{46}
\entry{\code {_rl_uppercase_p}}{46}
\initial {A}
\entry {\code {abort (C-g)}}{22}
\entry {\code {accept-line (Newline or Return)}}{17}
\entry{\code {abort (C-g)}}{25}
\entry{\code {accept-line (Newline or Return)}}{19}
\entry{active-region-end-color}{5}
\entry{active-region-start-color}{5}
\initial {B}
\entry {\code {backward-char (C-b)}}{16}
\entry {\code {backward-delete-char (Rubout)}}{18}
\entry {\code {backward-kill-line (C-x Rubout)}}{20}
\entry {\code {backward-kill-word (M-\key {DEL})}}{20}
\entry {\code {backward-word (M-b)}}{16}
\entry {\code {beginning-of-history (M-<)}}{17}
\entry {\code {beginning-of-line (C-a)}}{16}
\entry {bell-style}{5}
\entry {bind-tty-special-chars}{5}
\entry {blink-matching-paren}{5}
\entry {\code {bracketed-paste-begin ()}}{19}
\entry{\code {backward-char (C-b)}}{18}
\entry{\code {backward-delete-char (Rubout)}}{21}
\entry{\code {backward-kill-line (C-x Rubout)}}{22}
\entry{\code {backward-kill-word (M-\key {DEL})}}{22}
\entry{\code {backward-word (M-b)}}{18}
\entry{\code {beginning-of-history (M-<)}}{19}
\entry{\code {beginning-of-line (C-a)}}{18}
\entry{bell-style}{5}
\entry{bind-tty-special-chars}{5}
\entry{blink-matching-paren}{6}
\entry{\code {bracketed-paste-begin ()}}{21}
\initial {C}
\entry {\code {call-last-kbd-macro (C-x e)}}{22}
\entry {\code {capitalize-word (M-c)}}{19}
\entry {\code {character-search (C-])}}{22}
\entry {\code {character-search-backward (M-C-])}}{22}
\entry {\code {clear-screen (C-l)}}{16}
\entry {colored-completion-prefix}{5}
\entry {colored-stats}{5}
\entry {comment-begin}{5}
\entry {\code {complete (\key {TAB})}}{21}
\entry {completion-display-width}{5}
\entry {completion-ignore-case}{5}
\entry {completion-map-case}{5}
\entry {completion-prefix-display-length}{5}
\entry {completion-query-items}{6}
\entry {convert-meta}{6}
\entry {\code {copy-backward-word ()}}{20}
\entry {\code {copy-forward-word ()}}{20}
\entry {\code {copy-region-as-kill ()}}{20}
\entry{\code {call-last-kbd-macro (C-x e)}}{24}
\entry{\code {capitalize-word (M-c)}}{22}
\entry{\code {character-search (C-])}}{25}
\entry{\code {character-search-backward (M-C-])}}{25}
\entry{\code {clear-display (M-C-l)}}{19}
\entry{\code {clear-screen (C-l)}}{19}
\entry{colored-completion-prefix}{6}
\entry{colored-stats}{6}
\entry{comment-begin}{6}
\entry{\code {complete (\key {TAB})}}{24}
\entry{completion-display-width}{6}
\entry{completion-ignore-case}{6}
\entry{completion-map-case}{6}
\entry{completion-prefix-display-length}{6}
\entry{completion-query-items}{6}
\entry{convert-meta}{7}
\entry{\code {copy-backward-word ()}}{23}
\entry{\code {copy-forward-word ()}}{23}
\entry{\code {copy-region-as-kill ()}}{23}
\initial {D}
\entry {\code {delete-char (C-d)}}{18}
\entry {\code {delete-char-or-list ()}}{21}
\entry {\code {delete-horizontal-space ()}}{20}
\entry {\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}}{20}
\entry {disable-completion}{6}
\entry {\code {do-lowercase-version (M-A, M-B, M-\var {x}, \dots {})}}{22}
\entry {\code {downcase-word (M-l)}}{19}
\entry {\code {dump-functions ()}}{23}
\entry {\code {dump-macros ()}}{23}
\entry {\code {dump-variables ()}}{23}
\entry{\code {delete-char (C-d)}}{21}
\entry{\code {delete-char-or-list ()}}{24}
\entry{\code {delete-horizontal-space ()}}{23}
\entry{\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}}{23}
\entry{disable-completion}{7}
\entry{\code {do-lowercase-version (M-A, M-B, M-\var {x}, \dots {})}}{25}
\entry{\code {downcase-word (M-l)}}{22}
\entry{\code {dump-functions ()}}{26}
\entry{\code {dump-macros ()}}{26}
\entry{\code {dump-variables ()}}{26}
\initial {E}
\entry {echo-control-characters}{6}
\entry {editing-mode}{6}
\entry {\code {emacs-editing-mode (C-e)}}{23}
\entry {emacs-mode-string}{6}
\entry {enable-bracketed-paste}{6}
\entry {enable-keypad}{7}
\entry {\code {end-kbd-macro (C-x ))}}{22}
\entry {\code {\i {end-of-file} (usually C-d)}}{18}
\entry {\code {end-of-history (M->)}}{17}
\entry {\code {end-of-line (C-e)}}{16}
\entry {\code {exchange-point-and-mark (C-x C-x)}}{22}
\entry {expand-tilde}{7}
\entry{echo-control-characters}{7}
\entry{editing-mode}{7}
\entry{\code {emacs-editing-mode (C-e)}}{26}
\entry{emacs-mode-string}{7}
\entry{enable-active-region The}{7}
\entry{enable-bracketed-paste}{8}
\entry{enable-keypad}{8}
\entry{enable-meta-key}{8}
\entry{\code {end-kbd-macro (C-x ))}}{24}
\entry{\code {\i {end-of-file} (usually C-d)}}{21}
\entry{\code {end-of-history (M->)}}{19}
\entry{\code {end-of-line (C-e)}}{18}
\entry{\code {exchange-point-and-mark (C-x C-x)}}{25}
\entry{\code {execute-named-command (M-x)}}{26}
\entry{expand-tilde}{8}
\initial {F}
\entry {\code {forward-backward-delete-char ()}}{18}
\entry {\code {forward-char (C-f)}}{16}
\entry {\code {forward-search-history (C-s)}}{17}
\entry {\code {forward-word (M-f)}}{16}
\entry{\code {fetch-history ()}}{21}
\entry{force-meta-prefix}{8}
\entry{\code {forward-backward-delete-char ()}}{21}
\entry{\code {forward-char (C-f)}}{18}
\entry{\code {forward-search-history (C-s)}}{19}
\entry{\code {forward-word (M-f)}}{18}
\initial {H}
\entry {history-preserve-point}{7}
\entry {\code {history-search-backward ()}}{17}
\entry {\code {history-search-forward ()}}{17}
\entry {history-size}{7}
\entry {\code {history-substring-search-backward ()}}{18}
\entry {\code {history-substring-search-forward ()}}{17}
\entry {horizontal-scroll-mode}{7}
\entry{history-preserve-point}{8}
\entry{\code {history-search-backward ()}}{20}
\entry{\code {history-search-forward ()}}{20}
\entry{history-size}{9}
\entry{\code {history-substring-search-backward ()}}{20}
\entry{\code {history-substring-search-forward ()}}{20}
\entry{horizontal-scroll-mode}{9}
\initial {I}
\entry {input-meta}{7}
\entry {\code {insert-comment (M-#)}}{23}
\entry {\code {insert-completions (M-*)}}{21}
\entry {isearch-terminators}{7}
\entry{input-meta}{9}
\entry{\code {insert-comment (M-#)}}{25}
\entry{\code {insert-completions (M-*)}}{24}
\entry{isearch-terminators}{9}
\initial {K}
\entry {keymap}{8}
\entry {\code {kill-line (C-k)}}{19}
\entry {\code {kill-region ()}}{20}
\entry {\code {kill-whole-line ()}}{20}
\entry {\code {kill-word (M-d)}}{20}
\entry{keymap}{9}
\entry{\code {kill-line (C-k)}}{22}
\entry{\code {kill-region ()}}{23}
\entry{\code {kill-whole-line ()}}{22}
\entry{\code {kill-word (M-d)}}{22}
\initial {M}
\entry {mark-modified-lines}{8}
\entry {mark-symlinked-directories}{8}
\entry {match-hidden-files}{8}
\entry {\code {menu-complete ()}}{21}
\entry {\code {menu-complete-backward ()}}{21}
\entry {menu-complete-display-prefix}{8}
\entry {meta-flag}{7}
\entry{mark-modified-lines}{10}
\entry{mark-symlinked-directories}{10}
\entry{match-hidden-files}{10}
\entry{\code {menu-complete ()}}{24}
\entry{\code {menu-complete-backward ()}}{24}
\entry{menu-complete-display-prefix}{10}
\entry{meta-flag}{9}
\initial {N}
\entry {\code {next-history (C-n)}}{17}
\entry {\code {next-screen-line ()}}{16}
\entry {\code {non-incremental-forward-search-history (M-n)}}{17}
\entry {\code {non-incremental-reverse-search-history (M-p)}}{17}
\entry{\code {next-history (C-n)}}{19}
\entry{\code {next-screen-line ()}}{18}
\entry{\code {non-incremental-forward-search-history (M-n)}}{19}
\entry{\code {non-incremental-reverse-search-history (M-p)}}{19}
\initial {O}
\entry {output-meta}{8}
\entry {\code {overwrite-mode ()}}{19}
\entry{\code {operate-and-get-next (C-o)}}{20}
\entry{output-meta}{10}
\entry{\code {overwrite-mode ()}}{22}
\initial {P}
\entry {page-completions}{9}
\entry {\code {possible-completions (M-?)}}{21}
\entry {\code {prefix-meta (\key {ESC})}}{22}
\entry {\code {previous-history (C-p)}}{17}
\entry {\code {previous-screen-line ()}}{16}
\entry {\code {print-last-kbd-macro ()}}{22}
\entry{page-completions}{10}
\entry{\code {possible-completions (M-?)}}{24}
\entry{\code {prefix-meta (\key {ESC})}}{25}
\entry{\code {previous-history (C-p)}}{19}
\entry{\code {previous-screen-line ()}}{18}
\entry{\code {print-last-kbd-macro ()}}{24}
\initial {Q}
\entry {\code {quoted-insert (C-q or C-v)}}{18}
\entry{\code {quoted-insert (C-q or C-v)}}{21}
\initial {R}
\entry {\code {re-read-init-file (C-x C-r)}}{22}
\entry {\code {readline}}{24}
\entry {\code {redraw-current-line ()}}{17}
\entry {\code {reverse-search-history (C-r)}}{17}
\entry {revert-all-at-newline}{9}
\entry {\code {revert-line (M-r)}}{22}
\entry {\code {rl_add_defun}}{32}
\entry {\code {rl_add_funmap_entry}}{36}
\entry {\code {rl_add_undo}}{36}
\entry {\code {rl_alphabetic}}{40}
\entry {\code {rl_begin_undo_group}}{36}
\entry {\code {rl_bind_key}}{34}
\entry {\code {rl_bind_key_if_unbound}}{34}
\entry {\code {rl_bind_key_if_unbound_in_map}}{34}
\entry {\code {rl_bind_key_in_map}}{34}
\entry {\code {rl_bind_keyseq}}{34}
\entry {\code {rl_bind_keyseq_if_unbound}}{35}
\entry {\code {rl_bind_keyseq_if_unbound_in_map}}{35}
\entry {\code {rl_bind_keyseq_in_map}}{34}
\entry {\code {rl_callback_handler_install}}{42}
\entry {\code {rl_callback_handler_remove}}{43}
\entry {\code {rl_callback_read_char}}{42}
\entry {\code {rl_callback_sigcleanup}}{43}
\entry {\code {rl_check_signals}}{49}
\entry {\code {rl_cleanup_after_signal}}{48}
\entry {\code {rl_clear_history}}{42}
\entry {\code {rl_clear_message}}{38}
\entry {\code {rl_clear_pending_input}}{39}
\entry {\code {rl_clear_signals}}{49}
\entry {\code {rl_clear_visible_line}}{37}
\entry {\code {rl_complete}}{50, 51}
\entry {\code {rl_complete_internal}}{51}
\entry {\code {rl_completion_matches}}{51}
\entry {\code {rl_completion_mode}}{51}
\entry {\code {rl_copy_keymap}}{33}
\entry {\code {rl_copy_text}}{38}
\entry {\code {rl_crlf}}{37}
\entry {\code {rl_delete_text}}{38}
\entry {\code {rl_deprep_terminal}}{39}
\entry {\code {rl_ding}}{40}
\entry {\code {rl_discard_keymap}}{33}
\entry {\code {rl_display_match_list}}{41}
\entry {\code {rl_do_undo}}{37}
\entry {\code {rl_echo_signal_char}}{49}
\entry {\code {rl_empty_keymap}}{33}
\entry {\code {rl_end_undo_group}}{36}
\entry {\code {rl_execute_next}}{39}
\entry {\code {rl_expand_prompt}}{38}
\entry {\code {rl_extend_line_buffer}}{40}
\entry {\code {rl_filename_completion_function}}{51}
\entry {\code {rl_forced_update_display}}{37}
\entry {\code {rl_free}}{40}
\entry {\code {rl_free_keymap}}{33}
\entry {\code {rl_free_line_state}}{48}
\entry {\code {rl_free_undo_list}}{36}
\entry {\code {rl_function_dumper}}{36}
\entry {\code {rl_function_of_keyseq}}{35}
\entry {\code {rl_funmap_names}}{36}
\entry {\code {rl_generic_bind}}{35}
\entry {\code {rl_get_keymap}}{33}
\entry {\code {rl_get_keymap_by_name}}{33}
\entry {\code {rl_get_keymap_name}}{33}
\entry {\code {rl_get_screen_size}}{49}
\entry {\code {rl_get_termcap}}{42}
\entry {\code {rl_getc}}{39}
\entry {\code {rl_initialize}}{40}
\entry {\code {rl_insert_completions}}{51}
\entry {\code {rl_insert_text}}{38}
\entry {\code {rl_invoking_keyseqs}}{35}
\entry {\code {rl_invoking_keyseqs_in_map}}{35}
\entry {\code {rl_kill_text}}{38}
\entry {\code {rl_list_funmap_names}}{36}
\entry {\code {rl_macro_bind}}{41}
\entry {\code {rl_macro_dumper}}{41}
\entry {\code {rl_make_bare_keymap}}{33}
\entry {\code {rl_make_keymap}}{33}
\entry {\code {rl_message}}{37}
\entry {\code {rl_modifying}}{37}
\entry {\code {rl_named_function}}{35}
\entry {\code {rl_on_new_line}}{37}
\entry {\code {rl_on_new_line_with_prompt}}{37}
\entry {\code {rl_parse_and_bind}}{35}
\entry {\code {rl_pending_signal}}{48}
\entry {\code {rl_possible_completions}}{51}
\entry {\code {rl_prep_terminal}}{39}
\entry {\code {rl_push_macro_input}}{39}
\entry {\code {rl_read_init_file}}{35}
\entry {\code {rl_read_key}}{39}
\entry {\code {rl_redisplay}}{37}
\entry {\code {rl_replace_line}}{40}
\entry {\code {rl_reset_after_signal}}{48}
\entry {\code {rl_reset_line_state}}{37}
\entry {\code {rl_reset_screen_size}}{49}
\entry {\code {rl_reset_terminal}}{40}
\entry {\code {rl_resize_terminal}}{49}
\entry {\code {rl_restore_prompt}}{38}
\entry {\code {rl_restore_state}}{40}
\entry {\code {rl_save_prompt}}{38}
\entry {\code {rl_save_state}}{40}
\entry {\code {rl_set_key}}{35}
\entry {\code {rl_set_keyboard_input_timeout}}{39}
\entry {\code {rl_set_keymap}}{33}
\entry {\code {rl_set_paren_blink_timeout}}{42}
\entry {\code {rl_set_prompt}}{38}
\entry {\code {rl_set_screen_size}}{49}
\entry {\code {rl_set_signals}}{49}
\entry {\code {rl_show_char}}{37}
\entry {\code {rl_stuff_char}}{39}
\entry {\code {rl_tty_set_default_bindings}}{39}
\entry {\code {rl_tty_set_echoing}}{40}
\entry {\code {rl_tty_unset_default_bindings}}{40}
\entry {\code {rl_unbind_command_in_map}}{34}
\entry {\code {rl_unbind_function_in_map}}{34}
\entry {\code {rl_unbind_key}}{34}
\entry {\code {rl_unbind_key_in_map}}{34}
\entry {\code {rl_username_completion_function}}{52}
\entry {\code {rl_variable_bind}}{41}
\entry {\code {rl_variable_dumper}}{42}
\entry {\code {rl_variable_value}}{42}
\entry{\code {re-read-init-file (C-x C-r)}}{25}
\entry{\code {readline}}{27}
\entry{\code {redraw-current-line ()}}{19}
\entry{\code {reverse-search-history (C-r)}}{19}
\entry{revert-all-at-newline}{10}
\entry{\code {revert-line (M-r)}}{25}
\entry{\code {rl_activate_mark}}{47}
\entry{\code {rl_add_defun}}{36}
\entry{\code {rl_add_funmap_entry}}{40}
\entry{\code {rl_add_undo}}{41}
\entry{\code {rl_alphabetic}}{45}
\entry{\code {rl_begin_undo_group}}{41}
\entry{\code {rl_bind_key}}{38}
\entry{\code {rl_bind_key_if_unbound}}{38}
\entry{\code {rl_bind_key_if_unbound_in_map}}{38}
\entry{\code {rl_bind_key_in_map}}{38}
\entry{\code {rl_bind_keyseq}}{38}
\entry{\code {rl_bind_keyseq_if_unbound}}{39}
\entry{\code {rl_bind_keyseq_if_unbound_in_map}}{39}
\entry{\code {rl_bind_keyseq_in_map}}{38}
\entry{\code {rl_callback_handler_install}}{48}
\entry{\code {rl_callback_handler_remove}}{48}
\entry{\code {rl_callback_read_char}}{48}
\entry{\code {rl_callback_sigcleanup}}{48}
\entry{\code {rl_check_signals}}{54}
\entry{\code {rl_cleanup_after_signal}}{54}
\entry{\code {rl_clear_history}}{47}
\entry{\code {rl_clear_message}}{42}
\entry{\code {rl_clear_pending_input}}{44}
\entry{\code {rl_clear_signals}}{55}
\entry{\code {rl_clear_visible_line}}{42}
\entry{\code {rl_complete}}{56}
\entry{\code {rl_complete_internal}}{56}
\entry{\code {rl_completion_matches}}{57}
\entry{\code {rl_completion_mode}}{57}
\entry{\code {rl_copy_keymap}}{36}
\entry{\code {rl_copy_text}}{43}
\entry{\code {rl_crlf}}{42}
\entry{\code {rl_deactivate_mark}}{47}
\entry{\code {rl_delete_text}}{43}
\entry{\code {rl_deprep_terminal}}{44}
\entry{\code {rl_ding}}{45}
\entry{\code {rl_discard_keymap}}{37}
\entry{\code {rl_display_match_list}}{46}
\entry{\code {rl_do_undo}}{41}
\entry{\code {rl_echo_signal_char}}{54}
\entry{\code {rl_empty_keymap}}{37}
\entry{\code {rl_end_undo_group}}{41}
\entry{\code {rl_execute_next}}{44}
\entry{\code {rl_expand_prompt}}{42}
\entry{\code {rl_extend_line_buffer}}{45}
\entry{\code {rl_filename_completion_function}}{57}
\entry{\code {rl_forced_update_display}}{41}
\entry{\code {rl_free}}{45}
\entry{\code {rl_free_keymap}}{37}
\entry{\code {rl_free_line_state}}{54}
\entry{\code {rl_free_undo_list}}{41}
\entry{\code {rl_function_dumper}}{40}
\entry{\code {rl_function_of_keyseq}}{39}
\entry{\code {rl_function_of_keyseq_len}}{39}
\entry{\code {rl_funmap_names}}{40}
\entry{\code {rl_generic_bind}}{39}
\entry{\code {rl_get_keymap}}{37}
\entry{\code {rl_get_keymap_by_name}}{37}
\entry{\code {rl_get_keymap_name}}{37}
\entry{\code {rl_get_screen_size}}{55}
\entry{\code {rl_get_termcap}}{47}
\entry{\code {rl_getc}}{44}
\entry{\code {rl_initialize}}{45}
\entry{\code {rl_insert_completions}}{56}
\entry{\code {rl_insert_text}}{43}
\entry{\code {rl_invoking_keyseqs}}{40}
\entry{\code {rl_invoking_keyseqs_in_map}}{40}
\entry{\code {rl_keep_mark_active}}{47}
\entry{\code {rl_kill_text}}{43}
\entry{\code {rl_list_funmap_names}}{40}
\entry{\code {rl_macro_bind}}{46}
\entry{\code {rl_macro_dumper}}{46}
\entry{\code {rl_make_bare_keymap}}{36}
\entry{\code {rl_make_keymap}}{37}
\entry{\code {rl_mark_active_p}}{47}
\entry{\code {rl_message}}{42}
\entry{\code {rl_modifying}}{41}
\entry{\code {rl_named_function}}{39}
\entry{\code {rl_on_new_line}}{42}
\entry{\code {rl_on_new_line_with_prompt}}{42}
\entry{\code {rl_parse_and_bind}}{39}
\entry{\code {rl_pending_signal}}{54}
\entry{\code {rl_possible_completions}}{56}
\entry{\code {rl_prep_terminal}}{44}
\entry{\code {rl_print_keybinding}}{40}
\entry{\code {rl_push_macro_input}}{43}
\entry{\code {rl_read_init_file}}{39}
\entry{\code {rl_read_key}}{43}
\entry{\code {rl_redisplay}}{41}
\entry{\code {rl_reparse_colors}}{47}
\entry{\code {rl_replace_line}}{43}
\entry{\code {rl_reset_after_signal}}{54}
\entry{\code {rl_reset_line_state}}{42}
\entry{\code {rl_reset_screen_size}}{55}
\entry{\code {rl_reset_terminal}}{45}
\entry{\code {rl_resize_terminal}}{54}
\entry{\code {rl_restore_prompt}}{42}
\entry{\code {rl_restore_state}}{45}
\entry{\code {rl_save_prompt}}{42}
\entry{\code {rl_save_state}}{45}
\entry{\code {rl_set_key}}{39}
\entry{\code {rl_set_keyboard_input_timeout}}{44}
\entry{\code {rl_set_keymap}}{37}
\entry{\code {rl_set_keymap_name}}{37}
\entry{\code {rl_set_paren_blink_timeout}}{47}
\entry{\code {rl_set_prompt}}{43}
\entry{\code {rl_set_screen_size}}{54}
\entry{\code {rl_set_signals}}{55}
\entry{\code {rl_set_timeout}}{44}
\entry{\code {rl_show_char}}{42}
\entry{\code {rl_stuff_char}}{44}
\entry{\code {rl_timeout_remaining}}{44}
\entry{\code {rl_trim_arg_from_keyseq}}{40}
\entry{\code {rl_tty_set_default_bindings}}{45}
\entry{\code {rl_tty_set_echoing}}{45}
\entry{\code {rl_tty_unset_default_bindings}}{45}
\entry{\code {rl_unbind_command_in_map}}{38}
\entry{\code {rl_unbind_function_in_map}}{38}
\entry{\code {rl_unbind_key}}{38}
\entry{\code {rl_unbind_key_in_map}}{38}
\entry{\code {rl_username_completion_function}}{57}
\entry{\code {rl_variable_bind}}{46}
\entry{\code {rl_variable_dumper}}{47}
\entry{\code {rl_variable_value}}{47}
\initial {S}
\entry {\code {self-insert (a, b, A, 1, !, \dots {})}}{19}
\entry {\code {set-mark (C-@)}}{22}
\entry {show-all-if-ambiguous}{9}
\entry {show-all-if-unmodified}{9}
\entry {show-mode-in-prompt}{9}
\entry {skip-completed-text}{9}
\entry {\code {skip-csi-sequence ()}}{23}
\entry {\code {start-kbd-macro (C-x ()}}{21}
\entry{search-ignore-case}{11}
\entry{\code {self-insert (a, b, A, 1, !, \dots {})}}{21}
\entry{\code {set-mark (C-@)}}{25}
\entry{show-all-if-ambiguous}{11}
\entry{show-all-if-unmodified}{11}
\entry{show-mode-in-prompt}{11}
\entry{skip-completed-text}{11}
\entry{\code {skip-csi-sequence ()}}{25}
\entry{\code {start-kbd-macro (C-x ()}}{24}
\initial {T}
\entry {\code {tab-insert (M-\key {TAB})}}{19}
\entry {\code {tilde-expand (M-~)}}{22}
\entry {\code {transpose-chars (C-t)}}{19}
\entry {\code {transpose-words (M-t)}}{19}
\entry{\code {tab-insert (M-\key {TAB})}}{21}
\entry{\code {tilde-expand (M-~)}}{25}
\entry{\code {transpose-chars (C-t)}}{21}
\entry{\code {transpose-words (M-t)}}{22}
\initial {U}
\entry {\code {undo (C-_ or C-x C-u)}}{22}
\entry {\code {universal-argument ()}}{21}
\entry {\code {unix-filename-rubout ()}}{20}
\entry {\code {unix-line-discard (C-u)}}{20}
\entry {\code {unix-word-rubout (C-w)}}{20}
\entry {\code {upcase-word (M-u)}}{19}
\entry{\code {undo (C-_ or C-x C-u)}}{25}
\entry{\code {universal-argument ()}}{23}
\entry{\code {unix-filename-rubout ()}}{23}
\entry{\code {unix-line-discard (C-u)}}{22}
\entry{\code {unix-word-rubout (C-w)}}{23}
\entry{\code {upcase-word (M-u)}}{22}
\initial {V}
\entry {vi-cmd-mode-string}{10}
\entry {\code {vi-editing-mode (M-C-j)}}{23}
\entry {vi-ins-mode-string}{10}
\entry {visible-stats}{10}
\entry{vi-cmd-mode-string}{11}
\entry{\code {vi-editing-mode (M-C-j)}}{26}
\entry{vi-ins-mode-string}{12}
\entry{visible-stats}{12}
\initial {Y}
\entry {\code {yank (C-y)}}{20}
\entry {\code {yank-last-arg (M-. or M-_)}}{18}
\entry {\code {yank-nth-arg (M-C-y)}}{18}
\entry {\code {yank-pop (M-y)}}{20}
\entry{\code {yank (C-y)}}{23}
\entry{\code {yank-last-arg (M-. or M-_)}}{20}
\entry{\code {yank-nth-arg (M-C-y)}}{20}
\entry{\code {yank-pop (M-y)}}{23}
lib/readline/doc/rlman.log
+63 -45
View File
@@ -1,11 +1,11 @@
This is pdfTeX, Version 3.14159265-2.6-1.40.18 (TeX Live 2017/MacPorts 2017_2) (preloaded format=etex 2017.7.5) 2 JAN 2018 10:55
This is pdfTeX, Version 3.141592653-2.6-1.40.26 (TeX Live 2024/MacPorts 2024.70613_0) (preloaded format=etex 2024.4.9) 18 OCT 2024 11:25
entering extended mode
restricted \write18 enabled.
file:line:error style messages enabled.
%&-line parsing enabled.
**\catcode126=12 \def\normaltilde{~}\catcode126=13 \let~\normaltilde \input ./
./rlman.texi
(././rlman.texi (./texinfo.tex Loading texinfo [version 2015-11-22.14]:
**\nonstopmode \input ././rlman.texi
(././rlman.texi (/usr/local/src/bash/bash-20241015/lib/readline/doc/texinfo.tex
Loading texinfo [version 2015-11-22.14]:
\outerhsize=\dimen16
\outervsize=\dimen17
\cornerlong=\dimen18
@@ -39,15 +39,15 @@ entering extended mode
\boxB=\box20
\countA=\count32
\nopdfimagehelp=\toks20
fonts,
fonts,
\sffam=\fam8
\textleading=\dimen26
markup,
\fontdepth=\count33
glyphs,
\errorbox=\box21
page headings,
page headings,
\titlepagetopglue=\skip20
\titlepagebottomglue=\skip21
\evenheadline=\toks21
@@ -81,8 +81,7 @@ fonts,
\doublecolumntopgap=\dimen34
\savedtopmark=\toks26
\savedfirstmark=\toks27
sectioning,
sectioning,
\unnumberedno=\count38
\chapno=\count39
\secno=\count40
@@ -114,7 +113,8 @@ sectioning,
\nonfillparindent=\dimen39
\tabw=\dimen40
\verbbox=\box25
defuns,
defuns,
\defbodyindent=\skip39
\defargsindent=\skip40
\deflastargmargin=\skip41
@@ -160,26 +160,29 @@ This is `epsf.tex' v2.7.4 <14 February 2011>
texinfo.tex: doing @include of version.texi
(./version.texi) [1] [2] (./rlman.toc [-1]) [-2]
(/usr/local/src/bash/bash-20241015/lib/readline/doc/version.texi) [1] [2]
(/usr/local/src/bash/bash-20241015/lib/readline/doc/rlman.toc [-1]) [-2]
texinfo.tex: doing @include of rluser.texi
(./rluser.texi Chapter 1
(/usr/local/src/bash/bash-20241015/lib/readline/doc/rluser.texi Chapter 1
\openout0 = `rlman.toc'.
(./rlman.aux)
(/usr/local/src/bash/bash-20241015/lib/readline/doc/rlman.aux)
\openout1 = `rlman.aux'.
@cpindfile=@write2
\openout2 = `rlman.cp'.
[1] [2] [3]
[4]
@fnindfile=@write3
\openout3 = `rlman.fn'.
[4] [5] [6] [7] [8] [9]
Underfull \hbox (badness 7540) in paragraph at lines 805--811
[]@textrm In the above ex-am-ple, @textttsl C-u[] @textrm is bound to the func
[5] [6] [7] [8] [9] [10] [11]
Underfull \hbox (badness 7540) in paragraph at lines 959--965
[]@textrm In the ex-am-ple above, @textttsl C-u[] @textrm is bound to the func
-tion
@hbox(7.60416+2.12917)x433.62, glue set 4.22592
@@ -191,7 +194,7 @@ Underfull \hbox (badness 7540) in paragraph at lines 805--811
.etc.
Underfull \hbox (badness 10000) in paragraph at lines 805--811
Underfull \hbox (badness 10000) in paragraph at lines 959--965
@texttt universal-argument[]@textrm , @textttsl M-DEL[] @textrm is bound to th
e func-tion
@@ -203,8 +206,8 @@ e func-tion
.@texttt v
.etc.
[10] [11] [12] [13]
Overfull \hbox (26.43913pt too wide) in paragraph at lines 1039--1039
[12] [13] [14] [15]
Overfull \hbox (26.43913pt too wide) in paragraph at lines 1204--1204
[]@texttt Meta-Control-h: backward-kill-word Text after the function name is i
gnored[] |
@@ -216,17 +219,31 @@ gnored[] |
.@texttt t
.etc.
[14] [15] [16] [17] [18] [19] [20] [21] [22])
[16] [17] [18] [19] [20] [21] [22] [23] [24] [25])
texinfo.tex: doing @include of rltech.texi
(./rltech.texi Chapter 2 [23]
[24] [25] [26]
(/usr/local/src/bash/bash-20241015/lib/readline/doc/rltech.texi Chapter 2
[26] [27] [28] [29]
@vrindfile=@write4
\openout4 = `rlman.vr'.
[27] [28] [29] [30] [31] [32] [33] [34] [35] [36] [37] [38]
[39] [40] [41] [42] [43] [44]
Overfull \hbox (20.69044pt too wide) in paragraph at lines 1472--1472
[30] [31] [32] [33] [34] [35] [36] [37] [38] [39] [40]
[41] [42] [43] [44] [45] [46] [47] [48]
Overfull \hbox (32.18782pt too wide) in paragraph at lines 1634--1634
[] @texttt /* For positive arguments, put point after the last changed charac
ter. For[] |
@hbox(7.60416+2.43333)x433.62
.@glue(@leftskip) 28.90755
.@hbox(0.0+0.0)x0.0
.@penalty 10000
.@glue 5.74869
.@penalty 10000
.etc.
[49]
Overfull \hbox (20.69044pt too wide) in paragraph at lines 1702--1702
[]@texttt /* Handle SIGWINCH and window size changes when readline is not acti
ve and[] |
@@ -238,8 +255,8 @@ ve and[] |
.@penalty 10000
.etc.
Overfull \hbox (14.94176pt too wide) in paragraph at lines 1492--1492
[50]
Overfull \hbox (14.94176pt too wide) in paragraph at lines 1722--1722
[] @texttt /* This function needs to be called to reset the terminal sett
ings,[] |
@@ -252,7 +269,7 @@ ings,[] |
.etc.
Overfull \hbox (14.94176pt too wide) in paragraph at lines 1493--1493
Overfull \hbox (14.94176pt too wide) in paragraph at lines 1723--1723
[] @texttt and calling it from the line handler keeps one extra prompt
from[] |
@@ -264,8 +281,8 @@ Overfull \hbox (14.94176pt too wide) in paragraph at lines 1493--1493
.@penalty 10000
.etc.
[45]
Overfull \hbox (14.94176pt too wide) in paragraph at lines 1514--1514
Overfull \hbox (14.94176pt too wide) in paragraph at lines 1744--1744
[] @texttt /* Set the default locale values according to environment variable
s. */[] |
@@ -277,8 +294,8 @@ s. */[] |
.@penalty 10000
.etc.
[46] [47] [48] [49] [50] [51] [52] [53] [54] [55]
Underfull \hbox (badness 7379) in paragraph at lines 2191--2196
[51] [52] [53] [54] [55] [56] [57] [58] [59] [60] [61]
Underfull \hbox (badness 7379) in paragraph at lines 2524--2529
[]@textrm If an application-specific com-ple-tion func-tion as-signed to @text
tt rl_attempted_
@@ -290,19 +307,20 @@ tt rl_attempted_
.@glue 3.65 plus 1.825 minus 1.21666
.etc.
[56] [57] [58] [59] [60] [61] [62] [63]) Appendix A [64]
[62] [63] [64] [65] [66] [67] [68] [69] [70]) Appendix A [71]
texinfo.tex: doing @include of fdl.texi
(./fdl.texi [65]
[66] [67] [68] [69] [70] [71]) (Concept Index) [72]
(Function and Variable Index) [73] [74] [75] [76] )
Here is how much of TeX's memory you used:
3278 strings out of 497114
33958 string characters out of 6207173
139278 words of memory out of 5000000
4450 multiletter control sequences out of 15000+600000
32778 words of font info for 114 fonts, out of 8000000 for 9000
51 hyphenation exceptions out of 8191
19i,6n,17p,360b,808s stack positions out of 5000i,500n,10000p,200000b,80000s
Output written on rlman.dvi (80 pages, 315852 bytes).
(/usr/local/src/bash/bash-20241015/lib/readline/doc/fdl.texi [72] [73] [74]
[75] [76] [77] [78]) (Concept Index) [79] (Function and Variable Index)
[80] [81] [82] [83] [84] )
Here is how much of TeX's memory you used:
3279 strings out of 495850
34716 string characters out of 6172145
126582 words of memory out of 5000000
4635 multiletter control sequences out of 15000+600000
32778 words of font info for 114 fonts, out of 8000000 for 9000
701 hyphenation exceptions out of 8191
19i,6n,17p,305b,808s stack positions out of 10000i,1000n,20000p,200000b,200000s
Output written on rlman.dvi (88 pages, 345732 bytes).
lib/readline/doc/rlman.toc
+44 -44
View File
@@ -1,52 +1,52 @@
@numchapentry{Command Line Editing}{1}{Command Line Editing}{1}
@numsecentry{Introduction to Line Editing}{1.1}{Introduction and Notation}{1}
@numsecentry{Readline Interaction}{1.2}{Readline Interaction}{1}
@numsubsecentry{Readline Bare Essentials}{1.2.1}{Readline Bare Essentials}{1}
@numsubsecentry{Readline Bare Essentials}{1.2.1}{Readline Bare Essentials}{2}
@numsubsecentry{Readline Movement Commands}{1.2.2}{Readline Movement Commands}{2}
@numsubsecentry{Readline Killing Commands}{1.2.3}{Readline Killing Commands}{2}
@numsubsecentry{Readline Killing Commands}{1.2.3}{Readline Killing Commands}{3}
@numsubsecentry{Readline Arguments}{1.2.4}{Readline Arguments}{3}
@numsubsecentry{Searching for Commands in the History}{1.2.5}{Searching}{3}
@numsecentry{Readline Init File}{1.3}{Readline Init File}{4}
@numsubsecentry{Readline Init File Syntax}{1.3.1}{Readline Init File Syntax}{4}
@numsubsecentry{Conditional Init Constructs}{1.3.2}{Conditional Init Constructs}{12}
@numsubsecentry{Sample Init File}{1.3.3}{Sample Init File}{13}
@numsecentry{Bindable Readline Commands}{1.4}{Bindable Readline Commands}{16}
@numsubsecentry{Commands For Moving}{1.4.1}{Commands For Moving}{16}
@numsubsecentry{Commands For Manipulating The History}{1.4.2}{Commands For History}{17}
@numsubsecentry{Commands For Changing Text}{1.4.3}{Commands For Text}{18}
@numsubsecentry{Killing And Yanking}{1.4.4}{Commands For Killing}{19}
@numsubsecentry{Specifying Numeric Arguments}{1.4.5}{Numeric Arguments}{20}
@numsubsecentry{Letting Readline Type For You}{1.4.6}{Commands For Completion}{21}
@numsubsecentry{Keyboard Macros}{1.4.7}{Keyboard Macros}{21}
@numsubsecentry{Some Miscellaneous Commands}{1.4.8}{Miscellaneous Commands}{22}
@numsecentry{Readline vi Mode}{1.5}{Readline vi Mode}{23}
@numchapentry{Programming with GNU Readline}{2}{Programming with GNU Readline}{24}
@numsecentry{Basic Behavior}{2.1}{Basic Behavior}{24}
@numsecentry{Custom Functions}{2.2}{Custom Functions}{25}
@numsubsecentry{Readline Typedefs}{2.2.1}{Readline Typedefs}{26}
@numsubsecentry{Writing a New Function}{2.2.2}{Function Writing}{26}
@numsecentry{Readline Variables}{2.3}{Readline Variables}{27}
@numsecentry{Readline Convenience Functions}{2.4}{Readline Convenience Functions}{32}
@numsubsecentry{Naming a Function}{2.4.1}{Function Naming}{32}
@numsubsecentry{Selecting a Keymap}{2.4.2}{Keymaps}{33}
@numsubsecentry{Binding Keys}{2.4.3}{Binding Keys}{33}
@numsubsecentry{Associating Function Names and Bindings}{2.4.4}{Associating Function Names and Bindings}{35}
@numsubsecentry{Allowing Undoing}{2.4.5}{Allowing Undoing}{36}
@numsubsecentry{Redisplay}{2.4.6}{Redisplay}{37}
@numsubsecentry{Modifying Text}{2.4.7}{Modifying Text}{38}
@numsubsecentry{Character Input}{2.4.8}{Character Input}{39}
@numsubsecentry{Terminal Management}{2.4.9}{Terminal Management}{39}
@numsubsecentry{Utility Functions}{2.4.10}{Utility Functions}{40}
@numsubsecentry{Miscellaneous Functions}{2.4.11}{Miscellaneous Functions}{41}
@numsubsecentry{Alternate Interface}{2.4.12}{Alternate Interface}{42}
@numsubsecentry{A Readline Example}{2.4.13}{A Readline Example}{43}
@numsubsecentry{Alternate Interface Example}{2.4.14}{Alternate Interface Example}{44}
@numsecentry{Readline Signal Handling}{2.5}{Readline Signal Handling}{47}
@numsecentry{Custom Completers}{2.6}{Custom Completers}{49}
@numsubsecentry{How Completing Works}{2.6.1}{How Completing Works}{50}
@numsubsecentry{Completion Functions}{2.6.2}{Completion Functions}{50}
@numsubsecentry{Completion Variables}{2.6.3}{Completion Variables}{52}
@numsubsecentry{A Short Completion Example}{2.6.4}{A Short Completion Example}{56}
@appentry{GNU Free Documentation License}{A}{GNU Free Documentation License}{65}
@unnchapentry{Concept Index}{10001}{Concept Index}{73}
@unnchapentry{Function and Variable Index}{10002}{Function and Variable Index}{74}
@numsubsecentry{Conditional Init Constructs}{1.3.2}{Conditional Init Constructs}{14}
@numsubsecentry{Sample Init File}{1.3.3}{Sample Init File}{15}
@numsecentry{Bindable Readline Commands}{1.4}{Bindable Readline Commands}{18}
@numsubsecentry{Commands For Moving}{1.4.1}{Commands For Moving}{18}
@numsubsecentry{Commands For Manipulating The History}{1.4.2}{Commands For History}{19}
@numsubsecentry{Commands For Changing Text}{1.4.3}{Commands For Text}{21}
@numsubsecentry{Killing And Yanking}{1.4.4}{Commands For Killing}{22}
@numsubsecentry{Specifying Numeric Arguments}{1.4.5}{Numeric Arguments}{23}
@numsubsecentry{Letting Readline Type For You}{1.4.6}{Commands For Completion}{24}
@numsubsecentry{Keyboard Macros}{1.4.7}{Keyboard Macros}{24}
@numsubsecentry{Some Miscellaneous Commands}{1.4.8}{Miscellaneous Commands}{25}
@numsecentry{Readline vi Mode}{1.5}{Readline vi Mode}{26}
@numchapentry{Programming with GNU Readline}{2}{Programming with GNU Readline}{27}
@numsecentry{Basic Behavior}{2.1}{Basic Behavior}{27}
@numsecentry{Custom Functions}{2.2}{Custom Functions}{28}
@numsubsecentry{Readline Typedefs}{2.2.1}{Readline Typedefs}{29}
@numsubsecentry{Writing a New Function}{2.2.2}{Function Writing}{30}
@numsecentry{Readline Variables}{2.3}{Readline Variables}{30}
@numsecentry{Readline Convenience Functions}{2.4}{Readline Convenience Functions}{36}
@numsubsecentry{Naming a Function}{2.4.1}{Function Naming}{36}
@numsubsecentry{Selecting a Keymap}{2.4.2}{Keymaps}{36}
@numsubsecentry{Binding Keys}{2.4.3}{Binding Keys}{37}
@numsubsecentry{Associating Function Names and Bindings}{2.4.4}{Associating Function Names and Bindings}{39}
@numsubsecentry{Allowing Undoing}{2.4.5}{Allowing Undoing}{40}
@numsubsecentry{Redisplay}{2.4.6}{Redisplay}{41}
@numsubsecentry{Modifying Text}{2.4.7}{Modifying Text}{43}
@numsubsecentry{Character Input}{2.4.8}{Character Input}{43}
@numsubsecentry{Terminal Management}{2.4.9}{Terminal Management}{44}
@numsubsecentry{Utility Functions}{2.4.10}{Utility Functions}{45}
@numsubsecentry{Miscellaneous Functions}{2.4.11}{Miscellaneous Functions}{46}
@numsubsecentry{Alternate Interface}{2.4.12}{Alternate Interface}{47}
@numsubsecentry{A Readline Example}{2.4.13}{A Readline Example}{48}
@numsubsecentry{Alternate Interface Example}{2.4.14}{Alternate Interface Example}{50}
@numsecentry{Readline Signal Handling}{2.5}{Readline Signal Handling}{52}
@numsecentry{Custom Completers}{2.6}{Custom Completers}{55}
@numsubsecentry{How Completing Works}{2.6.1}{How Completing Works}{55}
@numsubsecentry{Completion Functions}{2.6.2}{Completion Functions}{56}
@numsubsecentry{Completion Variables}{2.6.3}{Completion Variables}{57}
@numsubsecentry{A Short Completion Example}{2.6.4}{A Short Completion Example}{63}
@appentry{GNU Free Documentation License}{A}{GNU Free Documentation License}{72}
@unnchapentry{Concept Index}{10001}{Concept Index}{80}
@unnchapentry{Function and Variable Index}{10002}{Function and Variable Index}{81}
lib/readline/doc/rlman.vr
+83 -78
View File
@@ -1,78 +1,83 @@
\entry{rl_line_buffer}{27}{\code {rl_line_buffer}}
\entry{rl_point}{27}{\code {rl_point}}
\entry{rl_end}{27}{\code {rl_end}}
\entry{rl_mark}{27}{\code {rl_mark}}
\entry{rl_done}{27}{\code {rl_done}}
\entry{rl_num_chars_to_read}{27}{\code {rl_num_chars_to_read}}
\entry{rl_pending_input}{27}{\code {rl_pending_input}}
\entry{rl_dispatching}{27}{\code {rl_dispatching}}
\entry{rl_erase_empty_line}{28}{\code {rl_erase_empty_line}}
\entry{rl_prompt}{28}{\code {rl_prompt}}
\entry{rl_display_prompt}{28}{\code {rl_display_prompt}}
\entry{rl_already_prompted}{28}{\code {rl_already_prompted}}
\entry{rl_library_version}{28}{\code {rl_library_version}}
\entry{rl_readline_version}{28}{\code {rl_readline_version}}
\entry{rl_gnu_readline_p}{28}{\code {rl_gnu_readline_p}}
\entry{rl_terminal_name}{28}{\code {rl_terminal_name}}
\entry{rl_readline_name}{28}{\code {rl_readline_name}}
\entry{rl_instream}{28}{\code {rl_instream}}
\entry{rl_outstream}{28}{\code {rl_outstream}}
\entry{rl_prefer_env_winsize}{29}{\code {rl_prefer_env_winsize}}
\entry{rl_last_func}{29}{\code {rl_last_func}}
\entry{rl_startup_hook}{29}{\code {rl_startup_hook}}
\entry{rl_pre_input_hook}{29}{\code {rl_pre_input_hook}}
\entry{rl_event_hook}{29}{\code {rl_event_hook}}
\entry{rl_getc_function}{29}{\code {rl_getc_function}}
\entry{rl_signal_event_hook}{29}{\code {rl_signal_event_hook}}
\entry{rl_input_available_hook}{29}{\code {rl_input_available_hook}}
\entry{rl_redisplay_function}{30}{\code {rl_redisplay_function}}
\entry{rl_prep_term_function}{30}{\code {rl_prep_term_function}}
\entry{rl_deprep_term_function}{30}{\code {rl_deprep_term_function}}
\entry{rl_executing_keymap}{30}{\code {rl_executing_keymap}}
\entry{rl_binding_keymap}{30}{\code {rl_binding_keymap}}
\entry{rl_executing_macro}{30}{\code {rl_executing_macro}}
\entry{rl_executing_key}{30}{\code {rl_executing_key}}
\entry{rl_executing_keyseq}{30}{\code {rl_executing_keyseq}}
\entry{rl_key_sequence_length}{30}{\code {rl_key_sequence_length}}
\entry{rl_readline_state}{30}{\code {rl_readline_state}}
\entry{rl_explicit_arg}{32}{\code {rl_explicit_arg}}
\entry{rl_numeric_arg}{32}{\code {rl_numeric_arg}}
\entry{rl_editing_mode}{32}{\code {rl_editing_mode}}
\entry{rl_catch_signals}{48}{\code {rl_catch_signals}}
\entry{rl_catch_sigwinch}{48}{\code {rl_catch_sigwinch}}
\entry{rl_persistent_signal_handlers}{48}{\code {rl_persistent_signal_handlers}}
\entry{rl_change_environment}{48}{\code {rl_change_environment}}
\entry{rl_completion_entry_function}{50}{\code {rl_completion_entry_function}}
\entry{rl_completion_entry_function}{52}{\code {rl_completion_entry_function}}
\entry{rl_attempted_completion_function}{52}{\code {rl_attempted_completion_function}}
\entry{rl_filename_quoting_function}{52}{\code {rl_filename_quoting_function}}
\entry{rl_filename_dequoting_function}{52}{\code {rl_filename_dequoting_function}}
\entry{rl_char_is_quoted_p}{52}{\code {rl_char_is_quoted_p}}
\entry{rl_ignore_some_completions_function}{53}{\code {rl_ignore_some_completions_function}}
\entry{rl_directory_completion_hook}{53}{\code {rl_directory_completion_hook}}
\entry{rl_directory_rewrite_hook;}{53}{\code {rl_directory_rewrite_hook;}}
\entry{rl_filename_stat_hook}{53}{\code {rl_filename_stat_hook}}
\entry{rl_filename_rewrite_hook}{53}{\code {rl_filename_rewrite_hook}}
\entry{rl_completion_display_matches_hook}{54}{\code {rl_completion_display_matches_hook}}
\entry{rl_basic_word_break_characters}{54}{\code {rl_basic_word_break_characters}}
\entry{rl_basic_quote_characters}{54}{\code {rl_basic_quote_characters}}
\entry{rl_completer_word_break_characters}{54}{\code {rl_completer_word_break_characters}}
\entry{rl_completion_word_break_hook}{54}{\code {rl_completion_word_break_hook}}
\entry{rl_completer_quote_characters}{54}{\code {rl_completer_quote_characters}}
\entry{rl_filename_quote_characters}{54}{\code {rl_filename_quote_characters}}
\entry{rl_special_prefixes}{54}{\code {rl_special_prefixes}}
\entry{rl_completion_query_items}{55}{\code {rl_completion_query_items}}
\entry{rl_completion_append_character}{55}{\code {rl_completion_append_character}}
\entry{rl_completion_suppress_append}{55}{\code {rl_completion_suppress_append}}
\entry{rl_completion_quote_character}{55}{\code {rl_completion_quote_character}}
\entry{rl_completion_suppress_quote}{55}{\code {rl_completion_suppress_quote}}
\entry{rl_completion_found_quote}{55}{\code {rl_completion_found_quote}}
\entry{rl_completion_mark_symlink_dirs}{55}{\code {rl_completion_mark_symlink_dirs}}
\entry{rl_ignore_completion_duplicates}{55}{\code {rl_ignore_completion_duplicates}}
\entry{rl_filename_completion_desired}{56}{\code {rl_filename_completion_desired}}
\entry{rl_filename_quoting_desired}{56}{\code {rl_filename_quoting_desired}}
\entry{rl_attempted_completion_over}{56}{\code {rl_attempted_completion_over}}
\entry{rl_sort_completion_matches}{56}{\code {rl_sort_completion_matches}}
\entry{rl_completion_type}{56}{\code {rl_completion_type}}
\entry{rl_completion_invoking_key}{56}{\code {rl_completion_invoking_key}}
\entry{rl_inhibit_completion}{56}{\code {rl_inhibit_completion}}
\entry{rl_line_buffer}{30}{\code {rl_line_buffer}}
\entry{rl_point}{30}{\code {rl_point}}
\entry{rl_end}{30}{\code {rl_end}}
\entry{rl_mark}{30}{\code {rl_mark}}
\entry{rl_done}{30}{\code {rl_done}}
\entry{rl_eof_found}{30}{\code {rl_eof_found}}
\entry{rl_num_chars_to_read}{31}{\code {rl_num_chars_to_read}}
\entry{rl_pending_input}{31}{\code {rl_pending_input}}
\entry{rl_dispatching}{31}{\code {rl_dispatching}}
\entry{rl_erase_empty_line}{31}{\code {rl_erase_empty_line}}
\entry{rl_prompt}{31}{\code {rl_prompt}}
\entry{rl_display_prompt}{31}{\code {rl_display_prompt}}
\entry{rl_already_prompted}{31}{\code {rl_already_prompted}}
\entry{rl_library_version}{31}{\code {rl_library_version}}
\entry{rl_readline_version}{31}{\code {rl_readline_version}}
\entry{rl_gnu_readline_p}{31}{\code {rl_gnu_readline_p}}
\entry{rl_terminal_name}{32}{\code {rl_terminal_name}}
\entry{rl_readline_name}{32}{\code {rl_readline_name}}
\entry{rl_instream}{32}{\code {rl_instream}}
\entry{rl_outstream}{32}{\code {rl_outstream}}
\entry{rl_prefer_env_winsize}{32}{\code {rl_prefer_env_winsize}}
\entry{rl_last_func}{32}{\code {rl_last_func}}
\entry{rl_startup_hook}{32}{\code {rl_startup_hook}}
\entry{rl_pre_input_hook}{32}{\code {rl_pre_input_hook}}
\entry{rl_event_hook}{32}{\code {rl_event_hook}}
\entry{rl_getc_function}{32}{\code {rl_getc_function}}
\entry{rl_signal_event_hook}{32}{\code {rl_signal_event_hook}}
\entry{rl_timeout_event_hook}{33}{\code {rl_timeout_event_hook}}
\entry{rl_input_available_hook}{33}{\code {rl_input_available_hook}}
\entry{rl_redisplay_function}{33}{\code {rl_redisplay_function}}
\entry{rl_prep_term_function}{33}{\code {rl_prep_term_function}}
\entry{rl_deprep_term_function}{33}{\code {rl_deprep_term_function}}
\entry{rl_macro_display_hook}{33}{\code {rl_macro_display_hook}}
\entry{rl_executing_keymap}{33}{\code {rl_executing_keymap}}
\entry{rl_binding_keymap}{34}{\code {rl_binding_keymap}}
\entry{rl_executing_macro}{34}{\code {rl_executing_macro}}
\entry{rl_executing_key}{34}{\code {rl_executing_key}}
\entry{rl_executing_keyseq}{34}{\code {rl_executing_keyseq}}
\entry{rl_key_sequence_length}{34}{\code {rl_key_sequence_length}}
\entry{rl_readline_state}{34}{\code {rl_readline_state}}
\entry{rl_explicit_arg}{36}{\code {rl_explicit_arg}}
\entry{rl_numeric_arg}{36}{\code {rl_numeric_arg}}
\entry{rl_editing_mode}{36}{\code {rl_editing_mode}}
\entry{rl_catch_signals}{53}{\code {rl_catch_signals}}
\entry{rl_catch_sigwinch}{53}{\code {rl_catch_sigwinch}}
\entry{rl_persistent_signal_handlers}{53}{\code {rl_persistent_signal_handlers}}
\entry{rl_change_environment}{53}{\code {rl_change_environment}}
\entry{rl_completion_entry_function}{56}{\code {rl_completion_entry_function}}
\entry{rl_completion_entry_function}{57}{\code {rl_completion_entry_function}}
\entry{rl_attempted_completion_function}{57}{\code {rl_attempted_completion_function}}
\entry{rl_filename_quoting_function}{57}{\code {rl_filename_quoting_function}}
\entry{rl_filename_dequoting_function}{58}{\code {rl_filename_dequoting_function}}
\entry{rl_char_is_quoted_p}{58}{\code {rl_char_is_quoted_p}}
\entry{rl_ignore_some_completions_function}{58}{\code {rl_ignore_some_completions_function}}
\entry{rl_directory_completion_hook}{58}{\code {rl_directory_completion_hook}}
\entry{rl_directory_rewrite_hook;}{58}{\code {rl_directory_rewrite_hook;}}
\entry{rl_filename_stat_hook}{59}{\code {rl_filename_stat_hook}}
\entry{rl_filename_rewrite_hook}{59}{\code {rl_filename_rewrite_hook}}
\entry{rl_completion_rewrite_hook}{59}{\code {rl_completion_rewrite_hook}}
\entry{rl_completion_display_matches_hook}{60}{\code {rl_completion_display_matches_hook}}
\entry{rl_basic_word_break_characters}{60}{\code {rl_basic_word_break_characters}}
\entry{rl_basic_quote_characters}{60}{\code {rl_basic_quote_characters}}
\entry{rl_completer_word_break_characters}{60}{\code {rl_completer_word_break_characters}}
\entry{rl_completion_word_break_hook}{60}{\code {rl_completion_word_break_hook}}
\entry{rl_completer_quote_characters}{60}{\code {rl_completer_quote_characters}}
\entry{rl_filename_quote_characters}{60}{\code {rl_filename_quote_characters}}
\entry{rl_special_prefixes}{60}{\code {rl_special_prefixes}}
\entry{rl_completion_query_items}{60}{\code {rl_completion_query_items}}
\entry{rl_completion_append_character}{61}{\code {rl_completion_append_character}}
\entry{rl_completion_suppress_append}{61}{\code {rl_completion_suppress_append}}
\entry{rl_completion_suppress_quote}{61}{\code {rl_completion_suppress_quote}}
\entry{rl_completion_found_quote}{61}{\code {rl_completion_found_quote}}
\entry{rl_completion_quote_character}{61}{\code {rl_completion_quote_character}}
\entry{rl_completion_mark_symlink_dirs}{61}{\code {rl_completion_mark_symlink_dirs}}
\entry{rl_ignore_completion_duplicates}{61}{\code {rl_ignore_completion_duplicates}}
\entry{rl_filename_completion_desired}{61}{\code {rl_filename_completion_desired}}
\entry{rl_filename_quoting_desired}{62}{\code {rl_filename_quoting_desired}}
\entry{rl_full_quoting_desired}{62}{\code {rl_full_quoting_desired}}
\entry{rl_attempted_completion_over}{62}{\code {rl_attempted_completion_over}}
\entry{rl_sort_completion_matches}{62}{\code {rl_sort_completion_matches}}
\entry{rl_completion_type}{62}{\code {rl_completion_type}}
\entry{rl_completion_invoking_key}{62}{\code {rl_completion_invoking_key}}
\entry{rl_inhibit_completion}{62}{\code {rl_inhibit_completion}}
lib/readline/doc/rlman.vrs
+82 -77
View File
@@ -1,77 +1,82 @@
\entry {\code {rl_already_prompted}}{28}
\entry {\code {rl_attempted_completion_function}}{52}
\entry {\code {rl_attempted_completion_over}}{56}
\entry {\code {rl_basic_quote_characters}}{54}
\entry {\code {rl_basic_word_break_characters}}{54}
\entry {\code {rl_binding_keymap}}{30}
\entry {\code {rl_catch_signals}}{48}
\entry {\code {rl_catch_sigwinch}}{48}
\entry {\code {rl_change_environment}}{48}
\entry {\code {rl_char_is_quoted_p}}{52}
\entry {\code {rl_completer_quote_characters}}{54}
\entry {\code {rl_completer_word_break_characters}}{54}
\entry {\code {rl_completion_append_character}}{55}
\entry {\code {rl_completion_display_matches_hook}}{54}
\entry {\code {rl_completion_entry_function}}{50, 52}
\entry {\code {rl_completion_found_quote}}{55}
\entry {\code {rl_completion_invoking_key}}{56}
\entry {\code {rl_completion_mark_symlink_dirs}}{55}
\entry {\code {rl_completion_query_items}}{55}
\entry {\code {rl_completion_quote_character}}{55}
\entry {\code {rl_completion_suppress_append}}{55}
\entry {\code {rl_completion_suppress_quote}}{55}
\entry {\code {rl_completion_type}}{56}
\entry {\code {rl_completion_word_break_hook}}{54}
\entry {\code {rl_deprep_term_function}}{30}
\entry {\code {rl_directory_completion_hook}}{53}
\entry {\code {rl_directory_rewrite_hook;}}{53}
\entry {\code {rl_dispatching}}{27}
\entry {\code {rl_display_prompt}}{28}
\entry {\code {rl_done}}{27}
\entry {\code {rl_editing_mode}}{32}
\entry {\code {rl_end}}{27}
\entry {\code {rl_erase_empty_line}}{28}
\entry {\code {rl_event_hook}}{29}
\entry {\code {rl_executing_key}}{30}
\entry {\code {rl_executing_keymap}}{30}
\entry {\code {rl_executing_keyseq}}{30}
\entry {\code {rl_executing_macro}}{30}
\entry {\code {rl_explicit_arg}}{32}
\entry {\code {rl_filename_completion_desired}}{56}
\entry {\code {rl_filename_dequoting_function}}{52}
\entry {\code {rl_filename_quote_characters}}{54}
\entry {\code {rl_filename_quoting_desired}}{56}
\entry {\code {rl_filename_quoting_function}}{52}
\entry {\code {rl_filename_rewrite_hook}}{53}
\entry {\code {rl_filename_stat_hook}}{53}
\entry {\code {rl_getc_function}}{29}
\entry {\code {rl_gnu_readline_p}}{28}
\entry {\code {rl_ignore_completion_duplicates}}{55}
\entry {\code {rl_ignore_some_completions_function}}{53}
\entry {\code {rl_inhibit_completion}}{56}
\entry {\code {rl_input_available_hook}}{29}
\entry {\code {rl_instream}}{28}
\entry {\code {rl_key_sequence_length}}{30}
\entry {\code {rl_last_func}}{29}
\entry {\code {rl_library_version}}{28}
\entry {\code {rl_line_buffer}}{27}
\entry {\code {rl_mark}}{27}
\entry {\code {rl_num_chars_to_read}}{27}
\entry {\code {rl_numeric_arg}}{32}
\entry {\code {rl_outstream}}{28}
\entry {\code {rl_pending_input}}{27}
\entry {\code {rl_persistent_signal_handlers}}{48}
\entry {\code {rl_point}}{27}
\entry {\code {rl_pre_input_hook}}{29}
\entry {\code {rl_prefer_env_winsize}}{29}
\entry {\code {rl_prep_term_function}}{30}
\entry {\code {rl_prompt}}{28}
\entry {\code {rl_readline_name}}{28}
\entry {\code {rl_readline_state}}{30}
\entry {\code {rl_readline_version}}{28}
\entry {\code {rl_redisplay_function}}{30}
\entry {\code {rl_signal_event_hook}}{29}
\entry {\code {rl_sort_completion_matches}}{56}
\entry {\code {rl_special_prefixes}}{54}
\entry {\code {rl_startup_hook}}{29}
\entry {\code {rl_terminal_name}}{28}
\entry{\code {rl_already_prompted}}{31}
\entry{\code {rl_attempted_completion_function}}{57}
\entry{\code {rl_attempted_completion_over}}{62}
\entry{\code {rl_basic_quote_characters}}{60}
\entry{\code {rl_basic_word_break_characters}}{60}
\entry{\code {rl_binding_keymap}}{34}
\entry{\code {rl_catch_signals}}{53}
\entry{\code {rl_catch_sigwinch}}{53}
\entry{\code {rl_change_environment}}{53}
\entry{\code {rl_char_is_quoted_p}}{58}
\entry{\code {rl_completer_quote_characters}}{60}
\entry{\code {rl_completer_word_break_characters}}{60}
\entry{\code {rl_completion_append_character}}{61}
\entry{\code {rl_completion_display_matches_hook}}{60}
\entry{\code {rl_completion_entry_function}}{56, 57}
\entry{\code {rl_completion_found_quote}}{61}
\entry{\code {rl_completion_invoking_key}}{62}
\entry{\code {rl_completion_mark_symlink_dirs}}{61}
\entry{\code {rl_completion_query_items}}{60}
\entry{\code {rl_completion_quote_character}}{61}
\entry{\code {rl_completion_rewrite_hook}}{59}
\entry{\code {rl_completion_suppress_append}}{61}
\entry{\code {rl_completion_suppress_quote}}{61}
\entry{\code {rl_completion_type}}{62}
\entry{\code {rl_completion_word_break_hook}}{60}
\entry{\code {rl_deprep_term_function}}{33}
\entry{\code {rl_directory_completion_hook}}{58}
\entry{\code {rl_directory_rewrite_hook;}}{58}
\entry{\code {rl_dispatching}}{31}
\entry{\code {rl_display_prompt}}{31}
\entry{\code {rl_done}}{30}
\entry{\code {rl_editing_mode}}{36}
\entry{\code {rl_end}}{30}
\entry{\code {rl_eof_found}}{30}
\entry{\code {rl_erase_empty_line}}{31}
\entry{\code {rl_event_hook}}{32}
\entry{\code {rl_executing_key}}{34}
\entry{\code {rl_executing_keymap}}{33}
\entry{\code {rl_executing_keyseq}}{34}
\entry{\code {rl_executing_macro}}{34}
\entry{\code {rl_explicit_arg}}{36}
\entry{\code {rl_filename_completion_desired}}{61}
\entry{\code {rl_filename_dequoting_function}}{58}
\entry{\code {rl_filename_quote_characters}}{60}
\entry{\code {rl_filename_quoting_desired}}{62}
\entry{\code {rl_filename_quoting_function}}{57}
\entry{\code {rl_filename_rewrite_hook}}{59}
\entry{\code {rl_filename_stat_hook}}{59}
\entry{\code {rl_full_quoting_desired}}{62}
\entry{\code {rl_getc_function}}{32}
\entry{\code {rl_gnu_readline_p}}{31}
\entry{\code {rl_ignore_completion_duplicates}}{61}
\entry{\code {rl_ignore_some_completions_function}}{58}
\entry{\code {rl_inhibit_completion}}{62}
\entry{\code {rl_input_available_hook}}{33}
\entry{\code {rl_instream}}{32}
\entry{\code {rl_key_sequence_length}}{34}
\entry{\code {rl_last_func}}{32}
\entry{\code {rl_library_version}}{31}
\entry{\code {rl_line_buffer}}{30}
\entry{\code {rl_macro_display_hook}}{33}
\entry{\code {rl_mark}}{30}
\entry{\code {rl_num_chars_to_read}}{31}
\entry{\code {rl_numeric_arg}}{36}
\entry{\code {rl_outstream}}{32}
\entry{\code {rl_pending_input}}{31}
\entry{\code {rl_persistent_signal_handlers}}{53}
\entry{\code {rl_point}}{30}
\entry{\code {rl_pre_input_hook}}{32}
\entry{\code {rl_prefer_env_winsize}}{32}
\entry{\code {rl_prep_term_function}}{33}
\entry{\code {rl_prompt}}{31}
\entry{\code {rl_readline_name}}{32}
\entry{\code {rl_readline_state}}{34}
\entry{\code {rl_readline_version}}{31}
\entry{\code {rl_redisplay_function}}{33}
\entry{\code {rl_signal_event_hook}}{32}
\entry{\code {rl_sort_completion_matches}}{62}
\entry{\code {rl_special_prefixes}}{60}
\entry{\code {rl_startup_hook}}{32}
\entry{\code {rl_terminal_name}}{32}
\entry{\code {rl_timeout_event_hook}}{33}
lib/readline/doc/rltech.texi
+7 -7
View File
@@ -72,8 +72,8 @@ Since it's possible to enter characters into the line while quoting
them to disable any Readline editing function they might normally have,
this line may include embedded newlines and other special characters.
If @var{prompt} is @code{NULL} or the empty string,
@code{readline} does not display a prompt.
The line @code{readline} returns is allocated with @code{malloc()};
@code{readline()} does not display a prompt.
The line @code{readline()} returns is allocated with @code{malloc()};
the caller should @code{free()} the line when it has finished with it.
The declaration for @code{readline} in ANSI C is
@@ -92,9 +92,9 @@ The line returned has the final newline removed, so only the
text remains.
This means that lines consisting of a newline return the empty string.
If @code{readline} encounters an @code{EOF} while reading the line,
If Readline encounters an @code{EOF} while reading the line,
and the line is empty at that point,
then @code{readline} returns @code{(char *)NULL}.
then @code{readline()} returns @code{(char *)NULL}.
Otherwise, the line is ended just as if a newline had been typed.
Readline performs some expansion on the @var{prompt} before it is
@@ -467,12 +467,12 @@ twice in succession, for example.
@deftypevar {rl_hook_func_t *} rl_startup_hook
If non-zero, this is the address of a function to call just
before @code{readline} prints the first prompt.
before Readline prints the first prompt.
@end deftypevar
@deftypevar {rl_hook_func_t *} rl_pre_input_hook
If non-zero, this is the address of a function to call after
the first prompt has been printed and just before @code{readline}
the first prompt has been printed and just before Readline
starts reading input characters.
@end deftypevar
@@ -629,7 +629,7 @@ Readline is in overwrite mode.
@item RL_STATE_COMPLETING
Readline is performing word completion.
@item RL_STATE_SIGHANDLER
Readline is currently executing the readline signal handler.
Readline is currently executing the Readline signal handler.
@item RL_STATE_UNDOING
Readline is performing an undo.
@item RL_STATE_INPUTPENDING
lib/readline/doc/rluser.texi
+19 -18
View File
@@ -82,8 +82,8 @@ Line editing can be enabled at any time using the @option{-o emacs} or
@node Introduction and Notation
@section Introduction to Line Editing
The following paragraphs describe the notation used to represent
keystrokes.
The following paragraphs use Emacs style to
describe the notation used to represent keystrokes.
The text @kbd{C-k} is read as `Control-K' and describes the character
produced when the @key{k} key is pressed while the Control key
@@ -91,16 +91,16 @@ is depressed.
The text @kbd{M-k} is read as `Meta-K' and describes the character
produced when the Meta key (if you have one) is depressed, and the @key{k}
key is pressed (a @dfn{meta character}).
The Meta key is labeled @key{ALT} on many keyboards.
key is pressed (a @dfn{meta character}), then both are released.
The Meta key is labeled @key{ALT} or @key{Option} on many keyboards.
On keyboards with two keys labeled @key{ALT} (usually to either side of
the space bar), the @key{ALT} on the left side is generally set to
work as a Meta key.
The @key{ALT} key on the right may also be configured to work as a
Meta key or may be configured as some other modifier, such as a
One of the @key{ALT} keys may also be configured
as some other modifier, such as a
Compose key for typing accented characters.
On some keyboards, the Meta key modifier produces meta characters with
On some keyboards, the Meta key modifier produces characters with
the eighth bit (0200) set.
You can use the @code{enable-meta-key} variable
to control whether or not it does this, if the keyboard allows it.
@@ -381,7 +381,7 @@ shell variable @env{INPUTRC}.
environment variable @env{INPUTRC}.
@end ifclear
If that variable is unset, the default is @file{~/.inputrc}.
If that file does not exist or cannot be read, readline looks for
If that file does not exist or cannot be read, Readline looks for
@file{/etc/inputrc}.
@ifset BashFeatures
The @w{@code{bind}} builtin command can also be used to set Readline
@@ -508,7 +508,7 @@ common prefix of the set of possible completions using a different color.
The color definitions are taken from the value of the @env{LS_COLORS}
environment variable.
If there is a color definition in @env{LS_COLORS} for the custom suffix
@samp{readline-colored-completion-prefix}, Readline uses this color for
@samp{.readline-colored-completion-prefix}, Readline uses this color for
the common prefix instead of its default.
The default is @samp{off}.
@@ -553,7 +553,7 @@ The default value is @samp{off}.
The maximum
length in characters of the common prefix of a list of possible
completions that is displayed without modification.
When set to a value greater than zero, readline
When set to a value greater than zero, Readline
replaces common prefixes longer than this value
with an ellipsis when displaying possible completions.
@@ -674,7 +674,7 @@ sequences containing @kbd{\M-} or @code{Meta-}
(see @code{Key Bindings} in @ref{Readline Init File Syntax})
by converting a key sequence of the form
@kbd{\M-}@var{C} or @code{Meta-}@var{C} to the two-character sequence
@kbd{ESC}@var{C} (adding the meta prefix).
@kbd{ESC} @var{C} (adding the meta prefix).
If @code{force-meta-prefix} is set to @samp{off} (the default),
Readline uses the value of the @code{convert-meta} variable to determine
whether to perform this conversion:
@@ -876,7 +876,7 @@ The default value is @samp{off}.
If set to @samp{on}, this alters the default completion behavior when
inserting a single match into the line.
It's only active when performing completion in the middle of a word.
If enabled, readline does not insert characters from the completion
If enabled, Readline does not insert characters from the completion
that match characters after point in the word being completed,
so portions of the word following the cursor are not duplicated.
For instance, if this is enabled, attempting completion when the cursor
@@ -1312,9 +1312,10 @@ position, and @dfn{mark} refers to a cursor position saved by the
@code{set-mark} command.
The text between the point and mark is referred to as the @dfn{region}.
Readline has the concept of an @emph{active region}:
when the region is active, Readline redisplay uses the
value of the @code{active-region-start-color} variable
to denote the region.
when the region is active,
Readline redisplay highlights the region using the
value of the @code{active-region-start-color} variable.
The @code{enable-active-region} variable turns this on and off.
Several commands set the region to active; those are noted below.
@node Commands For Moving
@@ -1979,7 +1980,7 @@ of an @var{inputrc} file.
This command is unbound by default.
@item execute-named-command (M-x)
Read a bindable readline command name from the input and execute the
Read a bindable Readline command name from the input and execute the
function to which it's bound, as if the key sequence to which it was
bound appeared in the input.
If this function is supplied with a numeric argument, it passes that
@@ -2095,7 +2096,7 @@ so forth.
When the user attempts word completion for an argument to a command for
which a completion specification (a @dfn{compspec}) has been defined
using the @code{complete} builtin (@pxref{Programmable Completion Builtins}),
\fBreadline\fP invokes the programmable completion facilities.
Readline invokes the programmable completion facilities.
First, Bash identifies the command name.
If a compspec has been defined for that command, the
@@ -2563,7 +2564,7 @@ the @option{-E} option indicates that other supplied options should
apply to ``empty'' command completion; and
the @option{-I} option indicates that other supplied options should
apply to completion on the initial word on the line.
These are determined in the same way as the \fBcomplete\fP builtin.
These are determined in the same way as the @code{complete} builtin.
If multiple options are supplied, the @option{-D} option takes precedence
over @option{-E}, and both take precedence over @option{-I}
lib/readline/doc/rluserman.aux
+15 -15
View File
@@ -9,17 +9,17 @@
@xrdef{Command Line Editing-pg}{1}
@xrdef{Introduction and Notation-pg}{1}
@xrdef{Readline Interaction-pg}{1}
@xrdef{Readline Bare Essentials-pg}{1}
@xrdef{Readline Movement Commands-title}{Readline Movement Commands}
@xrdef{Readline Movement Commands-snt}{Section@tie 1.2.2}
@xrdef{Readline Killing Commands-title}{Readline Killing Commands}
@xrdef{Readline Killing Commands-snt}{Section@tie 1.2.3}
@xrdef{Readline Bare Essentials-pg}{2}
@xrdef{Readline Movement Commands-pg}{2}
@xrdef{Readline Killing Commands-pg}{2}
@xrdef{Readline Arguments-title}{Readline Arguments}
@xrdef{Readline Arguments-snt}{Section@tie 1.2.4}
@xrdef{Searching-title}{Searching for Commands in the History}
@xrdef{Searching-snt}{Section@tie 1.2.5}
@xrdef{Readline Killing Commands-pg}{3}
@xrdef{Readline Arguments-pg}{3}
@xrdef{Searching-pg}{3}
@xrdef{Readline Init File-title}{Readline Init File}
@@ -30,40 +30,40 @@
@xrdef{Readline Init File Syntax-pg}{4}
@xrdef{Conditional Init Constructs-title}{Conditional Init Constructs}
@xrdef{Conditional Init Constructs-snt}{Section@tie 1.3.2}
@xrdef{Conditional Init Constructs-pg}{12}
@xrdef{Conditional Init Constructs-pg}{14}
@xrdef{Sample Init File-title}{Sample Init File}
@xrdef{Sample Init File-snt}{Section@tie 1.3.3}
@xrdef{Sample Init File-pg}{13}
@xrdef{Sample Init File-pg}{15}
@xrdef{Bindable Readline Commands-title}{Bindable Readline Commands}
@xrdef{Bindable Readline Commands-snt}{Section@tie 1.4}
@xrdef{Commands For Moving-title}{Commands For Moving}
@xrdef{Commands For Moving-snt}{Section@tie 1.4.1}
@xrdef{Bindable Readline Commands-pg}{16}
@xrdef{Commands For Moving-pg}{16}
@xrdef{Bindable Readline Commands-pg}{18}
@xrdef{Commands For Moving-pg}{18}
@xrdef{Commands For History-title}{Commands For Manipulating The History}
@xrdef{Commands For History-snt}{Section@tie 1.4.2}
@xrdef{Commands For History-pg}{17}
@xrdef{Commands For History-pg}{19}
@xrdef{Commands For Text-title}{Commands For Changing Text}
@xrdef{Commands For Text-snt}{Section@tie 1.4.3}
@xrdef{Commands For Text-pg}{18}
@xrdef{Commands For Text-pg}{21}
@xrdef{Commands For Killing-title}{Killing And Yanking}
@xrdef{Commands For Killing-snt}{Section@tie 1.4.4}
@xrdef{Commands For Killing-pg}{19}
@xrdef{Commands For Killing-pg}{22}
@xrdef{Numeric Arguments-title}{Specifying Numeric Arguments}
@xrdef{Numeric Arguments-snt}{Section@tie 1.4.5}
@xrdef{Numeric Arguments-pg}{20}
@xrdef{Commands For Completion-title}{Letting Readline Type For You}
@xrdef{Commands For Completion-snt}{Section@tie 1.4.6}
@xrdef{Numeric Arguments-pg}{23}
@xrdef{Keyboard Macros-title}{Keyboard Macros}
@xrdef{Keyboard Macros-snt}{Section@tie 1.4.7}
@xrdef{Commands For Completion-pg}{21}
@xrdef{Keyboard Macros-pg}{21}
@xrdef{Miscellaneous Commands-title}{Some Miscellaneous Commands}
@xrdef{Miscellaneous Commands-snt}{Section@tie 1.4.8}
@xrdef{Miscellaneous Commands-pg}{22}
@xrdef{Commands For Completion-pg}{24}
@xrdef{Keyboard Macros-pg}{24}
@xrdef{Miscellaneous Commands-pg}{25}
@xrdef{Readline vi Mode-title}{Readline vi Mode}
@xrdef{Readline vi Mode-snt}{Section@tie 1.5}
@xrdef{Readline vi Mode-pg}{23}
@xrdef{Readline vi Mode-pg}{26}
@xrdef{GNU Free Documentation License-title}{GNU Free Documentation License}
@xrdef{GNU Free Documentation License-snt}{Appendix@tie @char65{}}
@xrdef{GNU Free Documentation License-pg}{24}
@xrdef{GNU Free Documentation License-pg}{27}
lib/readline/doc/rluserman.cp
+7 -7
View File
@@ -1,9 +1,9 @@
\entry{interaction, readline}{1}{interaction, readline}
\entry{notation, readline}{1}{notation, readline}
\entry{command editing}{1}{command editing}
\entry{editing command lines}{1}{editing command lines}
\entry{killing text}{2}{killing text}
\entry{yanking text}{2}{yanking text}
\entry{kill ring}{2}{kill ring}
\entry{notation, readline}{2}{notation, readline}
\entry{command editing}{2}{command editing}
\entry{editing command lines}{2}{editing command lines}
\entry{killing text}{3}{killing text}
\entry{yanking text}{3}{yanking text}
\entry{kill ring}{3}{kill ring}
\entry{initialization file, readline}{4}{initialization file, readline}
\entry{variables, readline}{4}{variables, readline}
\entry{variables, readline}{5}{variables, readline}
lib/readline/doc/rluserman.cps
+9 -9
View File
@@ -1,16 +1,16 @@
\initial {C}
\entry {command editing}{1}
\entry{command editing}{2}
\initial {E}
\entry {editing command lines}{1}
\entry{editing command lines}{2}
\initial {I}
\entry {initialization file, readline}{4}
\entry {interaction, readline}{1}
\entry{initialization file, readline}{4}
\entry{interaction, readline}{1}
\initial {K}
\entry {kill ring}{2}
\entry {killing text}{2}
\entry{kill ring}{3}
\entry{killing text}{3}
\initial {N}
\entry {notation, readline}{1}
\entry{notation, readline}{2}
\initial {V}
\entry {variables, readline}{4}
\entry{variables, readline}{5}
\initial {Y}
\entry {yanking text}{2}
\entry{yanking text}{3}
lib/readline/doc/rluserman.dvi
BIN
View File
Binary file not shown.
lib/readline/doc/rluserman.fn
+88 -84
View File
@@ -1,84 +1,88 @@
\entry{beginning-of-line (C-a)}{16}{\code {beginning-of-line (C-a)}}
\entry{end-of-line (C-e)}{16}{\code {end-of-line (C-e)}}
\entry{forward-char (C-f)}{16}{\code {forward-char (C-f)}}
\entry{backward-char (C-b)}{16}{\code {backward-char (C-b)}}
\entry{forward-word (M-f)}{16}{\code {forward-word (M-f)}}
\entry{backward-word (M-b)}{16}{\code {backward-word (M-b)}}
\entry{previous-screen-line ()}{16}{\code {previous-screen-line ()}}
\entry{next-screen-line ()}{16}{\code {next-screen-line ()}}
\entry{clear-screen (C-l)}{16}{\code {clear-screen (C-l)}}
\entry{redraw-current-line ()}{17}{\code {redraw-current-line ()}}
\entry{accept-line (Newline or Return)}{17}{\code {accept-line (Newline or Return)}}
\entry{previous-history (C-p)}{17}{\code {previous-history (C-p)}}
\entry{next-history (C-n)}{17}{\code {next-history (C-n)}}
\entry{beginning-of-history (M-<)}{17}{\code {beginning-of-history (M-<)}}
\entry{end-of-history (M->)}{17}{\code {end-of-history (M->)}}
\entry{reverse-search-history (C-r)}{17}{\code {reverse-search-history (C-r)}}
\entry{forward-search-history (C-s)}{17}{\code {forward-search-history (C-s)}}
\entry{non-incremental-reverse-search-history (M-p)}{17}{\code {non-incremental-reverse-search-history (M-p)}}
\entry{non-incremental-forward-search-history (M-n)}{17}{\code {non-incremental-forward-search-history (M-n)}}
\entry{history-search-forward ()}{17}{\code {history-search-forward ()}}
\entry{history-search-backward ()}{17}{\code {history-search-backward ()}}
\entry{history-substring-search-forward ()}{17}{\code {history-substring-search-forward ()}}
\entry{history-substring-search-backward ()}{18}{\code {history-substring-search-backward ()}}
\entry{yank-nth-arg (M-C-y)}{18}{\code {yank-nth-arg (M-C-y)}}
\entry{yank-last-arg (M-. or M-_)}{18}{\code {yank-last-arg (M-. or M-_)}}
\entry{end-of-file (usually C-d)}{18}{\code {\i {end-of-file} (usually C-d)}}
\entry{delete-char (C-d)}{18}{\code {delete-char (C-d)}}
\entry{backward-delete-char (Rubout)}{18}{\code {backward-delete-char (Rubout)}}
\entry{forward-backward-delete-char ()}{18}{\code {forward-backward-delete-char ()}}
\entry{quoted-insert (C-q or C-v)}{18}{\code {quoted-insert (C-q or C-v)}}
\entry{tab-insert (M-TAB)}{19}{\code {tab-insert (M-\key {TAB})}}
\entry{self-insert (a, b, A, 1, !, ...{})}{19}{\code {self-insert (a, b, A, 1, !, \dots {})}}
\entry{bracketed-paste-begin ()}{19}{\code {bracketed-paste-begin ()}}
\entry{transpose-chars (C-t)}{19}{\code {transpose-chars (C-t)}}
\entry{transpose-words (M-t)}{19}{\code {transpose-words (M-t)}}
\entry{upcase-word (M-u)}{19}{\code {upcase-word (M-u)}}
\entry{downcase-word (M-l)}{19}{\code {downcase-word (M-l)}}
\entry{capitalize-word (M-c)}{19}{\code {capitalize-word (M-c)}}
\entry{overwrite-mode ()}{19}{\code {overwrite-mode ()}}
\entry{kill-line (C-k)}{19}{\code {kill-line (C-k)}}
\entry{backward-kill-line (C-x Rubout)}{20}{\code {backward-kill-line (C-x Rubout)}}
\entry{unix-line-discard (C-u)}{20}{\code {unix-line-discard (C-u)}}
\entry{kill-whole-line ()}{20}{\code {kill-whole-line ()}}
\entry{kill-word (M-d)}{20}{\code {kill-word (M-d)}}
\entry{backward-kill-word (M-DEL)}{20}{\code {backward-kill-word (M-\key {DEL})}}
\entry{unix-word-rubout (C-w)}{20}{\code {unix-word-rubout (C-w)}}
\entry{unix-filename-rubout ()}{20}{\code {unix-filename-rubout ()}}
\entry{delete-horizontal-space ()}{20}{\code {delete-horizontal-space ()}}
\entry{kill-region ()}{20}{\code {kill-region ()}}
\entry{copy-region-as-kill ()}{20}{\code {copy-region-as-kill ()}}
\entry{copy-backward-word ()}{20}{\code {copy-backward-word ()}}
\entry{copy-forward-word ()}{20}{\code {copy-forward-word ()}}
\entry{yank (C-y)}{20}{\code {yank (C-y)}}
\entry{yank-pop (M-y)}{20}{\code {yank-pop (M-y)}}
\entry{digit-argument (M-0, M-1, ...{} M--)}{20}{\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}}
\entry{universal-argument ()}{21}{\code {universal-argument ()}}
\entry{complete (TAB)}{21}{\code {complete (\key {TAB})}}
\entry{possible-completions (M-?)}{21}{\code {possible-completions (M-?)}}
\entry{insert-completions (M-*)}{21}{\code {insert-completions (M-*)}}
\entry{menu-complete ()}{21}{\code {menu-complete ()}}
\entry{menu-complete-backward ()}{21}{\code {menu-complete-backward ()}}
\entry{delete-char-or-list ()}{21}{\code {delete-char-or-list ()}}
\entry{start-kbd-macro (C-x ()}{21}{\code {start-kbd-macro (C-x ()}}
\entry{end-kbd-macro (C-x ))}{22}{\code {end-kbd-macro (C-x ))}}
\entry{call-last-kbd-macro (C-x e)}{22}{\code {call-last-kbd-macro (C-x e)}}
\entry{print-last-kbd-macro ()}{22}{\code {print-last-kbd-macro ()}}
\entry{re-read-init-file (C-x C-r)}{22}{\code {re-read-init-file (C-x C-r)}}
\entry{abort (C-g)}{22}{\code {abort (C-g)}}
\entry{do-lowercase-version (M-A, M-B, M-x, ...{})}{22}{\code {do-lowercase-version (M-A, M-B, M-\var {x}, \dots {})}}
\entry{prefix-meta (ESC)}{22}{\code {prefix-meta (\key {ESC})}}
\entry{undo (C-_ or C-x C-u)}{22}{\code {undo (C-_ or C-x C-u)}}
\entry{revert-line (M-r)}{22}{\code {revert-line (M-r)}}
\entry{tilde-expand (M-~)}{22}{\code {tilde-expand (M-~)}}
\entry{set-mark (C-@)}{22}{\code {set-mark (C-@)}}
\entry{exchange-point-and-mark (C-x C-x)}{22}{\code {exchange-point-and-mark (C-x C-x)}}
\entry{character-search (C-])}{22}{\code {character-search (C-])}}
\entry{character-search-backward (M-C-])}{22}{\code {character-search-backward (M-C-])}}
\entry{skip-csi-sequence ()}{23}{\code {skip-csi-sequence ()}}
\entry{insert-comment (M-#)}{23}{\code {insert-comment (M-#)}}
\entry{dump-functions ()}{23}{\code {dump-functions ()}}
\entry{dump-variables ()}{23}{\code {dump-variables ()}}
\entry{dump-macros ()}{23}{\code {dump-macros ()}}
\entry{emacs-editing-mode (C-e)}{23}{\code {emacs-editing-mode (C-e)}}
\entry{vi-editing-mode (M-C-j)}{23}{\code {vi-editing-mode (M-C-j)}}
\entry{beginning-of-line (C-a)}{18}{\code {beginning-of-line (C-a)}}
\entry{end-of-line (C-e)}{18}{\code {end-of-line (C-e)}}
\entry{forward-char (C-f)}{18}{\code {forward-char (C-f)}}
\entry{backward-char (C-b)}{18}{\code {backward-char (C-b)}}
\entry{forward-word (M-f)}{18}{\code {forward-word (M-f)}}
\entry{backward-word (M-b)}{18}{\code {backward-word (M-b)}}
\entry{previous-screen-line ()}{18}{\code {previous-screen-line ()}}
\entry{next-screen-line ()}{18}{\code {next-screen-line ()}}
\entry{clear-display (M-C-l)}{19}{\code {clear-display (M-C-l)}}
\entry{clear-screen (C-l)}{19}{\code {clear-screen (C-l)}}
\entry{redraw-current-line ()}{19}{\code {redraw-current-line ()}}
\entry{accept-line (Newline or Return)}{19}{\code {accept-line (Newline or Return)}}
\entry{previous-history (C-p)}{19}{\code {previous-history (C-p)}}
\entry{next-history (C-n)}{19}{\code {next-history (C-n)}}
\entry{beginning-of-history (M-<)}{19}{\code {beginning-of-history (M-<)}}
\entry{end-of-history (M->)}{19}{\code {end-of-history (M->)}}
\entry{reverse-search-history (C-r)}{19}{\code {reverse-search-history (C-r)}}
\entry{forward-search-history (C-s)}{19}{\code {forward-search-history (C-s)}}
\entry{non-incremental-reverse-search-history (M-p)}{19}{\code {non-incremental-reverse-search-history (M-p)}}
\entry{non-incremental-forward-search-history (M-n)}{19}{\code {non-incremental-forward-search-history (M-n)}}
\entry{history-search-backward ()}{20}{\code {history-search-backward ()}}
\entry{history-search-forward ()}{20}{\code {history-search-forward ()}}
\entry{history-substring-search-backward ()}{20}{\code {history-substring-search-backward ()}}
\entry{history-substring-search-forward ()}{20}{\code {history-substring-search-forward ()}}
\entry{yank-nth-arg (M-C-y)}{20}{\code {yank-nth-arg (M-C-y)}}
\entry{yank-last-arg (M-. or M-_)}{20}{\code {yank-last-arg (M-. or M-_)}}
\entry{operate-and-get-next (C-o)}{20}{\code {operate-and-get-next (C-o)}}
\entry{fetch-history ()}{21}{\code {fetch-history ()}}
\entry{end-of-file (usually C-d)}{21}{\code {\i {end-of-file} (usually C-d)}}
\entry{delete-char (C-d)}{21}{\code {delete-char (C-d)}}
\entry{backward-delete-char (Rubout)}{21}{\code {backward-delete-char (Rubout)}}
\entry{forward-backward-delete-char ()}{21}{\code {forward-backward-delete-char ()}}
\entry{quoted-insert (C-q or C-v)}{21}{\code {quoted-insert (C-q or C-v)}}
\entry{tab-insert (M-TAB)}{21}{\code {tab-insert (M-\key {TAB})}}
\entry{self-insert (a, b, A, 1, !, ...{})}{21}{\code {self-insert (a, b, A, 1, !, \dots {})}}
\entry{bracketed-paste-begin ()}{21}{\code {bracketed-paste-begin ()}}
\entry{transpose-chars (C-t)}{21}{\code {transpose-chars (C-t)}}
\entry{transpose-words (M-t)}{22}{\code {transpose-words (M-t)}}
\entry{upcase-word (M-u)}{22}{\code {upcase-word (M-u)}}
\entry{downcase-word (M-l)}{22}{\code {downcase-word (M-l)}}
\entry{capitalize-word (M-c)}{22}{\code {capitalize-word (M-c)}}
\entry{overwrite-mode ()}{22}{\code {overwrite-mode ()}}
\entry{kill-line (C-k)}{22}{\code {kill-line (C-k)}}
\entry{backward-kill-line (C-x Rubout)}{22}{\code {backward-kill-line (C-x Rubout)}}
\entry{unix-line-discard (C-u)}{22}{\code {unix-line-discard (C-u)}}
\entry{kill-whole-line ()}{22}{\code {kill-whole-line ()}}
\entry{kill-word (M-d)}{22}{\code {kill-word (M-d)}}
\entry{backward-kill-word (M-DEL)}{22}{\code {backward-kill-word (M-\key {DEL})}}
\entry{unix-word-rubout (C-w)}{23}{\code {unix-word-rubout (C-w)}}
\entry{unix-filename-rubout ()}{23}{\code {unix-filename-rubout ()}}
\entry{delete-horizontal-space ()}{23}{\code {delete-horizontal-space ()}}
\entry{kill-region ()}{23}{\code {kill-region ()}}
\entry{copy-region-as-kill ()}{23}{\code {copy-region-as-kill ()}}
\entry{copy-backward-word ()}{23}{\code {copy-backward-word ()}}
\entry{copy-forward-word ()}{23}{\code {copy-forward-word ()}}
\entry{yank (C-y)}{23}{\code {yank (C-y)}}
\entry{yank-pop (M-y)}{23}{\code {yank-pop (M-y)}}
\entry{digit-argument (M-0, M-1, ...{} M--)}{23}{\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}}
\entry{universal-argument ()}{23}{\code {universal-argument ()}}
\entry{complete (TAB)}{24}{\code {complete (\key {TAB})}}
\entry{possible-completions (M-?)}{24}{\code {possible-completions (M-?)}}
\entry{insert-completions (M-*)}{24}{\code {insert-completions (M-*)}}
\entry{menu-complete ()}{24}{\code {menu-complete ()}}
\entry{menu-complete-backward ()}{24}{\code {menu-complete-backward ()}}
\entry{delete-char-or-list ()}{24}{\code {delete-char-or-list ()}}
\entry{start-kbd-macro (C-x ()}{24}{\code {start-kbd-macro (C-x ()}}
\entry{end-kbd-macro (C-x ))}{24}{\code {end-kbd-macro (C-x ))}}
\entry{call-last-kbd-macro (C-x e)}{24}{\code {call-last-kbd-macro (C-x e)}}
\entry{print-last-kbd-macro ()}{24}{\code {print-last-kbd-macro ()}}
\entry{re-read-init-file (C-x C-r)}{25}{\code {re-read-init-file (C-x C-r)}}
\entry{abort (C-g)}{25}{\code {abort (C-g)}}
\entry{do-lowercase-version (M-A, M-B, M-x, ...{})}{25}{\code {do-lowercase-version (M-A, M-B, M-\var {x}, \dots {})}}
\entry{prefix-meta (ESC)}{25}{\code {prefix-meta (\key {ESC})}}
\entry{undo (C-_ or C-x C-u)}{25}{\code {undo (C-_ or C-x C-u)}}
\entry{revert-line (M-r)}{25}{\code {revert-line (M-r)}}
\entry{tilde-expand (M-~)}{25}{\code {tilde-expand (M-~)}}
\entry{set-mark (C-@)}{25}{\code {set-mark (C-@)}}
\entry{exchange-point-and-mark (C-x C-x)}{25}{\code {exchange-point-and-mark (C-x C-x)}}
\entry{character-search (C-])}{25}{\code {character-search (C-])}}
\entry{character-search-backward (M-C-])}{25}{\code {character-search-backward (M-C-])}}
\entry{skip-csi-sequence ()}{25}{\code {skip-csi-sequence ()}}
\entry{insert-comment (M-#)}{25}{\code {insert-comment (M-#)}}
\entry{dump-functions ()}{26}{\code {dump-functions ()}}
\entry{dump-variables ()}{26}{\code {dump-variables ()}}
\entry{dump-macros ()}{26}{\code {dump-macros ()}}
\entry{execute-named-command (M-x)}{26}{\code {execute-named-command (M-x)}}
\entry{emacs-editing-mode (C-e)}{26}{\code {emacs-editing-mode (C-e)}}
\entry{vi-editing-mode (M-C-j)}{26}{\code {vi-editing-mode (M-C-j)}}
lib/readline/doc/rluserman.fns
+88 -84
View File
@@ -1,104 +1,108 @@
\initial {A}
\entry {\code {abort (C-g)}}{22}
\entry {\code {accept-line (Newline or Return)}}{17}
\entry{\code {abort (C-g)}}{25}
\entry{\code {accept-line (Newline or Return)}}{19}
\initial {B}
\entry {\code {backward-char (C-b)}}{16}
\entry {\code {backward-delete-char (Rubout)}}{18}
\entry {\code {backward-kill-line (C-x Rubout)}}{20}
\entry {\code {backward-kill-word (M-\key {DEL})}}{20}
\entry {\code {backward-word (M-b)}}{16}
\entry {\code {beginning-of-history (M-<)}}{17}
\entry {\code {beginning-of-line (C-a)}}{16}
\entry {\code {bracketed-paste-begin ()}}{19}
\entry{\code {backward-char (C-b)}}{18}
\entry{\code {backward-delete-char (Rubout)}}{21}
\entry{\code {backward-kill-line (C-x Rubout)}}{22}
\entry{\code {backward-kill-word (M-\key {DEL})}}{22}
\entry{\code {backward-word (M-b)}}{18}
\entry{\code {beginning-of-history (M-<)}}{19}
\entry{\code {beginning-of-line (C-a)}}{18}
\entry{\code {bracketed-paste-begin ()}}{21}
\initial {C}
\entry {\code {call-last-kbd-macro (C-x e)}}{22}
\entry {\code {capitalize-word (M-c)}}{19}
\entry {\code {character-search (C-])}}{22}
\entry {\code {character-search-backward (M-C-])}}{22}
\entry {\code {clear-screen (C-l)}}{16}
\entry {\code {complete (\key {TAB})}}{21}
\entry {\code {copy-backward-word ()}}{20}
\entry {\code {copy-forward-word ()}}{20}
\entry {\code {copy-region-as-kill ()}}{20}
\entry{\code {call-last-kbd-macro (C-x e)}}{24}
\entry{\code {capitalize-word (M-c)}}{22}
\entry{\code {character-search (C-])}}{25}
\entry{\code {character-search-backward (M-C-])}}{25}
\entry{\code {clear-display (M-C-l)}}{19}
\entry{\code {clear-screen (C-l)}}{19}
\entry{\code {complete (\key {TAB})}}{24}
\entry{\code {copy-backward-word ()}}{23}
\entry{\code {copy-forward-word ()}}{23}
\entry{\code {copy-region-as-kill ()}}{23}
\initial {D}
\entry {\code {delete-char (C-d)}}{18}
\entry {\code {delete-char-or-list ()}}{21}
\entry {\code {delete-horizontal-space ()}}{20}
\entry {\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}}{20}
\entry {\code {do-lowercase-version (M-A, M-B, M-\var {x}, \dots {})}}{22}
\entry {\code {downcase-word (M-l)}}{19}
\entry {\code {dump-functions ()}}{23}
\entry {\code {dump-macros ()}}{23}
\entry {\code {dump-variables ()}}{23}
\entry{\code {delete-char (C-d)}}{21}
\entry{\code {delete-char-or-list ()}}{24}
\entry{\code {delete-horizontal-space ()}}{23}
\entry{\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}}{23}
\entry{\code {do-lowercase-version (M-A, M-B, M-\var {x}, \dots {})}}{25}
\entry{\code {downcase-word (M-l)}}{22}
\entry{\code {dump-functions ()}}{26}
\entry{\code {dump-macros ()}}{26}
\entry{\code {dump-variables ()}}{26}
\initial {E}
\entry {\code {emacs-editing-mode (C-e)}}{23}
\entry {\code {end-kbd-macro (C-x ))}}{22}
\entry {\code {\i {end-of-file} (usually C-d)}}{18}
\entry {\code {end-of-history (M->)}}{17}
\entry {\code {end-of-line (C-e)}}{16}
\entry {\code {exchange-point-and-mark (C-x C-x)}}{22}
\entry{\code {emacs-editing-mode (C-e)}}{26}
\entry{\code {end-kbd-macro (C-x ))}}{24}
\entry{\code {\i {end-of-file} (usually C-d)}}{21}
\entry{\code {end-of-history (M->)}}{19}
\entry{\code {end-of-line (C-e)}}{18}
\entry{\code {exchange-point-and-mark (C-x C-x)}}{25}
\entry{\code {execute-named-command (M-x)}}{26}
\initial {F}
\entry {\code {forward-backward-delete-char ()}}{18}
\entry {\code {forward-char (C-f)}}{16}
\entry {\code {forward-search-history (C-s)}}{17}
\entry {\code {forward-word (M-f)}}{16}
\entry{\code {fetch-history ()}}{21}
\entry{\code {forward-backward-delete-char ()}}{21}
\entry{\code {forward-char (C-f)}}{18}
\entry{\code {forward-search-history (C-s)}}{19}
\entry{\code {forward-word (M-f)}}{18}
\initial {H}
\entry {\code {history-search-backward ()}}{17}
\entry {\code {history-search-forward ()}}{17}
\entry {\code {history-substring-search-backward ()}}{18}
\entry {\code {history-substring-search-forward ()}}{17}
\entry{\code {history-search-backward ()}}{20}
\entry{\code {history-search-forward ()}}{20}
\entry{\code {history-substring-search-backward ()}}{20}
\entry{\code {history-substring-search-forward ()}}{20}
\initial {I}
\entry {\code {insert-comment (M-#)}}{23}
\entry {\code {insert-completions (M-*)}}{21}
\entry{\code {insert-comment (M-#)}}{25}
\entry{\code {insert-completions (M-*)}}{24}
\initial {K}
\entry {\code {kill-line (C-k)}}{19}
\entry {\code {kill-region ()}}{20}
\entry {\code {kill-whole-line ()}}{20}
\entry {\code {kill-word (M-d)}}{20}
\entry{\code {kill-line (C-k)}}{22}
\entry{\code {kill-region ()}}{23}
\entry{\code {kill-whole-line ()}}{22}
\entry{\code {kill-word (M-d)}}{22}
\initial {M}
\entry {\code {menu-complete ()}}{21}
\entry {\code {menu-complete-backward ()}}{21}
\entry{\code {menu-complete ()}}{24}
\entry{\code {menu-complete-backward ()}}{24}
\initial {N}
\entry {\code {next-history (C-n)}}{17}
\entry {\code {next-screen-line ()}}{16}
\entry {\code {non-incremental-forward-search-history (M-n)}}{17}
\entry {\code {non-incremental-reverse-search-history (M-p)}}{17}
\entry{\code {next-history (C-n)}}{19}
\entry{\code {next-screen-line ()}}{18}
\entry{\code {non-incremental-forward-search-history (M-n)}}{19}
\entry{\code {non-incremental-reverse-search-history (M-p)}}{19}
\initial {O}
\entry {\code {overwrite-mode ()}}{19}
\entry{\code {operate-and-get-next (C-o)}}{20}
\entry{\code {overwrite-mode ()}}{22}
\initial {P}
\entry {\code {possible-completions (M-?)}}{21}
\entry {\code {prefix-meta (\key {ESC})}}{22}
\entry {\code {previous-history (C-p)}}{17}
\entry {\code {previous-screen-line ()}}{16}
\entry {\code {print-last-kbd-macro ()}}{22}
\entry{\code {possible-completions (M-?)}}{24}
\entry{\code {prefix-meta (\key {ESC})}}{25}
\entry{\code {previous-history (C-p)}}{19}
\entry{\code {previous-screen-line ()}}{18}
\entry{\code {print-last-kbd-macro ()}}{24}
\initial {Q}
\entry {\code {quoted-insert (C-q or C-v)}}{18}
\entry{\code {quoted-insert (C-q or C-v)}}{21}
\initial {R}
\entry {\code {re-read-init-file (C-x C-r)}}{22}
\entry {\code {redraw-current-line ()}}{17}
\entry {\code {reverse-search-history (C-r)}}{17}
\entry {\code {revert-line (M-r)}}{22}
\entry{\code {re-read-init-file (C-x C-r)}}{25}
\entry{\code {redraw-current-line ()}}{19}
\entry{\code {reverse-search-history (C-r)}}{19}
\entry{\code {revert-line (M-r)}}{25}
\initial {S}
\entry {\code {self-insert (a, b, A, 1, !, \dots {})}}{19}
\entry {\code {set-mark (C-@)}}{22}
\entry {\code {skip-csi-sequence ()}}{23}
\entry {\code {start-kbd-macro (C-x ()}}{21}
\entry{\code {self-insert (a, b, A, 1, !, \dots {})}}{21}
\entry{\code {set-mark (C-@)}}{25}
\entry{\code {skip-csi-sequence ()}}{25}
\entry{\code {start-kbd-macro (C-x ()}}{24}
\initial {T}
\entry {\code {tab-insert (M-\key {TAB})}}{19}
\entry {\code {tilde-expand (M-~)}}{22}
\entry {\code {transpose-chars (C-t)}}{19}
\entry {\code {transpose-words (M-t)}}{19}
\entry{\code {tab-insert (M-\key {TAB})}}{21}
\entry{\code {tilde-expand (M-~)}}{25}
\entry{\code {transpose-chars (C-t)}}{21}
\entry{\code {transpose-words (M-t)}}{22}
\initial {U}
\entry {\code {undo (C-_ or C-x C-u)}}{22}
\entry {\code {universal-argument ()}}{21}
\entry {\code {unix-filename-rubout ()}}{20}
\entry {\code {unix-line-discard (C-u)}}{20}
\entry {\code {unix-word-rubout (C-w)}}{20}
\entry {\code {upcase-word (M-u)}}{19}
\entry{\code {undo (C-_ or C-x C-u)}}{25}
\entry{\code {universal-argument ()}}{23}
\entry{\code {unix-filename-rubout ()}}{23}
\entry{\code {unix-line-discard (C-u)}}{22}
\entry{\code {unix-word-rubout (C-w)}}{23}
\entry{\code {upcase-word (M-u)}}{22}
\initial {V}
\entry {\code {vi-editing-mode (M-C-j)}}{23}
\entry{\code {vi-editing-mode (M-C-j)}}{26}
\initial {Y}
\entry {\code {yank (C-y)}}{20}
\entry {\code {yank-last-arg (M-. or M-_)}}{18}
\entry {\code {yank-nth-arg (M-C-y)}}{18}
\entry {\code {yank-pop (M-y)}}{20}
\entry{\code {yank (C-y)}}{23}
\entry{\code {yank-last-arg (M-. or M-_)}}{20}
\entry{\code {yank-nth-arg (M-C-y)}}{20}
\entry{\code {yank-pop (M-y)}}{23}
lib/readline/doc/rluserman.html
+22 -20
View File
@@ -1,6 +1,6 @@
<HTML>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- Created on October, 11 2024 by texi2html 1.64 -->
<!-- Created on October, 18 2024 by texi2html 1.64 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -95,8 +95,8 @@ command line editing interface.
<!--docid::SEC2::-->
<P>
The following paragraphs describe the notation used to represent
keystrokes.
The following paragraphs use Emacs style to
describe the notation used to represent keystrokes.
</P><P>
The text <KBD>C-k</KBD> is read as `Control-K' and describes the character
@@ -106,17 +106,17 @@ is depressed.
The text <KBD>M-k</KBD> is read as `Meta-K' and describes the character
produced when the Meta key (if you have one) is depressed, and the <KBD>k</KBD>
key is pressed (a <EM>meta character</EM>).
The Meta key is labeled <KBD>ALT</KBD> on many keyboards.
key is pressed (a <EM>meta character</EM>), then both are released.
The Meta key is labeled <KBD>ALT</KBD> or <KBD>Option</KBD> on many keyboards.
On keyboards with two keys labeled <KBD>ALT</KBD> (usually to either side of
the space bar), the <KBD>ALT</KBD> on the left side is generally set to
work as a Meta key.
The <KBD>ALT</KBD> key on the right may also be configured to work as a
Meta key or may be configured as some other modifier, such as a
One of the <KBD>ALT</KBD> keys may also be configured
as some other modifier, such as a
Compose key for typing accented characters.
</P><P>
On some keyboards, the Meta key modifier produces meta characters with
On some keyboards, the Meta key modifier produces characters with
the eighth bit (0200) set.
You can use the <CODE>enable-meta-key</CODE> variable
to control whether or not it does this, if the keyboard allows it.
@@ -524,7 +524,7 @@ commands in an <EM>inputrc</EM> file, conventionally in their home directory.
The name of this file is taken from the value of the
environment variable <CODE>INPUTRC</CODE>.
If that variable is unset, the default is <TT>`~/.inputrc'</TT>.
If that file does not exist or cannot be read, readline looks for
If that file does not exist or cannot be read, Readline looks for
<TT>`/etc/inputrc'</TT>.
</P><P>
@@ -668,7 +668,7 @@ common prefix of the set of possible completions using a different color.
The color definitions are taken from the value of the <CODE>LS_COLORS</CODE>
environment variable.
If there is a color definition in <CODE>LS_COLORS</CODE> for the custom suffix
<SAMP>`readline-colored-completion-prefix'</SAMP>, Readline uses this color for
<SAMP>`.readline-colored-completion-prefix'</SAMP>, Readline uses this color for
the common prefix instead of its default.
The default is <SAMP>`off'</SAMP>.
<P>
@@ -719,7 +719,7 @@ The default value is <SAMP>`off'</SAMP>.
The maximum
length in characters of the common prefix of a list of possible
completions that is displayed without modification.
When set to a value greater than zero, readline
When set to a value greater than zero, Readline
replaces common prefixes longer than this value
with an ellipsis when displaying possible completions.
<P>
@@ -852,7 +852,7 @@ sequences containing <KBD>\M-</KBD> or <CODE>Meta-</CODE>
(see <CODE>Key Bindings</CODE> in <A HREF="rluserman.html#SEC10">1.3.1 Readline Init File Syntax</A>)
by converting a key sequence of the form
<KBD>\M-</KBD><VAR>C</VAR> or <CODE>Meta-</CODE><VAR>C</VAR> to the two-character sequence
<KBD>ESC</KBD><VAR>C</VAR> (adding the meta prefix).
<KBD>ESC</KBD> <VAR>C</VAR> (adding the meta prefix).
If <CODE>force-meta-prefix</CODE> is set to <SAMP>`off'</SAMP> (the default),
Readline uses the value of the <CODE>convert-meta</CODE> variable to determine
whether to perform this conversion:
@@ -1070,7 +1070,7 @@ The default value is <SAMP>`off'</SAMP>.
If set to <SAMP>`on'</SAMP>, this alters the default completion behavior when
inserting a single match into the line.
It's only active when performing completion in the middle of a word.
If enabled, readline does not insert characters from the completion
If enabled, Readline does not insert characters from the completion
that match characters after point in the word being completed,
so portions of the word following the cursor are not duplicated.
For instance, if this is enabled, attempting completion when the cursor
@@ -1167,7 +1167,7 @@ This key binding syntax recognizes a number of symbolic character names:
<VAR>NEWLINE</VAR>,
<VAR>RET</VAR>,
<VAR>RETURN</VAR>,
<VAR>RUBOUT</VAR>,
<VAR>RUBOUT</VAR> (a destructive backspace),
<VAR>SPACE</VAR>,
<VAR>SPC</VAR>,
and
@@ -1558,9 +1558,10 @@ position, and <EM>mark</EM> refers to a cursor position saved by the
<CODE>set-mark</CODE> command.
The text between the point and mark is referred to as the <EM>region</EM>.
Readline has the concept of an <EM>active region</EM>:
when the region is active, Readline redisplay uses the
value of the <CODE>active-region-start-color</CODE> variable
to denote the region.
when the region is active,
Readline redisplay highlights the region using the
value of the <CODE>active-region-start-color</CODE> variable.
The <CODE>enable-active-region</CODE> variable turns this on and off.
Several commands set the region to active; those are noted below.
</P><P>
@@ -1892,6 +1893,7 @@ Delete the character at point.
If this function is bound to the
same character as the tty EOF character, as <KBD>C-d</KBD>
commonly is, see above for the effects.
This may also be bound to the Delete key on some keyboards.
<P>
<A NAME="IDX111"></A>
@@ -2482,7 +2484,7 @@ This command is unbound by default.
<A NAME="IDX221"></A>
<DT><CODE>execute-named-command (M-x)</CODE>
<DD><A NAME="IDX222"></A>
Read a bindable readline command name from the input and execute the
Read a bindable Readline command name from the input and execute the
function to which it's bound, as if the key sequence to which it was
bound appeared in the input.
If this function is supplied with a numeric argument, it passes that
@@ -3226,7 +3228,7 @@ to permit their use in free software.
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="rluserman.html#SEC_About"> ? </A>]</TD>
</TR></TABLE>
<H1>About this document</H1>
This document was generated by <I>Chet Ramey</I> on <I>October, 11 2024</I>
This document was generated by <I>Chet Ramey</I> on <I>October, 18 2024</I>
using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
"><I>texi2html</I></A>
<P></P>
@@ -3388,7 +3390,7 @@ the following structure:
<BR>
<FONT SIZE="-1">
This document was generated
by <I>Chet Ramey</I> on <I>October, 11 2024</I>
by <I>Chet Ramey</I> on <I>October, 18 2024</I>
using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
"><I>texi2html</I></A>
lib/readline/doc/rluserman.info
+50 -49
View File
@@ -2,7 +2,7 @@ This is rluserman.info, produced by makeinfo version 7.1 from
rluserman.texi.
This manual describes the end user interface of the GNU Readline Library
(version 8.3, 10 October 2024), a library which aids in the consistency
(version 8.3, 15 October 2024), a library which aids in the consistency
of user interface across discrete programs which provide a command line
interface.
@@ -61,27 +61,26 @@ File: rluserman.info, Node: Introduction and Notation, Next: Readline Interact
1.1 Introduction to Line Editing
================================
The following paragraphs describe the notation used to represent
keystrokes.
The following paragraphs use Emacs style to describe the notation used
to represent keystrokes.
The text ‘C-k’ is read as 'Control-K' and describes the character
produced when the <k> key is pressed while the Control key is depressed.
The text ‘M-k’ is read as 'Meta-K' and describes the character
produced when the Meta key (if you have one) is depressed, and the <k>
key is pressed (a “meta character”). The Meta key is labeled <ALT> on
many keyboards. On keyboards with two keys labeled <ALT> (usually to
either side of the space bar), the <ALT> on the left side is generally
set to work as a Meta key. The <ALT> key on the right may also be
configured to work as a Meta key or may be configured as some other
modifier, such as a Compose key for typing accented characters.
key is pressed (a “meta character”), then both are released. The Meta
key is labeled <ALT> or <Option> on many keyboards. On keyboards with
two keys labeled <ALT> (usually to either side of the space bar), the
<ALT> on the left side is generally set to work as a Meta key. One of
the <ALT> keys may also be configured as some other modifier, such as a
Compose key for typing accented characters.
On some keyboards, the Meta key modifier produces meta characters
with the eighth bit (0200) set. You can use the ‘enable-meta-key’
variable to control whether or not it does this, if the keyboard allows
it. On many others, the terminal or terminal emulator converts the
metafied key to a key sequence beginning with <ESC> as described in the
next paragraph.
On some keyboards, the Meta key modifier produces characters with the
eighth bit (0200) set. You can use the ‘enable-meta-key’ variable to
control whether or not it does this, if the keyboard allows it. On many
others, the terminal or terminal emulator converts the metafied key to a
key sequence beginning with <ESC> as described in the next paragraph.
If you do not have a Meta or <ALT> key, or another key working as a
Meta key, you can generally achieve the latter effect by typing <ESC>
@@ -326,7 +325,7 @@ putting commands in an “inputrc” file, conventionally in their home
directory. The name of this file is taken from the value of the
environment variable ‘INPUTRC’. If that variable is unset, the default
is ‘~/.inputrc’. If that file does not exist or cannot be read,
readline looks for ‘/etc/inputrc’.
Readline looks for ‘/etc/inputrc’.
When a program which uses the Readline library starts up, Readline
reads the init file and sets any variables and key bindings it contains.
@@ -426,9 +425,9 @@ Variable Settings
different color. The color definitions are taken from the
value of the ‘LS_COLORS’ environment variable. If there is a
color definition in ‘LS_COLORS’ for the custom suffix
‘readline-colored-completion-prefix’, Readline uses this color
for the common prefix instead of its default. The default is
‘off’.
‘.readline-colored-completion-prefix’, Readline uses this
color for the common prefix instead of its default. The
default is ‘off’.
‘colored-stats’
If set to ‘on’, Readline displays possible completions using
@@ -461,7 +460,7 @@ Variable Settings
‘completion-prefix-display-length’
The maximum length in characters of the common prefix of a
list of possible completions that is displayed without
modification. When set to a value greater than zero, readline
modification. When set to a value greater than zero, Readline
replaces common prefixes longer than this value with an
ellipsis when displaying possible completions.
@@ -560,7 +559,7 @@ Variable Settings
key sequences containing ‘\M-’ or ‘Meta-’ (see ‘Key Bindings’
in *note Readline Init File Syntax::) by converting a key
sequence of the form ‘\M-’C or ‘Meta-’C to the two-character
sequence ‘ESC’C (adding the meta prefix). If
sequence ‘ESC’ C (adding the meta prefix). If
‘force-meta-prefix’ is set to ‘off’ (the default), Readline
uses the value of the ‘convert-meta’ variable to determine
whether to perform this conversion: if ‘convert-meta’ is ‘on’,
@@ -720,7 +719,7 @@ Variable Settings
If set to ‘on’, this alters the default completion behavior
when inserting a single match into the line. It's only active
when performing completion in the middle of a word. If
enabled, readline does not insert characters from the
enabled, Readline does not insert characters from the
completion that match characters after point in the word being
completed, so portions of the word following the cursor are
not duplicated. For instance, if this is enabled, attempting
@@ -790,7 +789,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
@@ -1088,9 +1087,10 @@ unbound by default.
position, and “mark” refers to a cursor position saved by the ‘set-mark’
command. The text between the point and mark is referred to as the
“region”. Readline has the concept of an _active region_: when the
region is active, Readline redisplay uses the value of the
‘active-region-start-color’ variable to denote the region. Several
commands set the region to active; those are noted below.
region is active, Readline redisplay highlights the region using the
value of the ‘active-region-start-color’ variable. The
‘enable-active-region’ variable turns this on and off. Several commands
set the region to active; those are noted below.

File: rluserman.info, Node: Commands For Moving, Next: Commands For History, Up: Bindable Readline Commands
@@ -1271,7 +1271,8 @@ File: rluserman.info, Node: Commands For Text, Next: Commands For Killing, Pr
‘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
@@ -1589,7 +1590,7 @@ File: rluserman.info, Node: Miscellaneous Commands, Prev: Keyboard Macros, Up
default.
‘execute-named-command (M-x)’
Read a bindable readline command name from the input and execute
Read a bindable Readline command name from the input and execute
the function to which it's bound, as if the key sequence to which
it was bound appeared in the input. If this function is supplied
with a numeric argument, it passes that argument to the function it
@@ -2113,27 +2114,27 @@ Tag Table:
Node: Top906
Node: Command Line Editing1428
Node: Introduction and Notation2082
Node: Readline Interaction4437
Node: Readline Bare Essentials5630
Node: Readline Movement Commands7443
Node: Readline Killing Commands8444
Node: Readline Arguments10472
Node: Searching11534
Node: Readline Init File13766
Node: Readline Init File Syntax14965
Node: Conditional Init Constructs41331
Node: Sample Init File45721
Node: Bindable Readline Commands48847
Node: Commands For Moving50166
Node: Commands For History52097
Node: Commands For Text57303
Node: Commands For Killing61083
Node: Numeric Arguments63540
Node: Commands For Completion64697
Node: Keyboard Macros66785
Node: Miscellaneous Commands67491
Node: Readline vi Mode71816
Node: GNU Free Documentation License72810
Node: Readline Interaction4439
Node: Readline Bare Essentials5632
Node: Readline Movement Commands7445
Node: Readline Killing Commands8446
Node: Readline Arguments10474
Node: Searching11536
Node: Readline Init File13768
Node: Readline Init File Syntax14967
Node: Conditional Init Constructs41361
Node: Sample Init File45751
Node: Bindable Readline Commands48877
Node: Commands For Moving50262
Node: Commands For History52193
Node: Commands For Text57399
Node: Commands For Killing61245
Node: Numeric Arguments63702
Node: Commands For Completion64859
Node: Keyboard Macros66947
Node: Miscellaneous Commands67653
Node: Readline vi Mode71978
Node: GNU Free Documentation License72972

End Tag Table
lib/readline/doc/rluserman.log
+38 -33
View File
@@ -1,11 +1,12 @@
This is pdfTeX, Version 3.14159265-2.6-1.40.18 (TeX Live 2017/MacPorts 2017_2) (preloaded format=etex 2017.7.5) 2 JAN 2018 10:55
This is pdfTeX, Version 3.141592653-2.6-1.40.26 (TeX Live 2024/MacPorts 2024.70613_0) (preloaded format=etex 2024.4.9) 18 OCT 2024 11:25
entering extended mode
restricted \write18 enabled.
file:line:error style messages enabled.
%&-line parsing enabled.
**\catcode126=12 \def\normaltilde{~}\catcode126=13 \let~\normaltilde \input ./
./rluserman.texi
(././rluserman.texi (./texinfo.tex Loading texinfo [version 2015-11-22.14]:
**\nonstopmode \input ././rluserman.texi
(././rluserman.texi
(/usr/local/src/bash/bash-20241015/lib/readline/doc/texinfo.tex
Loading texinfo [version 2015-11-22.14]:
\outerhsize=\dimen16
\outervsize=\dimen17
\cornerlong=\dimen18
@@ -25,8 +26,7 @@ entering extended mode
\exdentamount=\skip18
\inmarginspacing=\skip19
\centerpenalty=\count27
pdf,
pdf,
\tempnum=\count28
\lnkcount=\count29
\filename=\toks15
@@ -47,7 +47,8 @@ pdf,
\fontdepth=\count33
glyphs,
\errorbox=\box21
page headings,
page headings,
\titlepagetopglue=\skip20
\titlepagebottomglue=\skip21
\evenheadline=\toks21
@@ -81,8 +82,7 @@ pdf,
\doublecolumntopgap=\dimen34
\savedtopmark=\toks26
\savedfirstmark=\toks27
sectioning,
sectioning,
\unnumberedno=\count38
\chapno=\count39
\secno=\count40
@@ -114,7 +114,8 @@ sectioning,
\nonfillparindent=\dimen39
\tabw=\dimen40
\verbbox=\box25
defuns,
defuns,
\defbodyindent=\skip39
\defargsindent=\skip40
\deflastargmargin=\skip41
@@ -160,26 +161,29 @@ This is `epsf.tex' v2.7.4 <14 February 2011>
texinfo.tex: doing @include of version.texi
(./version.texi) [1] [2] (./rluserman.toc) [-1]
(/usr/local/src/bash/bash-20241015/lib/readline/doc/version.texi) [1] [2]
(/usr/local/src/bash/bash-20241015/lib/readline/doc/rluserman.toc) [-1]
texinfo.tex: doing @include of rluser.texi
(./rluser.texi Chapter 1
(/usr/local/src/bash/bash-20241015/lib/readline/doc/rluser.texi Chapter 1
\openout0 = `rluserman.toc'.
(./rluserman.aux)
(/usr/local/src/bash/bash-20241015/lib/readline/doc/rluserman.aux)
\openout1 = `rluserman.aux'.
@cpindfile=@write2
\openout2 = `rluserman.cp'.
[1] [2] [3]
[1] [2]
[3] [4]
@vrindfile=@write3
\openout3 = `rluserman.vr'.
[4] [5] [6] [7] [8] [9]
Underfull \hbox (badness 7540) in paragraph at lines 805--811
[]@textrm In the above ex-am-ple, @textttsl C-u[] @textrm is bound to the func
[5] [6] [7] [8] [9] [10] [11]
Underfull \hbox (badness 7540) in paragraph at lines 959--965
[]@textrm In the ex-am-ple above, @textttsl C-u[] @textrm is bound to the func
-tion
@hbox(7.60416+2.12917)x433.62, glue set 4.22592
@@ -191,7 +195,7 @@ Underfull \hbox (badness 7540) in paragraph at lines 805--811
.etc.
Underfull \hbox (badness 10000) in paragraph at lines 805--811
Underfull \hbox (badness 10000) in paragraph at lines 959--965
@texttt universal-argument[]@textrm , @textttsl M-DEL[] @textrm is bound to th
e func-tion
@@ -203,8 +207,8 @@ e func-tion
.@texttt v
.etc.
[10] [11] [12] [13]
Overfull \hbox (26.43913pt too wide) in paragraph at lines 1039--1039
[12] [13] [14] [15]
Overfull \hbox (26.43913pt too wide) in paragraph at lines 1204--1204
[]@texttt Meta-Control-h: backward-kill-word Text after the function name is i
gnored[] |
@@ -216,22 +220,23 @@ gnored[] |
.@texttt t
.etc.
[14] [15]
[16] [17]
@fnindfile=@write4
\openout4 = `rluserman.fn'.
[16] [17] [18] [19] [20] [21] [22]) Appendix A [23]
[18] [19] [20] [21] [22] [23] [24] [25]) Appendix A [26]
texinfo.tex: doing @include of fdl.texi
(./fdl.texi
[24] [25] [26] [27] [28] [29] [30]) [31] )
Here is how much of TeX's memory you used:
3182 strings out of 497114
31669 string characters out of 6207173
111159 words of memory out of 5000000
4359 multiletter control sequences out of 15000+600000
32778 words of font info for 114 fonts, out of 8000000 for 9000
51 hyphenation exceptions out of 8191
19i,6n,17p,364b,808s stack positions out of 5000i,500n,10000p,200000b,80000s
Output written on rluserman.dvi (34 pages, 112652 bytes).
(/usr/local/src/bash/bash-20241015/lib/readline/doc/fdl.texi [27] [28] [29]
[30] [31] [32] [33]) [34] )
Here is how much of TeX's memory you used:
3183 strings out of 495850
32327 string characters out of 6172145
115463 words of memory out of 5000000
4544 multiletter control sequences out of 15000+600000
32778 words of font info for 114 fonts, out of 8000000 for 9000
701 hyphenation exceptions out of 8191
19i,6n,17p,309b,808s stack positions out of 10000i,1000n,20000p,200000b,200000s
Output written on rluserman.dvi (37 pages, 123220 bytes).
lib/readline/doc/rluserman.pdf
BIN
View File
Binary file not shown.
lib/readline/doc/rluserman.ps
+497 -494
View File
File diff suppressed because it is too large Load Diff
lib/readline/doc/rluserman.toc
+15 -15
View File
@@ -1,23 +1,23 @@
@numchapentry{Command Line Editing}{1}{Command Line Editing}{1}
@numsecentry{Introduction to Line Editing}{1.1}{Introduction and Notation}{1}
@numsecentry{Readline Interaction}{1.2}{Readline Interaction}{1}
@numsubsecentry{Readline Bare Essentials}{1.2.1}{Readline Bare Essentials}{1}
@numsubsecentry{Readline Bare Essentials}{1.2.1}{Readline Bare Essentials}{2}
@numsubsecentry{Readline Movement Commands}{1.2.2}{Readline Movement Commands}{2}
@numsubsecentry{Readline Killing Commands}{1.2.3}{Readline Killing Commands}{2}
@numsubsecentry{Readline Killing Commands}{1.2.3}{Readline Killing Commands}{3}
@numsubsecentry{Readline Arguments}{1.2.4}{Readline Arguments}{3}
@numsubsecentry{Searching for Commands in the History}{1.2.5}{Searching}{3}
@numsecentry{Readline Init File}{1.3}{Readline Init File}{4}
@numsubsecentry{Readline Init File Syntax}{1.3.1}{Readline Init File Syntax}{4}
@numsubsecentry{Conditional Init Constructs}{1.3.2}{Conditional Init Constructs}{12}
@numsubsecentry{Sample Init File}{1.3.3}{Sample Init File}{13}
@numsecentry{Bindable Readline Commands}{1.4}{Bindable Readline Commands}{16}
@numsubsecentry{Commands For Moving}{1.4.1}{Commands For Moving}{16}
@numsubsecentry{Commands For Manipulating The History}{1.4.2}{Commands For History}{17}
@numsubsecentry{Commands For Changing Text}{1.4.3}{Commands For Text}{18}
@numsubsecentry{Killing And Yanking}{1.4.4}{Commands For Killing}{19}
@numsubsecentry{Specifying Numeric Arguments}{1.4.5}{Numeric Arguments}{20}
@numsubsecentry{Letting Readline Type For You}{1.4.6}{Commands For Completion}{21}
@numsubsecentry{Keyboard Macros}{1.4.7}{Keyboard Macros}{21}
@numsubsecentry{Some Miscellaneous Commands}{1.4.8}{Miscellaneous Commands}{22}
@numsecentry{Readline vi Mode}{1.5}{Readline vi Mode}{23}
@appentry{GNU Free Documentation License}{A}{GNU Free Documentation License}{24}
@numsubsecentry{Conditional Init Constructs}{1.3.2}{Conditional Init Constructs}{14}
@numsubsecentry{Sample Init File}{1.3.3}{Sample Init File}{15}
@numsecentry{Bindable Readline Commands}{1.4}{Bindable Readline Commands}{18}
@numsubsecentry{Commands For Moving}{1.4.1}{Commands For Moving}{18}
@numsubsecentry{Commands For Manipulating The History}{1.4.2}{Commands For History}{19}
@numsubsecentry{Commands For Changing Text}{1.4.3}{Commands For Text}{21}
@numsubsecentry{Killing And Yanking}{1.4.4}{Commands For Killing}{22}
@numsubsecentry{Specifying Numeric Arguments}{1.4.5}{Numeric Arguments}{23}
@numsubsecentry{Letting Readline Type For You}{1.4.6}{Commands For Completion}{24}
@numsubsecentry{Keyboard Macros}{1.4.7}{Keyboard Macros}{24}
@numsubsecentry{Some Miscellaneous Commands}{1.4.8}{Miscellaneous Commands}{25}
@numsecentry{Readline vi Mode}{1.5}{Readline vi Mode}{26}
@appentry{GNU Free Documentation License}{A}{GNU Free Documentation License}{27}
lib/readline/doc/rluserman.vr
+43 -37
View File
@@ -1,40 +1,46 @@
\entry{active-region-start-color}{5}{\code {active-region-start-color}}
\entry{active-region-end-color}{5}{\code {active-region-end-color}}
\entry{bell-style}{5}{\code {bell-style}}
\entry{bind-tty-special-chars}{5}{\code {bind-tty-special-chars}}
\entry{blink-matching-paren}{5}{\code {blink-matching-paren}}
\entry{colored-completion-prefix}{5}{\code {colored-completion-prefix}}
\entry{colored-stats}{5}{\code {colored-stats}}
\entry{comment-begin}{5}{\code {comment-begin}}
\entry{completion-display-width}{5}{\code {completion-display-width}}
\entry{completion-ignore-case}{5}{\code {completion-ignore-case}}
\entry{completion-map-case}{5}{\code {completion-map-case}}
\entry{completion-prefix-display-length}{5}{\code {completion-prefix-display-length}}
\entry{blink-matching-paren}{6}{\code {blink-matching-paren}}
\entry{colored-completion-prefix}{6}{\code {colored-completion-prefix}}
\entry{colored-stats}{6}{\code {colored-stats}}
\entry{comment-begin}{6}{\code {comment-begin}}
\entry{completion-display-width}{6}{\code {completion-display-width}}
\entry{completion-ignore-case}{6}{\code {completion-ignore-case}}
\entry{completion-map-case}{6}{\code {completion-map-case}}
\entry{completion-prefix-display-length}{6}{\code {completion-prefix-display-length}}
\entry{completion-query-items}{6}{\code {completion-query-items}}
\entry{convert-meta}{6}{\code {convert-meta}}
\entry{disable-completion}{6}{\code {disable-completion}}
\entry{echo-control-characters}{6}{\code {echo-control-characters}}
\entry{editing-mode}{6}{\code {editing-mode}}
\entry{emacs-mode-string}{6}{\code {emacs-mode-string}}
\entry{enable-bracketed-paste}{6}{\code {enable-bracketed-paste}}
\entry{enable-keypad}{7}{\code {enable-keypad}}
\entry{expand-tilde}{7}{\code {expand-tilde}}
\entry{history-preserve-point}{7}{\code {history-preserve-point}}
\entry{history-size}{7}{\code {history-size}}
\entry{horizontal-scroll-mode}{7}{\code {horizontal-scroll-mode}}
\entry{input-meta}{7}{\code {input-meta}}
\entry{meta-flag}{7}{\code {meta-flag}}
\entry{isearch-terminators}{7}{\code {isearch-terminators}}
\entry{keymap}{8}{\code {keymap}}
\entry{mark-modified-lines}{8}{\code {mark-modified-lines}}
\entry{mark-symlinked-directories}{8}{\code {mark-symlinked-directories}}
\entry{match-hidden-files}{8}{\code {match-hidden-files}}
\entry{menu-complete-display-prefix}{8}{\code {menu-complete-display-prefix}}
\entry{output-meta}{8}{\code {output-meta}}
\entry{page-completions}{9}{\code {page-completions}}
\entry{revert-all-at-newline}{9}{\code {revert-all-at-newline}}
\entry{show-all-if-ambiguous}{9}{\code {show-all-if-ambiguous}}
\entry{show-all-if-unmodified}{9}{\code {show-all-if-unmodified}}
\entry{show-mode-in-prompt}{9}{\code {show-mode-in-prompt}}
\entry{skip-completed-text}{9}{\code {skip-completed-text}}
\entry{vi-cmd-mode-string}{10}{\code {vi-cmd-mode-string}}
\entry{vi-ins-mode-string}{10}{\code {vi-ins-mode-string}}
\entry{visible-stats}{10}{\code {visible-stats}}
\entry{convert-meta}{7}{\code {convert-meta}}
\entry{disable-completion}{7}{\code {disable-completion}}
\entry{echo-control-characters}{7}{\code {echo-control-characters}}
\entry{editing-mode}{7}{\code {editing-mode}}
\entry{emacs-mode-string}{7}{\code {emacs-mode-string}}
\entry{enable-active-region The}{7}{\code {enable-active-region The}}
\entry{enable-bracketed-paste}{8}{\code {enable-bracketed-paste}}
\entry{enable-keypad}{8}{\code {enable-keypad}}
\entry{enable-meta-key}{8}{\code {enable-meta-key}}
\entry{expand-tilde}{8}{\code {expand-tilde}}
\entry{force-meta-prefix}{8}{\code {force-meta-prefix}}
\entry{history-preserve-point}{8}{\code {history-preserve-point}}
\entry{history-size}{9}{\code {history-size}}
\entry{horizontal-scroll-mode}{9}{\code {horizontal-scroll-mode}}
\entry{input-meta}{9}{\code {input-meta}}
\entry{meta-flag}{9}{\code {meta-flag}}
\entry{isearch-terminators}{9}{\code {isearch-terminators}}
\entry{keymap}{9}{\code {keymap}}
\entry{mark-modified-lines}{10}{\code {mark-modified-lines}}
\entry{mark-symlinked-directories}{10}{\code {mark-symlinked-directories}}
\entry{match-hidden-files}{10}{\code {match-hidden-files}}
\entry{menu-complete-display-prefix}{10}{\code {menu-complete-display-prefix}}
\entry{output-meta}{10}{\code {output-meta}}
\entry{page-completions}{10}{\code {page-completions}}
\entry{revert-all-at-newline}{10}{\code {revert-all-at-newline}}
\entry{search-ignore-case}{11}{\code {search-ignore-case}}
\entry{show-all-if-ambiguous}{11}{\code {show-all-if-ambiguous}}
\entry{show-all-if-unmodified}{11}{\code {show-all-if-unmodified}}
\entry{show-mode-in-prompt}{11}{\code {show-mode-in-prompt}}
\entry{skip-completed-text}{11}{\code {skip-completed-text}}
\entry{vi-cmd-mode-string}{11}{\code {vi-cmd-mode-string}}
\entry{vi-ins-mode-string}{12}{\code {vi-ins-mode-string}}
\entry{visible-stats}{12}{\code {visible-stats}}
lib/readline/doc/rluserman.vrs
+48 -40
View File
@@ -1,53 +1,61 @@
\initial {A}
\entry{\code {active-region-end-color}}{5}
\entry{\code {active-region-start-color}}{5}
\initial {B}
\entry {\code {bell-style}}{5}
\entry {\code {bind-tty-special-chars}}{5}
\entry {\code {blink-matching-paren}}{5}
\entry{\code {bell-style}}{5}
\entry{\code {bind-tty-special-chars}}{5}
\entry{\code {blink-matching-paren}}{6}
\initial {C}
\entry {\code {colored-completion-prefix}}{5}
\entry {\code {colored-stats}}{5}
\entry {\code {comment-begin}}{5}
\entry {\code {completion-display-width}}{5}
\entry {\code {completion-ignore-case}}{5}
\entry {\code {completion-map-case}}{5}
\entry {\code {completion-prefix-display-length}}{5}
\entry {\code {completion-query-items}}{6}
\entry {\code {convert-meta}}{6}
\entry{\code {colored-completion-prefix}}{6}
\entry{\code {colored-stats}}{6}
\entry{\code {comment-begin}}{6}
\entry{\code {completion-display-width}}{6}
\entry{\code {completion-ignore-case}}{6}
\entry{\code {completion-map-case}}{6}
\entry{\code {completion-prefix-display-length}}{6}
\entry{\code {completion-query-items}}{6}
\entry{\code {convert-meta}}{7}
\initial {D}
\entry {\code {disable-completion}}{6}
\entry{\code {disable-completion}}{7}
\initial {E}
\entry {\code {echo-control-characters}}{6}
\entry {\code {editing-mode}}{6}
\entry {\code {emacs-mode-string}}{6}
\entry {\code {enable-bracketed-paste}}{6}
\entry {\code {enable-keypad}}{7}
\entry {\code {expand-tilde}}{7}
\entry{\code {echo-control-characters}}{7}
\entry{\code {editing-mode}}{7}
\entry{\code {emacs-mode-string}}{7}
\entry{\code {enable-active-region The}}{7}
\entry{\code {enable-bracketed-paste}}{8}
\entry{\code {enable-keypad}}{8}
\entry{\code {enable-meta-key}}{8}
\entry{\code {expand-tilde}}{8}
\initial {F}
\entry{\code {force-meta-prefix}}{8}
\initial {H}
\entry {\code {history-preserve-point}}{7}
\entry {\code {history-size}}{7}
\entry {\code {horizontal-scroll-mode}}{7}
\entry{\code {history-preserve-point}}{8}
\entry{\code {history-size}}{9}
\entry{\code {horizontal-scroll-mode}}{9}
\initial {I}
\entry {\code {input-meta}}{7}
\entry {\code {isearch-terminators}}{7}
\entry{\code {input-meta}}{9}
\entry{\code {isearch-terminators}}{9}
\initial {K}
\entry {\code {keymap}}{8}
\entry{\code {keymap}}{9}
\initial {M}
\entry {\code {mark-modified-lines}}{8}
\entry {\code {mark-symlinked-directories}}{8}
\entry {\code {match-hidden-files}}{8}
\entry {\code {menu-complete-display-prefix}}{8}
\entry {\code {meta-flag}}{7}
\entry{\code {mark-modified-lines}}{10}
\entry{\code {mark-symlinked-directories}}{10}
\entry{\code {match-hidden-files}}{10}
\entry{\code {menu-complete-display-prefix}}{10}
\entry{\code {meta-flag}}{9}
\initial {O}
\entry {\code {output-meta}}{8}
\entry{\code {output-meta}}{10}
\initial {P}
\entry {\code {page-completions}}{9}
\entry{\code {page-completions}}{10}
\initial {R}
\entry {\code {revert-all-at-newline}}{9}
\entry{\code {revert-all-at-newline}}{10}
\initial {S}
\entry {\code {show-all-if-ambiguous}}{9}
\entry {\code {show-all-if-unmodified}}{9}
\entry {\code {show-mode-in-prompt}}{9}
\entry {\code {skip-completed-text}}{9}
\entry{\code {search-ignore-case}}{11}
\entry{\code {show-all-if-ambiguous}}{11}
\entry{\code {show-all-if-unmodified}}{11}
\entry{\code {show-mode-in-prompt}}{11}
\entry{\code {skip-completed-text}}{11}
\initial {V}
\entry {\code {vi-cmd-mode-string}}{10}
\entry {\code {vi-ins-mode-string}}{10}
\entry {\code {visible-stats}}{10}
\entry{\code {vi-cmd-mode-string}}{11}
\entry{\code {vi-ins-mode-string}}{12}
\entry{\code {visible-stats}}{12}
lib/readline/doc/version.texi
+2 -2
View File
@@ -5,7 +5,7 @@ Copyright (C) 1988-2024 Free Software Foundation, Inc.
@set EDITION 8.3
@set VERSION 8.3
@set UPDATED 14 October 2024
@set UPDATED 15 October 2024
@set UPDATED-MONTH October 2024
@set LASTCHANGE Mon Oct 14 11:42:19 EDT 2024
@set LASTCHANGE Tue Oct 15 16:54:39 EDT 2024
sig.c
+1 -1
View File
@@ -24,7 +24,7 @@
#if defined (HAVE_UNISTD_H)
# ifdef _MINIX
initialize_shell_signals (# include <sys/types.h>
# include <sys/types.h>
# endif
# include <unistd.h>
#endif