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

next set of documentation updates, includes readline

Browse Source
This commit is contained in:
Chet Ramey
2024-10-11 09:41:57 -04:00
parent 9d1eb43fdd
commit c7439376a3
28 changed files with 23252 additions and 21392 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CWRU/CWRU.chlog
+20
View File
@@ -10289,3 +10289,23 @@ doc/bash.1,doc/bashref.texi
- update builtins documenation: make language and paragraph breaks
more consistent between the document formats; update active
language
10/1
----
doc/bash.1,doc/bashref.texi,lib/readline/doc/rluser.texi,lib/readline/doc/hsuser.texi
- update more documentation sections to make language consistent
between formats, reduce passive voice
10/7
----
lib/readline/doc/history.3
- update history expansion section to be consistent with hsuser.texi
and bash.1
doc/bash.1,doc/bashref.texi,lib/readline/doc/rluser.texi,lib/readline/doc/readline.3
lib/readline/doc/hsuser.texi,lib/readline/doc/history.3
- next set of updates for consistency between formats, update language,
fix formatting conventions
doc/bash.0
+1684 -1663
View File
File diff suppressed because it is too large Load Diff
doc/bash.1
+609 -474
View File
File diff suppressed because it is too large Load Diff
doc/bash.html
+647 -492
View File
File diff suppressed because it is too large Load Diff
doc/bash.info
+1052 -1012
View File
File diff suppressed because it is too large Load Diff
doc/bash.pdf
BIN
View File
Binary file not shown.
doc/bashref.aux
+13 -13
View File
@@ -251,21 +251,21 @@
@xrdef{Readline Bare Essentials-snt}{Section@tie 8.2.1}
@xrdef{Readline Movement Commands-title}{Readline Movement Commands}
@xrdef{Readline Movement Commands-snt}{Section@tie 8.2.2}
@xrdef{Readline Killing Commands-title}{Readline Killing Commands}
@xrdef{Readline Killing Commands-snt}{Section@tie 8.2.3}
@xrdef{Readline Bare Essentials-pg}{128}
@xrdef{Readline Movement Commands-pg}{128}
@xrdef{Readline Killing Commands-title}{Readline Killing Commands}
@xrdef{Readline Killing Commands-snt}{Section@tie 8.2.3}
@xrdef{Readline Arguments-title}{Readline Arguments}
@xrdef{Readline Arguments-snt}{Section@tie 8.2.4}
@xrdef{Searching-title}{Searching for Commands in the History}
@xrdef{Searching-snt}{Section@tie 8.2.5}
@xrdef{Readline Killing Commands-pg}{129}
@xrdef{Readline Arguments-pg}{129}
@xrdef{Searching-pg}{129}
@xrdef{Readline Init File-title}{Readline Init File}
@xrdef{Readline Init File-snt}{Section@tie 8.3}
@xrdef{Readline Init File Syntax-title}{Readline Init File Syntax}
@xrdef{Readline Init File Syntax-snt}{Section@tie 8.3.1}
@xrdef{Searching-pg}{130}
@xrdef{Readline Init File-pg}{130}
@xrdef{Readline Init File Syntax-pg}{130}
@xrdef{Conditional Init Constructs-title}{Conditional Init Constructs}
@@ -303,9 +303,9 @@
@xrdef{Miscellaneous Commands-pg}{152}
@xrdef{Readline vi Mode-title}{Readline vi Mode}
@xrdef{Readline vi Mode-snt}{Section@tie 8.5}
@xrdef{Readline vi Mode-pg}{154}
@xrdef{Programmable Completion-title}{Programmable Completion}
@xrdef{Programmable Completion-snt}{Section@tie 8.6}
@xrdef{Readline vi Mode-pg}{155}
@xrdef{Programmable Completion-pg}{155}
@xrdef{Programmable Completion Builtins-title}{Programmable Completion Builtins}
@xrdef{Programmable Completion Builtins-snt}{Section@tie 8.7}
@@ -327,13 +327,13 @@
@xrdef{History Interaction-pg}{167}
@xrdef{Event Designators-title}{Event Designators}
@xrdef{Event Designators-snt}{Section@tie 9.3.1}
@xrdef{Event Designators-pg}{168}
@xrdef{Word Designators-title}{Word Designators}
@xrdef{Word Designators-snt}{Section@tie 9.3.2}
@xrdef{Event Designators-pg}{168}
@xrdef{Modifiers-title}{Modifiers}
@xrdef{Modifiers-snt}{Section@tie 9.3.3}
@xrdef{Word Designators-pg}{169}
@xrdef{Modifiers-pg}{169}
@xrdef{Modifiers-pg}{170}
@xrdef{Installing Bash-title}{Installing Bash}
@xrdef{Installing Bash-snt}{Chapter@tie 10}
@xrdef{Basic Installation-title}{Basic Installation}
@@ -369,22 +369,22 @@
@xrdef{Major Differences From The Bourne Shell-pg}{181}
@xrdef{GNU Free Documentation License-title}{GNU Free Documentation License}
@xrdef{GNU Free Documentation License-snt}{Appendix@tie @char67{}}
@xrdef{GNU Free Documentation License-pg}{187}
@xrdef{GNU Free Documentation License-pg}{188}
@xrdef{Indexes-title}{Indexes}
@xrdef{Indexes-snt}{Appendix@tie @char68{}}
@xrdef{Builtin Index-title}{Index of Shell Builtin Commands}
@xrdef{Builtin Index-snt}{Section@tie @char68.1}
@xrdef{Indexes-pg}{195}
@xrdef{Builtin Index-pg}{195}
@xrdef{Indexes-pg}{196}
@xrdef{Builtin Index-pg}{196}
@xrdef{Reserved Word Index-title}{Index of Shell Reserved Words}
@xrdef{Reserved Word Index-snt}{Section@tie @char68.2}
@xrdef{Variable Index-title}{Parameter and Variable Index}
@xrdef{Variable Index-snt}{Section@tie @char68.3}
@xrdef{Reserved Word Index-pg}{196}
@xrdef{Variable Index-pg}{197}
@xrdef{Reserved Word Index-pg}{197}
@xrdef{Variable Index-pg}{198}
@xrdef{Function Index-title}{Function Index}
@xrdef{Function Index-snt}{Section@tie @char68.4}
@xrdef{Function Index-pg}{199}
@xrdef{Function Index-pg}{200}
@xrdef{Concept Index-title}{Concept Index}
@xrdef{Concept Index-snt}{Section@tie @char68.5}
@xrdef{Concept Index-pg}{201}
@xrdef{Concept Index-pg}{202}
doc/bashref.bt
+1 -1
View File
@@ -55,7 +55,7 @@
\entry{disown}{126}{\code {disown}}
\entry{suspend}{126}{\code {suspend}}
\entry{compgen}{157}{\code {compgen}}
\entry{complete}{157}{\code {complete}}
\entry{complete}{158}{\code {complete}}
\entry{compopt}{161}{\code {compopt}}
\entry{fc}{165}{\code {fc}}
\entry{history}{165}{\code {history}}
doc/bashref.bts
+1 -1
View File
@@ -16,7 +16,7 @@
\entry{\code {cd}}{51}
\entry{\code {command}}{61}
\entry{\code {compgen}}{157}
\entry{\code {complete}}{157}
\entry{\code {complete}}{158}
\entry{\code {compopt}}{161}
\entry{\code {continue}}{52}
\initial {D}
doc/bashref.dvi
BIN
View File
Binary file not shown.
doc/bashref.fn
+10 -10
View File
@@ -6,7 +6,7 @@
\entry{backward-word (M-b)}{144}{\code {backward-word (M-b)}}
\entry{shell-forward-word (M-C-f)}{144}{\code {shell-forward-word (M-C-f)}}
\entry{shell-backward-word (M-C-b)}{144}{\code {shell-backward-word (M-C-b)}}
\entry{previous-screen-line ()}{144}{\code {previous-screen-line ()}}
\entry{previous-screen-line ()}{145}{\code {previous-screen-line ()}}
\entry{next-screen-line ()}{145}{\code {next-screen-line ()}}
\entry{clear-display (M-C-l)}{145}{\code {clear-display (M-C-l)}}
\entry{clear-screen (C-l)}{145}{\code {clear-screen (C-l)}}
@@ -18,7 +18,7 @@
\entry{end-of-history (M->)}{145}{\code {end-of-history (M->)}}
\entry{reverse-search-history (C-r)}{145}{\code {reverse-search-history (C-r)}}
\entry{forward-search-history (C-s)}{145}{\code {forward-search-history (C-s)}}
\entry{non-incremental-reverse-search-history (M-p)}{145}{\code {non-incremental-reverse-search-history (M-p)}}
\entry{non-incremental-reverse-search-history (M-p)}{146}{\code {non-incremental-reverse-search-history (M-p)}}
\entry{non-incremental-forward-search-history (M-n)}{146}{\code {non-incremental-forward-search-history (M-n)}}
\entry{history-search-backward ()}{146}{\code {history-search-backward ()}}
\entry{history-search-forward ()}{146}{\code {history-search-forward ()}}
@@ -35,7 +35,7 @@
\entry{quoted-insert (C-q or C-v)}{147}{\code {quoted-insert (C-q or C-v)}}
\entry{self-insert (a, b, A, 1, !, ...{})}{147}{\code {self-insert (a, b, A, 1, !, \dots {})}}
\entry{bracketed-paste-begin ()}{147}{\code {bracketed-paste-begin ()}}
\entry{transpose-chars (C-t)}{147}{\code {transpose-chars (C-t)}}
\entry{transpose-chars (C-t)}{148}{\code {transpose-chars (C-t)}}
\entry{transpose-words (M-t)}{148}{\code {transpose-words (M-t)}}
\entry{shell-transpose-words (M-C-t)}{148}{\code {shell-transpose-words (M-C-t)}}
\entry{upcase-word (M-u)}{148}{\code {upcase-word (M-u)}}
@@ -65,7 +65,7 @@
\entry{possible-completions (M-?)}{150}{\code {possible-completions (M-?)}}
\entry{insert-completions (M-*)}{150}{\code {insert-completions (M-*)}}
\entry{menu-complete ()}{150}{\code {menu-complete ()}}
\entry{menu-complete-backward ()}{150}{\code {menu-complete-backward ()}}
\entry{menu-complete-backward ()}{151}{\code {menu-complete-backward ()}}
\entry{delete-char-or-list ()}{151}{\code {delete-char-or-list ()}}
\entry{complete-filename (M-/)}{151}{\code {complete-filename (M-/)}}
\entry{possible-filename-completions (C-x /)}{151}{\code {possible-filename-completions (C-x /)}}
@@ -79,7 +79,7 @@
\entry{possible-command-completions (C-x !)}{151}{\code {possible-command-completions (C-x !)}}
\entry{dynamic-complete-history (M-TAB)}{151}{\code {dynamic-complete-history (M-\key {TAB})}}
\entry{dabbrev-expand ()}{151}{\code {dabbrev-expand ()}}
\entry{complete-into-braces (M-{\indexlbrace })}{151}{\code {complete-into-braces (M-{\tt \char 123})}}
\entry{complete-into-braces (M-{\indexlbrace })}{152}{\code {complete-into-braces (M-{\tt \char 123})}}
\entry{start-kbd-macro (C-x ()}{152}{\code {start-kbd-macro (C-x ()}}
\entry{end-kbd-macro (C-x ))}{152}{\code {end-kbd-macro (C-x ))}}
\entry{call-last-kbd-macro (C-x e)}{152}{\code {call-last-kbd-macro (C-x e)}}
@@ -93,18 +93,18 @@
\entry{tilde-expand (M-&)}{152}{\code {tilde-expand (M-&)}}
\entry{set-mark (C-@)}{152}{\code {set-mark (C-@)}}
\entry{exchange-point-and-mark (C-x C-x)}{152}{\code {exchange-point-and-mark (C-x C-x)}}
\entry{character-search (C-])}{152}{\code {character-search (C-])}}
\entry{character-search (C-])}{153}{\code {character-search (C-])}}
\entry{character-search-backward (M-C-])}{153}{\code {character-search-backward (M-C-])}}
\entry{skip-csi-sequence ()}{153}{\code {skip-csi-sequence ()}}
\entry{insert-comment (M-#)}{153}{\code {insert-comment (M-#)}}
\entry{dump-functions ()}{153}{\code {dump-functions ()}}
\entry{dump-variables ()}{153}{\code {dump-variables ()}}
\entry{dump-macros ()}{153}{\code {dump-macros ()}}
\entry{spell-correct-word (C-x s)}{153}{\code {spell-correct-word (C-x s)}}
\entry{glob-complete-word (M-g)}{153}{\code {glob-complete-word (M-g)}}
\entry{execute-named-command (M-x)}{153}{\code {execute-named-command (M-x)}}
\entry{spell-correct-word (C-x s)}{154}{\code {spell-correct-word (C-x s)}}
\entry{glob-complete-word (M-g)}{154}{\code {glob-complete-word (M-g)}}
\entry{glob-expand-word (C-x *)}{154}{\code {glob-expand-word (C-x *)}}
\entry{glob-list-expansions (C-x g)}{154}{\code {glob-list-expansions (C-x g)}}
\entry{display-shell-version (C-x C-v)}{154}{\code {display-shell-version (C-x C-v)}}
\entry{shell-expand-line (M-C-e)}{154}{\code {shell-expand-line (M-C-e)}}
\entry{history-expand-line (M-^)}{154}{\code {history-expand-line (M-^)}}
\entry{magic-space ()}{154}{\code {magic-space ()}}
@@ -112,4 +112,4 @@
\entry{history-and-alias-expand-line ()}{154}{\code {history-and-alias-expand-line ()}}
\entry{insert-last-argument (M-. or M-_)}{154}{\code {insert-last-argument (M-. or M-_)}}
\entry{edit-and-execute-command (C-x C-e)}{154}{\code {edit-and-execute-command (C-x C-e)}}
\entry{execute-named-command (M-x)}{154}{\code {execute-named-command (M-x)}}
\entry{display-shell-version (C-x C-v)}{154}{\code {display-shell-version (C-x C-v)}}
doc/bashref.fns
+9 -9
View File
@@ -14,7 +14,7 @@
\initial {C}
\entry{\code {call-last-kbd-macro (C-x e)}}{152}
\entry{\code {capitalize-word (M-c)}}{148}
\entry{\code {character-search (C-])}}{152}
\entry{\code {character-search (C-])}}{153}
\entry{\code {character-search-backward (M-C-])}}{153}
\entry{\code {clear-display (M-C-l)}}{145}
\entry{\code {clear-screen (C-l)}}{145}
@@ -22,7 +22,7 @@
\entry{\code {complete-command (M-!)}}{151}
\entry{\code {complete-filename (M-/)}}{151}
\entry{\code {complete-hostname (M-@)}}{151}
\entry{\code {complete-into-braces (M-{\tt \char 123})}}{151}
\entry{\code {complete-into-braces (M-{\tt \char 123})}}{152}
\entry{\code {complete-username (M-~)}}{151}
\entry{\code {complete-variable (M-$)}}{151}
\entry{\code {copy-backward-word ()}}{149}
@@ -48,7 +48,7 @@
\entry{\code {end-of-history (M->)}}{145}
\entry{\code {end-of-line (C-e)}}{144}
\entry{\code {exchange-point-and-mark (C-x C-x)}}{152}
\entry{\code {execute-named-command (M-x)}}{154}
\entry{\code {execute-named-command (M-x)}}{153}
\initial {F}
\entry{\code {fetch-history ()}}{147}
\entry{\code {forward-backward-delete-char ()}}{147}
@@ -56,7 +56,7 @@
\entry{\code {forward-search-history (C-s)}}{145}
\entry{\code {forward-word (M-f)}}{144}
\initial {G}
\entry{\code {glob-complete-word (M-g)}}{153}
\entry{\code {glob-complete-word (M-g)}}{154}
\entry{\code {glob-expand-word (C-x *)}}{154}
\entry{\code {glob-list-expansions (C-x g)}}{154}
\initial {H}
@@ -78,12 +78,12 @@
\initial {M}
\entry{\code {magic-space ()}}{154}
\entry{\code {menu-complete ()}}{150}
\entry{\code {menu-complete-backward ()}}{150}
\entry{\code {menu-complete-backward ()}}{151}
\initial {N}
\entry{\code {next-history (C-n)}}{145}
\entry{\code {next-screen-line ()}}{145}
\entry{\code {non-incremental-forward-search-history (M-n)}}{146}
\entry{\code {non-incremental-reverse-search-history (M-p)}}{145}
\entry{\code {non-incremental-reverse-search-history (M-p)}}{146}
\initial {O}
\entry{\code {operate-and-get-next (C-o)}}{147}
\entry{\code {overwrite-mode ()}}{148}
@@ -96,7 +96,7 @@
\entry{\code {possible-variable-completions (C-x $)}}{151}
\entry{\code {prefix-meta (\key {ESC})}}{152}
\entry{\code {previous-history (C-p)}}{145}
\entry{\code {previous-screen-line ()}}{144}
\entry{\code {previous-screen-line ()}}{145}
\entry{\code {print-last-kbd-macro ()}}{152}
\initial {Q}
\entry{\code {quoted-insert (C-q or C-v)}}{147}
@@ -115,11 +115,11 @@
\entry{\code {shell-kill-word (M-C-d)}}{149}
\entry{\code {shell-transpose-words (M-C-t)}}{148}
\entry{\code {skip-csi-sequence ()}}{153}
\entry{\code {spell-correct-word (C-x s)}}{153}
\entry{\code {spell-correct-word (C-x s)}}{154}
\entry{\code {start-kbd-macro (C-x ()}}{152}
\initial {T}
\entry{\code {tilde-expand (M-&)}}{152}
\entry{\code {transpose-chars (C-t)}}{147}
\entry{\code {transpose-chars (C-t)}}{148}
\entry{\code {transpose-words (M-t)}}{148}
\initial {U}
\entry{\code {undo (C-_ or C-x C-u)}}{152}
doc/bashref.html
+2700 -2003
View File
File diff suppressed because it is too large Load Diff
doc/bashref.info
+1052 -1012
View File
File diff suppressed because it is too large Load Diff
doc/bashref.log
+38 -62
View File
@@ -1,12 +1,12 @@
This is pdfTeX, Version 3.141592653-2.6-1.40.26 (TeX Live 2024/MacPorts 2024.70613_0) (preloaded format=pdfetex 2024.4.9) 7 OCT 2024 17:23
This is pdfTeX, Version 3.141592653-2.6-1.40.26 (TeX Live 2024/MacPorts 2024.70613_0) (preloaded format=etex 2024.4.9) 11 OCT 2024 09:00
entering extended mode
restricted \write18 enabled.
file:line:error style messages enabled.
%&-line parsing enabled.
**\input /usr/local/src/bash/bash-20240927/doc/bashref.texi \input /usr/local/s
rc/bash/bash-20240927/doc/bashref.texi
(/usr/local/src/bash/bash-20240927/doc/bashref.texi
(/usr/local/src/bash/bash-20240927/doc/texinfo.tex
**\nonstopmode \input /usr/local/src/bash/bash-20241007/doc/bashref.texi \input
/usr/local/src/bash/bash-20241007/doc/bashref.texi
(/usr/local/src/bash/bash-20241007/doc/bashref.texi
(/usr/local/src/bash/bash-20241007/doc/texinfo.tex
Loading texinfo [version 2015-11-22.14]:
\outerhsize=\dimen16
\outervsize=\dimen17
@@ -162,23 +162,20 @@ This is `epsf.tex' v2.7.4 <14 February 2011>
texinfo.tex: doing @include of version.texi
(/usr/local/src/bash/bash-20240927/doc/version.texi) [1{/opt/local/var/db/texmf
/fonts/map/pdftex/updmap/pdftex.map}] [2]
(/usr/local/build/bash/bash-20240927/doc/bashref.toc [-1] [-2] [-3]) [-4]
(/usr/local/build/bash/bash-20240927/doc/bashref.toc)
(/usr/local/build/bash/bash-20240927/doc/bashref.toc) Chapter 1
(/usr/local/src/bash/bash-20241007/doc/version.texi) [1] [2]
(/usr/local/build/bash/bash-20241007/doc/bashref.toc [-1] [-2] [-3]) [-4]
Chapter 1
\openout0 = `bashref.toc'.
(/usr/local/build/bash/bash-20240927/doc/bashref.aux)
(/usr/local/build/bash/bash-20241007/doc/bashref.aux)
\openout1 = `bashref.aux'.
Chapter 2 [1] [2]
[1] Chapter 2
[2]
@cpindfile=@write2
\openout2 = `bashref.cp'.
[3] Chapter 3 [4] [5] [6] [7]
[3] Chapter 3 [4] [5] [6] [7]
@vrindfile=@write3
\openout3 = `bashref.vr'.
@@ -222,17 +219,16 @@ Overfull \hbox (5.95723pt too wide) in paragraph at lines 737--738
@rwindfile=@write4
\openout4 = `bashref.rw'.
[10] [11] [12] [13] [14] [15] [16] [17] [18] [19{/opt/local/share/texmf-texliv
e/fonts/enc/dvips/cm-super/cm-super-t1.enc}] [20] [21] [22] [23] [24]
[25] [26] [27] [28] [29] [30] [31] [32] [33] [34] [35] [36] [37] [38] [39]
[40] [41] [42] [43] [44] [45] [46] [47] [48] Chapter 4 [49]
[10] [11] [12] [13] [14] [15] [16] [17] [18] [19] [20] [21] [22] [23]
[24] [25] [26] [27] [28] [29] [30] [31] [32] [33] [34] [35] [36] [37] [38]
[39] [40] [41] [42] [43] [44] [45] [46] [47] [48] Chapter 4 [49]
@btindfile=@write5
\openout5 = `bashref.bt'.
[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
[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 5702--5702
[]@texttt set [-abefhkmnptuvxBCEHPT] [-o @textttsl option-name@texttt ] [--] [
-] [@textttsl ar-gu-ment []@texttt ][]
@@ -245,7 +241,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 5703--5703
[]@texttt set [+abefhkmnptuvxBCEHPT] [+o @textttsl option-name@texttt ] [--] [
-] [@textttsl ar-gu-ment []@texttt ][]
@@ -265,9 +261,9 @@ Chapter 7 [122] [123] [124] [125]
texinfo.tex: doing @include of rluser.texi
(/usr/local/src/bash/bash-20240927/lib/readline/doc/rluser.texi Chapter 8
(/usr/local/src/bash/bash-20241007/lib/readline/doc/rluser.texi Chapter 8
[126] [127] [128] [129] [130] [131] [132] [133] [134] [135] [136] [137]
Underfull \hbox (badness 7540) in paragraph at lines 919--925
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
@@ -280,7 +276,7 @@ Underfull \hbox (badness 7540) in paragraph at lines 919--925
.etc.
Underfull \hbox (badness 10000) in paragraph at lines 919--925
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
@@ -293,7 +289,7 @@ e func-tion
.etc.
[138] [139] [140] [141]
Overfull \hbox (26.43913pt too wide) in paragraph at lines 1155--1155
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[]
@@ -314,10 +310,10 @@ gnored[]
texinfo.tex: doing @include of hsuser.texi
(/usr/local/src/bash/bash-20240927/lib/readline/doc/hsuser.texi Chapter 9
(/usr/local/src/bash/bash-20241007/lib/readline/doc/hsuser.texi Chapter 9
[163] [164] [165] [166] [167] [168] [169]) Chapter 10 [170] [171] [172]
[173] [174]
Underfull \hbox (badness 10000) in paragraph at lines 10261--10270
Underfull \hbox (badness 10000) in paragraph at lines 10283--10292
[]@textrm All of the fol-low-ing op-tions ex-cept for `@texttt alt-array-implem
entation[]@textrm '[],
@@ -330,7 +326,7 @@ entation[]@textrm '[],
.etc.
Underfull \hbox (badness 10000) in paragraph at lines 10261--10270
Underfull \hbox (badness 10000) in paragraph at lines 10283--10292
@textrm `@texttt disabled-builtins[]@textrm '[], `@texttt direxpand-default[]@t
extrm '[], `@texttt strict-posix-default[]@textrm '[], and
@@ -343,40 +339,20 @@ extrm '[], `@texttt strict-posix-default[]@textrm '[], and
.etc.
[175] [176] [177] [178] Appendix A [179] Appendix B [180] [181] [182] [183]
[184] [185] Appendix C [186]
[184] [185] [186] Appendix C [187]
texinfo.tex: doing @include of fdl.texi
(/usr/local/src/bash/bash-20240927/doc/fdl.texi
[187] [188] [189] [190] [191] [192] [193]) Appendix D [194] [195] [196]
[197] [198] [199] [200] [201] [202] [203] )
(/usr/local/src/bash/bash-20241007/doc/fdl.texi [188] [189] [190] [191]
[192] [193] [194]) Appendix D [195] [196] [197] [198] [199] [200] [201]
[202] [203] [204] )
Here is how much of TeX's memory you used:
4111 strings out of 495840
47647 string characters out of 6171739
143369 words of memory out of 5000000
5048 multiletter control sequences out of 15000+600000
3531 strings out of 495850
40273 string characters out of 6172145
88586 words of memory out of 5000000
4879 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
16i,6n,16p,389b,983s stack positions out of 10000i,1000n,20000p,200000b,200000s
</opt/local/share/texmf-texlive/font
s/type1/public/amsfonts/cm/cmbx12.pfb></opt/local/share/texmf-texlive/fonts/typ
e1/public/amsfonts/cm/cmcsc10.pfb></opt/local/share/texmf-texlive/fonts/type1/p
ublic/amsfonts/cm/cmmi10.pfb></opt/local/share/texmf-texlive/fonts/type1/public
/amsfonts/cm/cmmi12.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsf
onts/cm/cmmi9.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/c
m/cmr10.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmr9
.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmsl10.pfb>
</opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmsltt10.pfb></o
pt/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmsy10.pfb></opt/lo
cal/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmti10.pfb></opt/local/s
hare/texmf-texlive/fonts/type1/public/amsfonts/cm/cmtt10.pfb></opt/local/share/
texmf-texlive/fonts/type1/public/amsfonts/cm/cmtt12.pfb></opt/local/share/texmf
-texlive/fonts/type1/public/amsfonts/cm/cmtt9.pfb></opt/local/share/texmf-texli
ve/fonts/type1/public/cm-super/sfrm1095.pfb></opt/local/share/texmf-texlive/fon
ts/type1/public/cm-super/sfrm1440.pfb>
Output written on bashref.pdf (209 pages, 838618 bytes).
PDF statistics:
2885 PDF objects out of 2984 (max. 8388607)
2628 compressed objects within 27 object streams
337 named destinations out of 1000 (max. 500000)
1157 words of extra memory for PDF output out of 10000 (max. 10000000)
16i,6n,16p,402b,942s stack positions out of 10000i,1000n,20000p,200000b,200000s
Output written on bashref.dvi (210 pages, 880460 bytes).
doc/bashref.pdf
BIN
View File
Binary file not shown.
doc/bashref.ps
+13546 -13036
View File
File diff suppressed because it is too large Load Diff
doc/bashref.texi
+471 -400
View File
File diff suppressed because it is too large Load Diff
doc/bashref.toc
+10 -10
View File
@@ -97,7 +97,7 @@
@numsubsecentry{Readline Movement Commands}{8.2.2}{Readline Movement Commands}{128}
@numsubsecentry{Readline Killing Commands}{8.2.3}{Readline Killing Commands}{129}
@numsubsecentry{Readline Arguments}{8.2.4}{Readline Arguments}{129}
@numsubsecentry{Searching for Commands in the History}{8.2.5}{Searching}{129}
@numsubsecentry{Searching for Commands in the History}{8.2.5}{Searching}{130}
@numsecentry{Readline Init File}{8.3}{Readline Init File}{130}
@numsubsecentry{Readline Init File Syntax}{8.3.1}{Readline Init File Syntax}{130}
@numsubsecentry{Conditional Init Constructs}{8.3.2}{Conditional Init Constructs}{140}
@@ -111,7 +111,7 @@
@numsubsecentry{Letting Readline Type For You}{8.4.6}{Commands For Completion}{150}
@numsubsecentry{Keyboard Macros}{8.4.7}{Keyboard Macros}{152}
@numsubsecentry{Some Miscellaneous Commands}{8.4.8}{Miscellaneous Commands}{152}
@numsecentry{Readline vi Mode}{8.5}{Readline vi Mode}{154}
@numsecentry{Readline vi Mode}{8.5}{Readline vi Mode}{155}
@numsecentry{Programmable Completion}{8.6}{Programmable Completion}{155}
@numsecentry{Programmable Completion Builtins}{8.7}{Programmable Completion Builtins}{157}
@numsecentry{A Programmable Completion Example}{8.8}{A Programmable Completion Example}{161}
@@ -121,7 +121,7 @@
@numsecentry{History Expansion}{9.3}{History Interaction}{167}
@numsubsecentry{Event Designators}{9.3.1}{Event Designators}{168}
@numsubsecentry{Word Designators}{9.3.2}{Word Designators}{169}
@numsubsecentry{Modifiers}{9.3.3}{Modifiers}{169}
@numsubsecentry{Modifiers}{9.3.3}{Modifiers}{170}
@numchapentry{Installing Bash}{10}{Installing Bash}{171}
@numsecentry{Basic Installation}{10.1}{Basic Installation}{171}
@numsecentry{Compilers and Options}{10.2}{Compilers and Options}{172}
@@ -134,10 +134,10 @@
@appentry{Reporting Bugs}{A}{Reporting Bugs}{180}
@appentry{Major Differences From The Bourne Shell}{B}{Major Differences From The Bourne Shell}{181}
@appsecentry{Implementation Differences From The SVR4.2 Shell}{B.1}{}{186}
@appentry{GNU Free Documentation License}{C}{GNU Free Documentation License}{187}
@appentry{Indexes}{D}{Indexes}{195}
@appsecentry{Index of Shell Builtin Commands}{D.1}{Builtin Index}{195}
@appsecentry{Index of Shell Reserved Words}{D.2}{Reserved Word Index}{196}
@appsecentry{Parameter and Variable Index}{D.3}{Variable Index}{197}
@appsecentry{Function Index}{D.4}{Function Index}{199}
@appsecentry{Concept Index}{D.5}{Concept Index}{201}
@appentry{GNU Free Documentation License}{C}{GNU Free Documentation License}{188}
@appentry{Indexes}{D}{Indexes}{196}
@appsecentry{Index of Shell Builtin Commands}{D.1}{Builtin Index}{196}
@appsecentry{Index of Shell Reserved Words}{D.2}{Reserved Word Index}{197}
@appsecentry{Parameter and Variable Index}{D.3}{Variable Index}{198}
@appsecentry{Function Index}{D.4}{Function Index}{200}
@appsecentry{Concept Index}{D.5}{Concept Index}{202}
doc/bashref.vr
+5 -4
View File
@@ -134,7 +134,7 @@
\entry{active-region-start-color}{131}{\code {active-region-start-color}}
\entry{active-region-end-color}{131}{\code {active-region-end-color}}
\entry{bell-style}{131}{\code {bell-style}}
\entry{bind-tty-special-chars}{131}{\code {bind-tty-special-chars}}
\entry{bind-tty-special-chars}{132}{\code {bind-tty-special-chars}}
\entry{blink-matching-paren}{132}{\code {blink-matching-paren}}
\entry{colored-completion-prefix}{132}{\code {colored-completion-prefix}}
\entry{colored-stats}{132}{\code {colored-stats}}
@@ -143,18 +143,19 @@
\entry{completion-ignore-case}{132}{\code {completion-ignore-case}}
\entry{completion-map-case}{132}{\code {completion-map-case}}
\entry{completion-prefix-display-length}{132}{\code {completion-prefix-display-length}}
\entry{completion-query-items}{132}{\code {completion-query-items}}
\entry{completion-query-items}{133}{\code {completion-query-items}}
\entry{convert-meta}{133}{\code {convert-meta}}
\entry{disable-completion}{133}{\code {disable-completion}}
\entry{echo-control-characters}{133}{\code {echo-control-characters}}
\entry{editing-mode}{133}{\code {editing-mode}}
\entry{emacs-mode-string}{133}{\code {emacs-mode-string}}
\entry{enable-active-region}{133}{\code {enable-active-region}}
\entry{enable-active-region The}{134}{\code {enable-active-region The}}
\entry{enable-bracketed-paste}{134}{\code {enable-bracketed-paste}}
\entry{enable-keypad}{134}{\code {enable-keypad}}
\entry{enable-meta-key}{134}{\code {enable-meta-key}}
\entry{expand-tilde}{134}{\code {expand-tilde}}
\entry{force-meta-prefix}{134}{\code {force-meta-prefix}}
\entry{history-preserve-point}{134}{\code {history-preserve-point}}
\entry{history-preserve-point}{135}{\code {history-preserve-point}}
\entry{history-size}{135}{\code {history-size}}
\entry{horizontal-scroll-mode}{135}{\code {horizontal-scroll-mode}}
\entry{input-meta}{135}{\code {input-meta}}
doc/bashref.vrs
+5 -4
View File
@@ -53,7 +53,7 @@
\entry{\code {BASHOPTS}}{85}
\entry{\code {BASHPID}}{85}
\entry{\code {bell-style}}{131}
\entry{\code {bind-tty-special-chars}}{131}
\entry{\code {bind-tty-special-chars}}{132}
\entry{\code {blink-matching-paren}}{132}
\initial {C}
\entry{\code {CDPATH}}{84}
@@ -73,7 +73,7 @@
\entry{\code {completion-ignore-case}}{132}
\entry{\code {completion-map-case}}{132}
\entry{\code {completion-prefix-display-length}}{132}
\entry{\code {completion-query-items}}{132}
\entry{\code {completion-query-items}}{133}
\entry{\code {COMPREPLY}}{89}
\entry{\code {convert-meta}}{133}
\entry{\code {COPROC}}{89}
@@ -85,9 +85,10 @@
\entry{\code {editing-mode}}{133}
\entry{\code {emacs-mode-string}}{133}
\entry{\code {EMACS}}{89}
\entry{\code {enable-active-region}}{133}
\entry{\code {enable-active-region The}}{134}
\entry{\code {enable-bracketed-paste}}{134}
\entry{\code {enable-keypad}}{134}
\entry{\code {enable-meta-key}}{134}
\entry{\code {ENV}}{89}
\entry{\code {EPOCHREALTIME}}{90}
\entry{\code {EPOCHSECONDS}}{90}
@@ -111,7 +112,7 @@
\entry{\code {HISTFILE}}{92}
\entry{\code {HISTFILESIZE}}{92}
\entry{\code {HISTIGNORE}}{92}
\entry{\code {history-preserve-point}}{134}
\entry{\code {history-preserve-point}}{135}
\entry{\code {history-size}}{135}
\entry{\code {HISTSIZE}}{92}
\entry{\code {HISTTIMEFORMAT}}{93}
doc/builtins.0
+366 -408
View File
File diff suppressed because it is too large Load Diff
doc/version.texi
+3 -3
View File
@@ -2,10 +2,10 @@
Copyright (C) 1988-2024 Free Software Foundation, Inc.
@end ignore
@set LASTCHANGE Sun Sep 29 22:28:43 EDT 2024
@set LASTCHANGE Thu Oct 10 10:31:59 EDT 2024
@set EDITION 5.3
@set VERSION 5.3
@set UPDATED 29 September 2024
@set UPDATED-MONTH September 2024
@set UPDATED 10 October 2024
@set UPDATED-MONTH October 2024
lib/readline/doc/history.3
+65 -38
View File
@@ -6,9 +6,9 @@
.\" Case Western Reserve University
.\" chet.ramey@case.edu
.\"
.\" Last Change: Tue Aug 13 14:29:23 EDT 2024
.\" Last Change: Thu Oct 10 16:50:53 EDT 2024
.\"
.TH HISTORY 3 "2024 August 13" "GNU History 8.3"
.TH HISTORY 3 "2024 October 10" "GNU History 8.3"
.\"
.ie \n(.g \{\
.ds ' \(aq
@@ -76,10 +76,19 @@ history \- GNU History Library
.if t The GNU History Library is Copyright \(co 1989-2024 by the Free Software Foundation, Inc.
.if n The GNU History Library is Copyright (C) 1989-2024 by the Free Software Foundation, Inc.
.SH DESCRIPTION
Many programs read input from the user a line at a time. The GNU
Many programs read input from the user a line at a time.
The GNU
History library is able to keep track of those lines, associate arbitrary
data with each line, and utilize information from previous lines in
composing new ones.
.PP
The History library provides functions that allow applications to their
\fIhistory\fP, the set of previously-typed lines,
which it keeps in a list.
Applications can choose which lines to save into a history list, how
many commands to save, save a history list to a file, read a history
list from a file, and display lines from the history in various
formats.
.SH "HISTORY EXPANSION"
The history library supports a history expansion feature that
is identical to the history expansion in
@@ -94,21 +103,28 @@ fix errors in previous commands quickly.
History expansion is usually performed immediately after a complete line
is read.
It takes place in two parts.
The first is to determine which line from the history list
The first is to determine which history list entry
to use during substitution.
The second is to select portions of that line for inclusion into
The second is to select portions of that entry to include into
the current one.
The line selected from the history is the \fIevent\fP,
and the portions of that line that are acted upon are \fIwords\fP.
.PP
The entry selected from the history is the \fIevent\fP,
and the portions of that entry that are acted upon are \fIwords\fP.
Various \fImodifiers\fP are available to manipulate the selected words.
The line is broken into words in the same fashion as \fBbash\fP
The entry is split into words in the same fashion as \fBbash\fP
does when reading input,
so that several words that would otherwise be separated
are considered one word when surrounded by quotes (see the
description of \fBhistory_tokenize()\fP below).
The \fIevent designator\fP selects the event, the optional
\fIword designator\fP selects words from the event, and
various optional \fImodifiers\fP are available to manipulate the
selected words.
.PP
History expansions are introduced by the appearance of the
history expansion character, which is \^\fB!\fP\^ by default.
History expansions may appear anywhere in the input, but do not nest.
.PP
Only backslash (\^\fB\e\fP\^) and single quotes can quote
the history expansion character.
.PP
@@ -117,13 +133,16 @@ There is a special abbreviation for substitution, active when the
is the first character on the line.
It selects the previous history list entry, using an event designator
equivalent to \fB!!\fP,
and substitutes one string for another in that line.
and substitutes one string for another in that entry.
It is described below under \fBEvent Designators\fP.
This is the only history expansion that does not begin with the history
expansion character.
.SS Event Designators
An event designator is a reference to a command line entry in the
history list.
An event designator is a reference to an entry in the history list.
The event designator
consists of the portion of the word beginning with the history
expansion character and ending with the word designator if present,
or the end of the word.
Unless the reference is absolute, events are relative to the current
position in the history list.
.PP
@@ -132,18 +151,20 @@ position in the history list.
.B !
Start a history substitution, except when followed by a
.BR blank ,
newline, = or (.
newline, carriage return, =,
or (.
.TP
.B !\fIn\fP
Refer to command line
Refer to history list entry
.IR n .
.TP
.B !\-\fIn\fP
Refer to the current command minus
Refer to the current entry minus
.IR n .
.TP
.B !!
Refer to the previous command. This is a synonym for
Refer to the previous entry.
This is a synonym for
.Q !\-1 .
.TP
.B !\fIstring\fP
@@ -158,16 +179,20 @@ history list containing
The trailing \fB?\fP may be omitted if
.I string
is followed immediately by a newline.
If \fIstring\fP is missing, the string from the most recent search is used;
If \fIstring\fP is missing, this uses
the string from the most recent search;
it is an error if there is no previous search string.
.TP
.B \*^\fIstring1\fP\*^\fIstring2\fP\*^
Quick substitution. Repeat the last command, replacing
.B \d\s+2\*^\s-2\u\fIstring1\fP\d\s+2\*^\s-2\u\fIstring2\fP\d\s+2\*^\s-2\u
.\" was .B \*^\fIstring1\fP\*^\fIstring2\fP\*^
Quick substitution.
Repeat the previous command, replacing
.I string1
with
.IR string2 .
Equivalent to
.Q !!:s\*^\fIstring1\fP\*^\fIstring2\fP\*^
.Q !!:s\d\s+2\*^\s-2\u\fIstring1\fP\d\s+2\*^\s-2\u\fIstring2\fP\d\s+2\*^\s-2\u
.\" was .Q !!:s\*^\fIstring1\fP\*^\fIstring2\fP\*^
(see \fBModifiers\fP below).
.TP
.B !#
@@ -175,6 +200,8 @@ The entire command line typed so far.
.PD
.SS Word Designators
Word designators are used to select desired words from the event.
They are optional; if the word designator isn't supplied, the history
expansion uses the entire event.
A
.B :
separates the event specification from the word designator.
@@ -192,17 +219,18 @@ Words are inserted into the current line separated by single spaces.
.PD 0
.TP
.B 0 (zero)
The zeroth word. For the shell, this is the command
word.
The zeroth word.
For the shell, and many other applications, this is the command word.
.TP
.I n
The \fIn\fPth word.
.TP
.B \*^
The first argument. That is, word 1.
The first argument: word 1.
.TP
.B $
The last word. This is usually the last argument, but will expand to the
The last word.
This is usually the last argument, but will expand to the
zeroth word if there is only one word in the line.
.TP
.B %
@@ -226,8 +254,8 @@ This is a synonym for
.Q \fI1\-$\fP .
It is not an error to use
.B *
if there is just one
word in the event; the empty string is returned in that case.
if there is just one word in the event;
it expands to the empty string in that case.
.TP
.B x*
Abbreviates \fIx\-$\fP.
@@ -238,21 +266,20 @@ If \fBx\fP is missing, it defaults to 0.
.PD
.PP
If a word designator is supplied without an event specification, the
previous command is used as the event.
previous command is used as the event, equivalent to \fB!!\fP.
.SS Modifiers
After the optional word designator, there may appear a sequence of
one or more of the following modifiers, each preceded by a
After the optional word designator, the expansion may include a
sequence of one or more of the following modifiers, each preceded by a
.Q : .
These modify, or edit, the word or words selected from the history event.
.PP
.PD 0
.PP
.TP
.B h
Remove a trailing file name component, leaving only the head.
Remove a trailing filename component, leaving only the head.
.TP
.B t
Remove all leading file name components, leaving the tail.
Remove all leading filename components, leaving the tail.
.TP
.B r
Remove a trailing suffix of the form \fI.xxx\fP, leaving the
@@ -273,8 +300,8 @@ Quote the substituted words as with
but break into words at
.B blanks
and newlines.
The \fBq\fP and \fBx\fP modifiers are mutually exclusive; the last one
supplied is used.
The \fBq\fP and \fBx\fP modifiers are mutually exclusive;
expansion uses the last one supplied.
.TP
.B s/\fIold\fP/\fInew\fP/
Substitute
@@ -285,13 +312,13 @@ in the event line.
Any character may be used as the delimiter in place of /.
The final delimiter is optional if it is the last character of the
event line.
The delimiter may be quoted in
A single backslash will quote the delimiter in
.I old
and
.I new
with a single backslash. If & appears in
.IR new .
If & appears in
.IR new ,
it is replaced by
it is replaced with
.IR old .
A single backslash will quote the &.
If
@@ -337,7 +364,7 @@ modifier once to each word in the event line.
.PD
.SH "PROGRAMMING WITH HISTORY FUNCTIONS"
This section describes how to use the History library in other programs.
.SS Introduction to History
.SS "Introduction to History"
A programmer using the History library has available functions
for remembering lines on a history list, associating arbitrary data
with a line, removing lines from the list, searching through the list
lib/readline/doc/hsuser.texi
+60 -50
View File
@@ -71,9 +71,9 @@ is enabled (@pxref{The Set Builtin}),
the shell provides access to the @dfn{command history},
the list of commands previously typed.
The value of the @env{HISTSIZE} shell variable is used as the
number of commands to save in a history list.
The text of the last @env{$HISTSIZE}
commands (default 500) is saved.
number of commands to save in a history list:
the shell saves the text of the last @env{$HISTSIZE}
commands (default 500).
The shell stores each command in the history list prior to
parameter and variable expansion
but after history expansion is performed, subject to the
@@ -84,9 +84,9 @@ When the shell starts up, Bash initializes the history list
by reading history entries from the
file named by the @env{HISTFILE} variable (default @file{~/.bash_history}).
This is referred to as the @dfn{history file}.
That file is truncated, if necessary,
to contain no more than the number of history entries specified by
the value of the @env{HISTFILESIZE} variable.
The history file is truncated, if necessary,
to contain no more than the number of history entries
specified by the value of the @env{HISTFILESIZE} variable.
If @env{HISTFILESIZE} is unset, or set to null, a non-numeric value,
or a numeric value less than zero, the history file is not truncated.
@@ -103,36 +103,37 @@ When a shell with history enabled exits, Bash copies the last
named by @env{$HISTFILE}.
If the @code{histappend} shell option is set (@pxref{Bash Builtins}),
Bash appends the entries to the history file,
otherwise the history file is overwritten.
otherwise it overwrites the history file.
If @env{HISTFILE} is unset or null,
or if the history file is unwritable, the history is not saved.
After saving the history, Bash truncates the history file
to contain no more than @env{$HISTFILESIZE} lines.
If @env{HISTFILESIZE} is unset, or set to null, a non-numeric value, or
a numeric value less than zero, the history file is not truncated.
to contain no more than @env{$HISTFILESIZE}
lines as described above.
If the @env{HISTTIMEFORMAT} is set, the time stamp information
associated with each history entry is written to the history file,
marked with the history comment character.
When the history file is read, lines beginning with the history
comment character followed immediately by a digit are interpreted
as timestamps for the following history entry.
If the @env{HISTTIMEFORMAT}
variable is set, the shell writes the timestamp information
associated with each history entry to the history file,
marked with the history comment character,
so timestamps are preserved across shell sessions.
When the history file is read, lines beginning with
the history comment character followed immediately by a digit are
interpreted as timestamps for the following history entry.
As above, when using @env{HISTTIMEFORMAT},
the timestamps delimit multi-line history entries.
The @code{fc} builtin command will list or edit and re-execute
a portion of the history list.
The @code{history} builtin can display or modify the history
list and manipulate the history file.
The @code{fc} builtin command will list or edit and re-execute a
portion of the history list.
The @code{history} builtin can display or
modify the history list and manipulate the history file.
When using command-line editing, search commands
are available in each editing mode that provide access to the
history list (@pxref{Commands For History}).
history list (@pxref{Commands For History}).
The shell allows control over which commands are saved on the history list.
The shell allows control over which commands are saved on the history list.
The @env{HISTCONTROL} and @env{HISTIGNORE}
variables are used to save only a subset of the commands entered.
The @code{cmdhist}
shell option, if enabled, causes the shell to attempt to save each
If the @code{cmdhist} shell option is
enabled, the shell attempts to save each
line of a multi-line command in the same history entry, adding
semicolons where necessary to preserve syntactic correctness.
The @code{lithist}
@@ -157,9 +158,9 @@ history list and history file.
@code{fc -s [@var{pat}=@var{rep}] [@var{command}]}
@end example
The first form selects a range of commands from @var{first} to
@var{last} from the history list and displays or edits and re-executes
them.
The first form selects a range of commands from
@var{first} to @var{last}
from the history list and displays or edits and re-executes them.
Both @var{first} and
@var{last} may be specified as a string (to locate the most recent
command beginning with that string) or as a number (an index into the
@@ -171,7 +172,8 @@ and -0 is equivalent to the current command (usually the @code{fc}
command);
otherwise 0 is equivalent to -1 and -0 is invalid.
If @var{last} is not specified, it is set to @var{first}.
If @var{last} is not specified, it is set to
the current command for listing and to @var{first} otherwise.
If @var{first} is not specified, it is set to the previous
command for editing and @minus{}16 for listing.
@@ -234,8 +236,7 @@ Options, if supplied, have the following meanings:
@table @code
@item -c
Clear the history list.
This may be combined
with the other options to replace the history list.
This may be combined with the other options to replace the history list.
@item -d @var{offset}
Delete the history entry at position @var{offset}.
@@ -258,8 +259,8 @@ These are history lines entered since the beginning of the current
Bash session, but not already appended to the history file.
@item -n
Append the history lines not already read from the history file
to the current history list.
Read the history lines not already read from the history file
and add them to the current history list.
These are lines appended to the history
file since the beginning of the current Bash session.
@@ -267,7 +268,8 @@ file since the beginning of the current Bash session.
Read the history file and append its contents to the history list.
@item -w
Write the current history list to the history file, overwriting it.
Write the current history list to the history file, overwriting
the history file.
@item -p
Perform history substitution on the @var{arg}s and display the result
@@ -288,7 +290,7 @@ If @env{HISTFILE} is unset or null, these options have no effect.
If the @env{HISTTIMEFORMAT}
variable is set, @code{history} writes the time stamp information
associated with each history entry to the history file,
marked with the history comment character.
marked with the history comment character as described above.
When the history file is read, lines beginning with the history
comment character followed immediately by a digit are interpreted
as timestamps for the following history entry.
@@ -345,10 +347,11 @@ The second is to select portions of that entry to include into the
current one.
The entry selected from the history is called the @dfn{event},
and the portions of that entry that are acted upon are called @dfn{words}.
The history entry is broken into words in the same fashion
that Bash does, so that several words
surrounded by quotes are considered one word.
and the portions of that entry that are acted upon are @dfn{words}.
Various @dfn{modifiers} are available to manipulate the selected words.
The entry is split into words in the same fashion that Bash
does when reading input,
so that several words surrounded by quotes are considered one word.
The @dfn{event designator} selects the event, the optional
@dfn{word designator} selects words from the event, and
various optional @dfn{modifiers} are available to manipulate the
@@ -380,9 +383,15 @@ and the other shell metacharacters.
@end ifset
There is a special abbreviation for substitution, active when the
@var{quick substitution} character (default @samp{^})
@var{quick substitution} character
@ifset BashFeatures
(described above under @code{histchars})
@end ifset
@ifclear BashFeatures
(default @samp{^})
@end ifclear
is the first character on the line.
It selects the previous history entry, using an event designator
It selects the previous history list entry, using an event designator
equivalent to @code{!!},
and substitutes one string for another in that entry.
It is described below (@pxref{Event Designators}).
@@ -427,11 +436,11 @@ timestamps when writing the history file.
@cindex event designators
An event designator is a reference to an entry in the history list.
Unless the reference is absolute, events are relative to the current
position in the history list.
The event designator consists of the portion of the word beginning
with the history expansion character, and ending with the word designator
if one is present, or the end of the word.
Unless the reference is absolute, events are relative to the current
position in the history list.
@cindex history events
@table @asis
@@ -452,10 +461,10 @@ the end of the line, or @samp{=}.
Refer to history list entry @var{n}.
@item @code{!-@var{n}}
Refer to the history entry @var{n} entries back.
Refer to the history entry minus @var{n}.
@item @code{!!}
Refer to the previous command.
Refer to the previous entry.
This is a synonym for @samp{!-1}.
@item @code{!@var{string}}
@@ -521,7 +530,7 @@ Here are the word designators:
@item 0 (zero)
The @code{0}th word.
For many applications, this is the command word.
For the shell, and many other, applications, this is the command word.
@item @var{n}
The @var{n}th word.
@@ -530,7 +539,7 @@ The @var{n}th word.
The first argument: word 1.
@item $
The last argument.
The last word.
This is usually the last argument, but will expand to the
zeroth word if there is only one word in the line.
@@ -548,7 +557,7 @@ A range of words; @samp{-@var{y}} abbreviates @samp{0-@var{y}}.
All of the words, except the @code{0}th.
This is a synonym for @samp{1-$}.
It is not an error to use @samp{*} if there is just one word in the event;
it expands to the empty string in this case.
it expands to the empty string in that case.
@item @var{x}*
Abbreviates @samp{@var{x}-$}.
@@ -572,10 +581,10 @@ These modify, or edit, the word or words selected from the history event.
@table @code
@item h
Remove a trailing pathname component, leaving only the head.
Remove a trailing filename component, leaving only the head.
@item t
Remove all leading pathname components, leaving the tail.
Remove all leading filename components, leaving the tail.
@item r
Remove a trailing suffix of the form @samp{.@var{suffix}}, leaving
@@ -621,7 +630,8 @@ Repeat the previous substitution.
@item g
@itemx a
Cause changes to be applied over the entire event line.
Used in conjunction with @samp{s}, as in @code{gs/@var{old}/@var{new}/},
This is used in conjunction with
@samp{s}, as in @code{gs/@var{old}/@var{new}/},
or with @samp{&}.
@item G
lib/readline/doc/readline.3
+377 -288
View File
File diff suppressed because it is too large Load Diff
lib/readline/doc/rluser.texi
+505 -396
View File
File diff suppressed because it is too large Load Diff
lib/readline/doc/version.texi
+3 -3
View File
@@ -5,7 +5,7 @@ Copyright (C) 1988-2024 Free Software Foundation, Inc.
@set EDITION 8.3
@set VERSION 8.3
@set UPDATED 23 August 2024
@set UPDATED-MONTH August 2024
@set UPDATED 10 October 2024
@set UPDATED-MONTH October 2024
@set LASTCHANGE Fri Aug 23 09:46:18 EDT 2024
@set LASTCHANGE Thu Oct 10 16:33:55 EDT 2024