fix for read builtin and invalid multibyte characters followed by the delimiter; updated formatted documentation; new bash.pot file with updated strings; updated translations

This commit is contained in:
Chet Ramey
2025-04-22 10:39:43 -04:00
parent 482872ed8b
commit 7731dc5c4d
77 changed files with 19705 additions and 13848 deletions
+213 -209
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, 24 February 2025).
Bash shell (version 5.3, 7 April 2025).
This is Edition 5.3, last updated 24 February 2025, of The GNU Bash
This is Edition 5.3, last updated 7 April 2025, of The GNU Bash
Reference Manual, for Bash, Version 5.3.
Copyright © 1988-2025 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, 24 February 2025). The Bash home page is
Bash shell (version 5.3, 7 April 2025). The Bash home page is
<http://www.gnu.org/software/bash/>.
This is Edition 5.3, last updated 24 February 2025, of The GNU Bash
This is Edition 5.3, last updated 7 April 2025, of The GNU Bash
Reference Manual, for Bash, Version 5.3.
Bash contains features that appear in other popular shells, and some
@@ -3597,9 +3597,10 @@ standard.
to shell functions; otherwise the names refer to shell variables.
The -n option means to unexport each name: no longer mark it for
export. If no NAMEs are supplied, or if the -p option is given,
export displays a list of names of all exported variables on the
standard output. The -p option displays output in a form that
export. If no NAMEs are supplied, or if only the -p option is
given, export displays a list of names of all exported variables
on the standard output. Using -p and -f together displays
exported functions. The -p option displays output in a form that
may be reused as input.
export allows the value of a variable to be set at the same time
@@ -6104,13 +6105,16 @@ Variables::).
HISTFILESIZE
The maximum number of lines contained in the history file. When
this variable is assigned a value, the history file is truncated,
if necessary, to contain no more than that number of lines by
removing the oldest entries. The history file is also truncated to
this size after writing it when a shell exits or by the history
builtin. If the value is 0, the history file is truncated to zero
size. Non-numeric values and numeric values less than zero inhibit
truncation. The shell sets the default value to the value of
HISTSIZE after reading any startup files.
if necessary, to contain no more than the number of history entries
that total no more than that number of lines by removing the oldest
entries. If the history list contains multi-line entries, the
history file may contain more lines than this maximum to avoid
leaving partial history entries. The history file is also
truncated to this size after writing it when a shell exits or by
the history builtin. If the value is 0, the history file is
truncated to zero size. Non-numeric values and numeric values less
than zero inhibit truncation. The shell sets the default value to
the value of HISTSIZE after reading any startup files.
HISTIGNORE
A colon-separated list of patterns used to decide which command
@@ -12825,7 +12829,7 @@ D.1 Index of Shell Builtin Commands
* .: Bourne Shell Builtins.
(line 17)
* [: Bourne Shell Builtins.
(line 338)
(line 339)
* alias: Bash Builtins. (line 11)
* bg: Job Control Builtins.
(line 7)
@@ -12861,15 +12865,15 @@ D.1 Index of Shell Builtin Commands
* export: Bourne Shell Builtins.
(line 152)
* false: Bourne Shell Builtins.
(line 174)
(line 175)
* fc: Bash History Builtins.
(line 10)
* fg: Job Control Builtins.
(line 17)
* getopts: Bourne Shell Builtins.
(line 179)
(line 180)
* hash: Bourne Shell Builtins.
(line 231)
(line 232)
* help: Bash Builtins. (line 375)
* history: Bash History Builtins.
(line 59)
@@ -12885,38 +12889,38 @@ D.1 Index of Shell Builtin Commands
(line 37)
* printf: Bash Builtins. (line 488)
* pushd: Directory Stack Builtins.
(line 70)
(line 71)
* pwd: Bourne Shell Builtins.
(line 263)
(line 264)
* read: Bash Builtins. (line 558)
* readarray: Bash Builtins. (line 669)
* readonly: Bourne Shell Builtins.
(line 275)
(line 276)
* return: Bourne Shell Builtins.
(line 300)
(line 301)
* set: The Set Builtin. (line 11)
* shift: Bourne Shell Builtins.
(line 325)
(line 326)
* shopt: The Shopt Builtin. (line 9)
* source: Bash Builtins. (line 678)
* suspend: Job Control Builtins.
(line 139)
* test: Bourne Shell Builtins.
(line 338)
(line 339)
* times: Bourne Shell Builtins.
(line 438)
(line 439)
* trap: Bourne Shell Builtins.
(line 444)
(line 445)
* true: Bourne Shell Builtins.
(line 510)
(line 511)
* type: Bash Builtins. (line 683)
* typeset: Bash Builtins. (line 720)
* ulimit: Bash Builtins. (line 726)
* umask: Bourne Shell Builtins.
(line 515)
(line 516)
* unalias: Bash Builtins. (line 834)
* unset: Bourne Shell Builtins.
(line 533)
(line 534)
* wait: Job Control Builtins.
(line 86)
@@ -13093,51 +13097,51 @@ D.3 Parameter and Variable Index
* HISTCONTROL: Bash Variables. (line 443)
* HISTFILE: Bash Variables. (line 461)
* HISTFILESIZE: Bash Variables. (line 467)
* HISTIGNORE: Bash Variables. (line 478)
* HISTIGNORE: Bash Variables. (line 481)
* history-preserve-point: Readline Init File Syntax.
(line 234)
* history-size: Readline Init File Syntax.
(line 240)
* HISTSIZE: Bash Variables. (line 502)
* HISTTIMEFORMAT: Bash Variables. (line 509)
* HISTSIZE: Bash Variables. (line 505)
* HISTTIMEFORMAT: Bash Variables. (line 512)
* HOME: Bourne Shell Variables.
(line 13)
* horizontal-scroll-mode: Readline Init File Syntax.
(line 250)
* HOSTFILE: Bash Variables. (line 518)
* HOSTNAME: Bash Variables. (line 529)
* HOSTTYPE: Bash Variables. (line 532)
* HOSTFILE: Bash Variables. (line 521)
* HOSTNAME: Bash Variables. (line 532)
* HOSTTYPE: Bash Variables. (line 535)
* IFS: Bourne Shell Variables.
(line 18)
* IGNOREEOF: Bash Variables. (line 535)
* IGNOREEOF: Bash Variables. (line 538)
* input-meta: Readline Init File Syntax.
(line 258)
* INPUTRC: Bash Variables. (line 544)
* INSIDE_EMACS: Bash Variables. (line 548)
* INPUTRC: Bash Variables. (line 547)
* INSIDE_EMACS: Bash Variables. (line 551)
* isearch-terminators: Readline Init File Syntax.
(line 269)
* keymap: Readline Init File Syntax.
(line 276)
* LANG: Creating Internationalized Scripts.
(line 51)
* LANG <1>: Bash Variables. (line 554)
* LC_ALL: Bash Variables. (line 558)
* LC_COLLATE: Bash Variables. (line 562)
* LC_CTYPE: Bash Variables. (line 569)
* LANG <1>: Bash Variables. (line 557)
* LC_ALL: Bash Variables. (line 561)
* LC_COLLATE: Bash Variables. (line 565)
* LC_CTYPE: Bash Variables. (line 572)
* LC_MESSAGES: Creating Internationalized Scripts.
(line 51)
* LC_MESSAGES <1>: Bash Variables. (line 574)
* LC_NUMERIC: Bash Variables. (line 578)
* LC_TIME: Bash Variables. (line 582)
* LINENO: Bash Variables. (line 586)
* LINES: Bash Variables. (line 593)
* MACHTYPE: Bash Variables. (line 599)
* LC_MESSAGES <1>: Bash Variables. (line 577)
* LC_NUMERIC: Bash Variables. (line 581)
* LC_TIME: Bash Variables. (line 585)
* LINENO: Bash Variables. (line 589)
* LINES: Bash Variables. (line 596)
* MACHTYPE: Bash Variables. (line 602)
* MAIL: Bourne Shell Variables.
(line 24)
* MAILCHECK: Bash Variables. (line 603)
* MAILCHECK: Bash Variables. (line 606)
* MAILPATH: Bourne Shell Variables.
(line 29)
* MAPFILE: Bash Variables. (line 611)
* MAPFILE: Bash Variables. (line 614)
* mark-modified-lines: Readline Init File Syntax.
(line 306)
* mark-symlinked-directories: Readline Init File Syntax.
@@ -13148,46 +13152,46 @@ D.3 Parameter and Variable Index
(line 323)
* meta-flag: Readline Init File Syntax.
(line 258)
* OLDPWD: Bash Variables. (line 615)
* OLDPWD: Bash Variables. (line 618)
* OPTARG: Bourne Shell Variables.
(line 36)
* OPTERR: Bash Variables. (line 618)
* OPTERR: Bash Variables. (line 621)
* OPTIND: Bourne Shell Variables.
(line 40)
* OSTYPE: Bash Variables. (line 623)
* OSTYPE: Bash Variables. (line 626)
* output-meta: Readline Init File Syntax.
(line 328)
* page-completions: Readline Init File Syntax.
(line 337)
* PATH: Bourne Shell Variables.
(line 44)
* PIPESTATUS: Bash Variables. (line 626)
* POSIXLY_CORRECT: Bash Variables. (line 636)
* PPID: Bash Variables. (line 646)
* PROMPT_COMMAND: Bash Variables. (line 650)
* PROMPT_DIRTRIM: Bash Variables. (line 656)
* PS0: Bash Variables. (line 662)
* PIPESTATUS: Bash Variables. (line 629)
* POSIXLY_CORRECT: Bash Variables. (line 639)
* PPID: Bash Variables. (line 649)
* PROMPT_COMMAND: Bash Variables. (line 653)
* PROMPT_DIRTRIM: Bash Variables. (line 659)
* PS0: Bash Variables. (line 665)
* PS1: Bourne Shell Variables.
(line 53)
* PS2: Bourne Shell Variables.
(line 58)
* PS3: Bash Variables. (line 667)
* PS4: Bash Variables. (line 672)
* PWD: Bash Variables. (line 680)
* RANDOM: Bash Variables. (line 683)
* READLINE_ARGUMENT: Bash Variables. (line 691)
* READLINE_LINE: Bash Variables. (line 695)
* READLINE_MARK: Bash Variables. (line 699)
* READLINE_POINT: Bash Variables. (line 705)
* REPLY: Bash Variables. (line 709)
* PS3: Bash Variables. (line 670)
* PS4: Bash Variables. (line 675)
* PWD: Bash Variables. (line 683)
* RANDOM: Bash Variables. (line 686)
* READLINE_ARGUMENT: Bash Variables. (line 694)
* READLINE_LINE: Bash Variables. (line 698)
* READLINE_MARK: Bash Variables. (line 702)
* READLINE_POINT: Bash Variables. (line 708)
* REPLY: Bash Variables. (line 712)
* revert-all-at-newline: Readline Init File Syntax.
(line 350)
* search-ignore-case: Readline Init File Syntax.
(line 357)
* SECONDS: Bash Variables. (line 713)
* SHELL: Bash Variables. (line 723)
* SHELLOPTS: Bash Variables. (line 728)
* SHLVL: Bash Variables. (line 738)
* SECONDS: Bash Variables. (line 716)
* SHELL: Bash Variables. (line 726)
* SHELLOPTS: Bash Variables. (line 731)
* SHLVL: Bash Variables. (line 741)
* show-all-if-ambiguous: Readline Init File Syntax.
(line 362)
* show-all-if-unmodified: Readline Init File Syntax.
@@ -13196,15 +13200,15 @@ D.3 Parameter and Variable Index
(line 377)
* skip-completed-text: Readline Init File Syntax.
(line 383)
* SRANDOM: Bash Variables. (line 743)
* SRANDOM: Bash Variables. (line 746)
* TEXTDOMAIN: Creating Internationalized Scripts.
(line 51)
* TEXTDOMAINDIR: Creating Internationalized Scripts.
(line 51)
* TIMEFORMAT: Bash Variables. (line 752)
* TMOUT: Bash Variables. (line 791)
* TMPDIR: Bash Variables. (line 803)
* UID: Bash Variables. (line 807)
* TIMEFORMAT: Bash Variables. (line 755)
* TMOUT: Bash Variables. (line 794)
* TMPDIR: Bash Variables. (line 806)
* UID: Bash Variables. (line 810)
* vi-cmd-mode-string: Readline Init File Syntax.
(line 396)
* vi-ins-mode-string: Readline Init File Syntax.
@@ -13599,138 +13603,138 @@ D.5 Concept Index

Tag Table:
Node: Top901
Node: Introduction2842
Node: What is Bash?3055
Node: What is a shell?4188
Node: Definitions6798
Node: Basic Shell Features10125
Node: Shell Syntax11349
Node: Shell Operation12376
Node: Quoting13667
Node: Escape Character15005
Node: Single Quotes15540
Node: Double Quotes15889
Node: ANSI-C Quoting17234
Node: Locale Translation18628
Node: Creating Internationalized Scripts20031
Node: Comments24229
Node: Shell Commands24996
Node: Reserved Words25935
Node: Simple Commands26800
Node: Pipelines27462
Node: Lists30718
Node: Compound Commands32590
Node: Looping Constructs33599
Node: Conditional Constructs36148
Node: Command Grouping51218
Node: Coprocesses52710
Node: GNU Parallel55396
Node: Shell Functions56314
Node: Shell Parameters64762
Node: Positional Parameters69663
Node: Special Parameters70753
Node: Shell Expansions74214
Node: Brace Expansion76403
Node: Tilde Expansion79739
Node: Shell Parameter Expansion82694
Node: Command Substitution103337
Node: Arithmetic Expansion106866
Node: Process Substitution108042
Node: Word Splitting109150
Node: Filename Expansion111594
Node: Pattern Matching114818
Node: Quote Removal120541
Node: Redirections120845
Node: Executing Commands131108
Node: Simple Command Expansion131775
Node: Command Search and Execution133883
Node: Command Execution Environment136327
Node: Environment139775
Node: Exit Status141678
Node: Signals143736
Node: Shell Scripts148665
Node: Shell Builtin Commands151963
Node: Bourne Shell Builtins154074
Node: Bash Builtins180644
Node: Modifying Shell Behavior217568
Node: The Set Builtin217910
Node: The Shopt Builtin229904
Node: Special Builtins246956
Node: Shell Variables247945
Node: Bourne Shell Variables248379
Node: Bash Variables250887
Node: Bash Features289792
Node: Invoking Bash290806
Node: Bash Startup Files297390
Node: Interactive Shells302632
Node: What is an Interactive Shell?303040
Node: Is this Shell Interactive?303702
Node: Interactive Shell Behavior304526
Node: Bash Conditional Expressions308287
Node: Shell Arithmetic313704
Node: Aliases317033
Node: Arrays320167
Node: The Directory Stack327755
Node: Directory Stack Builtins328552
Node: Controlling the Prompt332997
Node: The Restricted Shell335882
Node: Bash POSIX Mode338764
Node: Shell Compatibility Mode357121
Node: Job Control366128
Node: Job Control Basics366585
Node: Job Control Builtins372953
Node: Job Control Variables379635
Node: Command Line Editing380866
Node: Introduction and Notation382569
Node: Readline Interaction384921
Node: Readline Bare Essentials386109
Node: Readline Movement Commands387917
Node: Readline Killing Commands388913
Node: Readline Arguments390936
Node: Searching391993
Node: Readline Init File394236
Node: Readline Init File Syntax395539
Node: Conditional Init Constructs422364
Node: Sample Init File426749
Node: Bindable Readline Commands429869
Node: Commands For Moving431407
Node: Commands For History433871
Node: Commands For Text439261
Node: Commands For Killing443386
Node: Numeric Arguments446174
Node: Commands For Completion447326
Node: Keyboard Macros453022
Node: Miscellaneous Commands453723
Node: Readline vi Mode460290
Node: Programmable Completion461267
Node: Programmable Completion Builtins470004
Node: A Programmable Completion Example481741
Node: Using History Interactively487086
Node: Bash History Facilities487767
Node: Bash History Builtins491502
Node: History Interaction497973
Node: Event Designators502923
Node: Word Designators504501
Node: Modifiers506893
Node: Installing Bash508830
Node: Basic Installation509946
Node: Compilers and Options513822
Node: Compiling For Multiple Architectures514572
Node: Installation Names516325
Node: Specifying the System Type518559
Node: Sharing Defaults519305
Node: Operation Controls520019
Node: Optional Features521038
Node: Reporting Bugs533418
Node: Major Differences From The Bourne Shell534775
Node: GNU Free Documentation License556201
Node: Indexes581378
Node: Builtin Index581829
Node: Reserved Word Index588927
Node: Variable Index591372
Node: Function Index608785
Node: Concept Index622780
Node: Top893
Node: Introduction2826
Node: What is Bash?3039
Node: What is a shell?4172
Node: Definitions6782
Node: Basic Shell Features10109
Node: Shell Syntax11333
Node: Shell Operation12360
Node: Quoting13651
Node: Escape Character14989
Node: Single Quotes15524
Node: Double Quotes15873
Node: ANSI-C Quoting17218
Node: Locale Translation18612
Node: Creating Internationalized Scripts20015
Node: Comments24213
Node: Shell Commands24980
Node: Reserved Words25919
Node: Simple Commands26784
Node: Pipelines27446
Node: Lists30702
Node: Compound Commands32574
Node: Looping Constructs33583
Node: Conditional Constructs36132
Node: Command Grouping51202
Node: Coprocesses52694
Node: GNU Parallel55380
Node: Shell Functions56298
Node: Shell Parameters64746
Node: Positional Parameters69647
Node: Special Parameters70737
Node: Shell Expansions74198
Node: Brace Expansion76387
Node: Tilde Expansion79723
Node: Shell Parameter Expansion82678
Node: Command Substitution103321
Node: Arithmetic Expansion106850
Node: Process Substitution108026
Node: Word Splitting109134
Node: Filename Expansion111578
Node: Pattern Matching114802
Node: Quote Removal120525
Node: Redirections120829
Node: Executing Commands131092
Node: Simple Command Expansion131759
Node: Command Search and Execution133867
Node: Command Execution Environment136311
Node: Environment139759
Node: Exit Status141662
Node: Signals143720
Node: Shell Scripts148649
Node: Shell Builtin Commands151947
Node: Bourne Shell Builtins154058
Node: Bash Builtins180705
Node: Modifying Shell Behavior217629
Node: The Set Builtin217971
Node: The Shopt Builtin229965
Node: Special Builtins247017
Node: Shell Variables248006
Node: Bourne Shell Variables248440
Node: Bash Variables250948
Node: Bash Features290072
Node: Invoking Bash291086
Node: Bash Startup Files297670
Node: Interactive Shells302912
Node: What is an Interactive Shell?303320
Node: Is this Shell Interactive?303982
Node: Interactive Shell Behavior304806
Node: Bash Conditional Expressions308567
Node: Shell Arithmetic313984
Node: Aliases317313
Node: Arrays320447
Node: The Directory Stack328035
Node: Directory Stack Builtins328832
Node: Controlling the Prompt333277
Node: The Restricted Shell336162
Node: Bash POSIX Mode339044
Node: Shell Compatibility Mode357401
Node: Job Control366408
Node: Job Control Basics366865
Node: Job Control Builtins373233
Node: Job Control Variables379915
Node: Command Line Editing381146
Node: Introduction and Notation382849
Node: Readline Interaction385201
Node: Readline Bare Essentials386389
Node: Readline Movement Commands388197
Node: Readline Killing Commands389193
Node: Readline Arguments391216
Node: Searching392273
Node: Readline Init File394516
Node: Readline Init File Syntax395819
Node: Conditional Init Constructs422644
Node: Sample Init File427029
Node: Bindable Readline Commands430149
Node: Commands For Moving431687
Node: Commands For History434151
Node: Commands For Text439541
Node: Commands For Killing443666
Node: Numeric Arguments446454
Node: Commands For Completion447606
Node: Keyboard Macros453302
Node: Miscellaneous Commands454003
Node: Readline vi Mode460570
Node: Programmable Completion461547
Node: Programmable Completion Builtins470284
Node: A Programmable Completion Example482021
Node: Using History Interactively487366
Node: Bash History Facilities488047
Node: Bash History Builtins491782
Node: History Interaction498253
Node: Event Designators503203
Node: Word Designators504781
Node: Modifiers507173
Node: Installing Bash509110
Node: Basic Installation510226
Node: Compilers and Options514102
Node: Compiling For Multiple Architectures514852
Node: Installation Names516605
Node: Specifying the System Type518839
Node: Sharing Defaults519585
Node: Operation Controls520299
Node: Optional Features521318
Node: Reporting Bugs533698
Node: Major Differences From The Bourne Shell535055
Node: GNU Free Documentation License556481
Node: Indexes581658
Node: Builtin Index582109
Node: Reserved Word Index589207
Node: Variable Index591652
Node: Function Index609065
Node: Concept Index623060

End Tag Table