mirror of
https://https.git.savannah.gnu.org/git/bash.git
synced 2026-07-07 04:10:49 +02:00
man page typesetting updates for compatibilityand layout issues
This commit is contained in:
Chet Ramey
@@ -9038,3 +9038,16 @@ parse.y,externs.h
|
||||
parse.y,print_cmd.c,eval.c,subst.c
|
||||
- decode_prompt_string: changed all callers
|
||||
|
||||
|
||||
3/29
|
||||
----
|
||||
|
||||
doc/bash.1,lib/readline/doc/readline.3,lib/readline/doc/history.3
|
||||
- fix some font-setting directives
|
||||
- fix some word breaks for font-changing macros
|
||||
|
||||
lib/readline/doc/history.3
|
||||
- fix the macros for function signatures for AT&T troff limitations
|
||||
- fix some paragraph spacing and other layout/spacing/hyphenation
|
||||
issues
|
||||
Fixes from G. Branden Robinson <g.branden.robinson@gmail.com>
|
||||
|
||||
+2309
-2309
File diff suppressed because it is too large
Load Diff
+28
-25
@@ -5,14 +5,14 @@
|
||||
.\" Case Western Reserve University
|
||||
.\" chet.ramey@case.edu
|
||||
.\"
|
||||
.\" Last Change: Mon Mar 25 10:56:35 EDT 2024
|
||||
.\" Last Change: Fri Mar 29 11:54:22 EDT 2024
|
||||
.\"
|
||||
.\" bash_builtins, strip all but Built-Ins section
|
||||
.\" avoid a warning about an undefined register
|
||||
.\" .if !rzY .nr zY 0
|
||||
.if \n(zZ=1 .ig zZ
|
||||
.if \n(zY=1 .ig zY
|
||||
.TH BASH 1 "2024 March 25" "GNU Bash 5.3"
|
||||
.TH BASH 1 "2024 March 29" "GNU Bash 5.3"
|
||||
.\"
|
||||
.\" There's some problem with having a `@'
|
||||
.\" in a tagged paragraph with the BSD man macros.
|
||||
@@ -47,6 +47,7 @@
|
||||
.\}
|
||||
.el \{\
|
||||
.ds ' '
|
||||
.\" not usable in macro arguments on AT&T troff (DWB, Solaris 10)
|
||||
.ds " ""\" two adjacent quotes and no space before this comment
|
||||
.ds ^ ^
|
||||
.ds ~ ~
|
||||
@@ -89,12 +90,13 @@ bash \- GNU Bourne-Again SHell
|
||||
.if t Bash is Copyright \(co 1989-2023 by the Free Software Foundation, Inc.
|
||||
.SH DESCRIPTION
|
||||
.B Bash
|
||||
is an \fBsh\fR-compatible command language interpreter that
|
||||
is an \fBsh\fP-compatible command language interpreter that
|
||||
executes commands read from the standard input or from a file.
|
||||
.B Bash
|
||||
also incorporates useful features from the \fIKorn\fP and \fIC\fP
|
||||
shells (\fBksh\fP and \fBcsh\fP).
|
||||
.PP
|
||||
POSIX is the name for a family of computing standards based on Unix.
|
||||
.B Bash
|
||||
is intended to be a conformant implementation of the
|
||||
Shell and Utilities portion of the IEEE POSIX specification
|
||||
@@ -103,9 +105,9 @@ Shell and Utilities portion of the IEEE POSIX specification
|
||||
can be configured to be POSIX-conformant by default.
|
||||
.SH OPTIONS
|
||||
All of the single-character shell options documented in the
|
||||
description of the \fBset\fR builtin command, including \fB\-o\fP,
|
||||
description of the \fBset\fP builtin command, including \fB\-o\fP,
|
||||
can be used as options when the shell is invoked.
|
||||
In addition, \fBbash\fR
|
||||
In addition, \fBbash\fP
|
||||
interprets the following options when it is invoked:
|
||||
.PP
|
||||
.PD 0
|
||||
@@ -3030,7 +3032,7 @@ words. The shell performs these expansions:
|
||||
.IR "word splitting" ,
|
||||
.IR "pathname expansion" ,
|
||||
and
|
||||
.IR "quote removal .
|
||||
.IR "quote removal" .
|
||||
.PP
|
||||
The order of expansions is:
|
||||
brace expansion;
|
||||
@@ -3919,8 +3921,8 @@ is unset, word splitting behaves as if it contained the default value
|
||||
of
|
||||
.BR <space><tab><newline> .
|
||||
.PP
|
||||
Explicit null arguments (\^\f3\*"\^\*"\fP or
|
||||
\^\f3\*'\^\*'\fP\^) are retained
|
||||
Explicit null arguments (\^\fB\*"\^\*"\fP or
|
||||
\^\fB\*'\^\*'\fP\^) are retained
|
||||
and passed to commands as empty strings.
|
||||
Unquoted implicit null arguments, resulting from the expansion of
|
||||
parameters that have no values, are removed.
|
||||
@@ -4245,7 +4247,7 @@ After the preceding expansions, all unquoted occurrences of the
|
||||
characters
|
||||
.BR \e ,
|
||||
.BR \*' ,
|
||||
and \^\f3\*"\fP\^ that did not result from one of the above
|
||||
and \^\fB\*"\fP\^ that did not result from one of the above
|
||||
expansions are removed.
|
||||
.SH REDIRECTION
|
||||
Before a command is executed, its input and output
|
||||
@@ -5959,11 +5961,12 @@ options to the
|
||||
builtin.
|
||||
.SS "Readline Notation"
|
||||
In this section, the Emacs-style notation is used to denote
|
||||
keystrokes. Control keys are denoted by C\-\fIkey\fR, e.g., C\-n
|
||||
means Control\-N. Similarly,
|
||||
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\fR, so M\-x means Meta\-X. (On keyboards
|
||||
without a
|
||||
keys are denoted by M\-\fIkey\fP, so M\-x means Meta\-X.
|
||||
(On keyboards without a
|
||||
.I meta
|
||||
key, M\-\fIx\fP means ESC \fIx\fP, i.e., press the Escape key
|
||||
then the
|
||||
@@ -6300,7 +6303,7 @@ environment variable.
|
||||
.\" finesse. We require `\c`, and while the single-font macros don't
|
||||
.\" honor input trap continuation, the font alternation macros do.
|
||||
.TP
|
||||
.BR comment\-begin\ (\c
|
||||
.BR comment\-begin\ ( \c
|
||||
.Q \fB#\fP \fB)\fP
|
||||
The string that is inserted when the readline
|
||||
.B insert\-comment
|
||||
@@ -6452,7 +6455,7 @@ locale contains eight-bit characters.
|
||||
This variable is dependent on the \fBLC_CTYPE\fP locale category, and
|
||||
may change if the locale is changed.
|
||||
.TP
|
||||
.BR isearch\-terminators\ (\c
|
||||
.BR isearch\-terminators\ ( \c
|
||||
.Q \fBC\-[C\-J\fP \fB)\fP
|
||||
The string of characters that should terminate an incremental
|
||||
search without subsequently executing the character as a command.
|
||||
@@ -7839,11 +7842,11 @@ newline, carriage return, =
|
||||
or ( (when the \fBextglob\fP shell option is enabled using
|
||||
the \fBshopt\fP builtin).
|
||||
.TP
|
||||
.B !\fIn\fR
|
||||
.B !\fIn\fP
|
||||
Refer to command line
|
||||
.IR n .
|
||||
.TP
|
||||
.B !\-\fIn\fR
|
||||
.B !\-\fIn\fP
|
||||
Refer to the current command minus
|
||||
.IR n .
|
||||
.TP
|
||||
@@ -7851,12 +7854,12 @@ Refer to the current command minus
|
||||
Refer to the previous command. This is a synonym for
|
||||
.Q !\-1 .
|
||||
.TP
|
||||
.B !\fIstring\fR
|
||||
.B !\fIstring\fP
|
||||
Refer to the most recent command preceding the current position in the
|
||||
history list starting with
|
||||
.IR string .
|
||||
.TP
|
||||
.B !?\fIstring\fR\fB[?]\fR
|
||||
.B !?\fIstring\fR\fB[?]\fP
|
||||
Refer to the most recent command preceding the current position in the
|
||||
history list containing
|
||||
.IR string .
|
||||
@@ -7901,7 +7904,7 @@ The zeroth word. For the shell, this is the command
|
||||
word.
|
||||
.TP
|
||||
.I n
|
||||
The \fIn\fRth word.
|
||||
The \fIn\fPth word.
|
||||
.TP
|
||||
.B \*^
|
||||
The first argument. That is, word 1.
|
||||
@@ -7912,15 +7915,15 @@ zeroth word if there is only one word in the line.
|
||||
.TP
|
||||
.B %
|
||||
The first word matched by the most recent
|
||||
.Q ?\fIstring\fR?'
|
||||
.Q ?\fIstring\fP?'
|
||||
search,
|
||||
if the search string begins with a character that is part of a word.
|
||||
.TP
|
||||
.I x\fB\-\fPy
|
||||
A range of words;
|
||||
.Q \-\fIy\fR
|
||||
.Q \-\fIy\fP
|
||||
abbreviates
|
||||
.Q 0\-\fIy\fR .
|
||||
.Q 0\-\fIy\fP .
|
||||
.TP
|
||||
.B *
|
||||
All of the words but the zeroth.
|
||||
@@ -8003,7 +8006,7 @@ substituted, or, if no previous history substitutions took place,
|
||||
the last
|
||||
.I string
|
||||
in a
|
||||
.B !?\fIstring\fR\fB[?]\fR
|
||||
.B !?\fIstring\fP[?]
|
||||
search.
|
||||
If
|
||||
.I new
|
||||
@@ -12285,7 +12288,7 @@ ALL bug reports should include:
|
||||
.PP
|
||||
.PD 0
|
||||
.TP 20
|
||||
The version number of \fBbash\fR
|
||||
The version number of \fBbash\fP
|
||||
.TP
|
||||
The hardware and operating system
|
||||
.TP
|
||||
|
||||
+138
-137
@@ -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, 19 February 2024).
|
||||
Bash shell (version 5.3, 25 March 2024).
|
||||
|
||||
This is Edition 5.3, last updated 19 February 2024, of ‘The GNU Bash
|
||||
This is Edition 5.3, last updated 25 March 2024, of ‘The GNU Bash
|
||||
Reference Manual’, for ‘Bash’, Version 5.3.
|
||||
|
||||
Copyright © 1988-2023 Free Software Foundation, Inc.
|
||||
@@ -26,10 +26,10 @@ Bash Features
|
||||
*************
|
||||
|
||||
This text is a brief description of the features that are present in the
|
||||
Bash shell (version 5.3, 19 February 2024). The Bash home page is
|
||||
Bash shell (version 5.3, 25 March 2024). The Bash home page is
|
||||
<http://www.gnu.org/software/bash/>.
|
||||
|
||||
This is Edition 5.3, last updated 19 February 2024, of ‘The GNU Bash
|
||||
This is Edition 5.3, last updated 25 March 2024, of ‘The GNU Bash
|
||||
Reference Manual’, for ‘Bash’, Version 5.3.
|
||||
|
||||
Bash contains features that appear in other popular shells, and some
|
||||
@@ -2218,7 +2218,8 @@ omitted, the operator tests only for existence.
|
||||
Produces a possibly-quoted version of the value of PARAMETER,
|
||||
except that it prints the values of indexed and associative
|
||||
arrays as a sequence of quoted key-value pairs (*note
|
||||
Arrays::).
|
||||
Arrays::). The keys and values are quoted in a format that
|
||||
can be reused as input.
|
||||
‘a’
|
||||
The expansion is a string consisting of flag values
|
||||
representing PARAMETER's attributes.
|
||||
@@ -12923,138 +12924,138 @@ D.5 Concept Index
|
||||
|
||||
|
||||
Tag Table:
|
||||
Node: Top901
|
||||
Node: Introduction2842
|
||||
Node: What is Bash?3055
|
||||
Node: What is a shell?4196
|
||||
Node: Definitions6775
|
||||
Node: Basic Shell Features9951
|
||||
Node: Shell Syntax11171
|
||||
Node: Shell Operation12198
|
||||
Node: Quoting13496
|
||||
Node: Escape Character14809
|
||||
Node: Single Quotes15307
|
||||
Node: Double Quotes15656
|
||||
Node: ANSI-C Quoting16999
|
||||
Node: Locale Translation18384
|
||||
Node: Creating Internationalized Scripts19728
|
||||
Node: Comments23926
|
||||
Node: Shell Commands24561
|
||||
Node: Reserved Words25500
|
||||
Node: Simple Commands26365
|
||||
Node: Pipelines27024
|
||||
Node: Lists30087
|
||||
Node: Compound Commands31959
|
||||
Node: Looping Constructs32968
|
||||
Node: Conditional Constructs35512
|
||||
Node: Command Grouping50416
|
||||
Node: Coprocesses51903
|
||||
Node: GNU Parallel54599
|
||||
Node: Shell Functions55517
|
||||
Node: Shell Parameters63623
|
||||
Node: Positional Parameters68156
|
||||
Node: Special Parameters69091
|
||||
Node: Shell Expansions72398
|
||||
Node: Brace Expansion74587
|
||||
Node: Tilde Expansion77250
|
||||
Node: Shell Parameter Expansion80016
|
||||
Node: Command Substitution99040
|
||||
Node: Arithmetic Expansion102573
|
||||
Node: Process Substitution103538
|
||||
Node: Word Splitting104675
|
||||
Node: Filename Expansion106816
|
||||
Node: Pattern Matching109912
|
||||
Node: Quote Removal115145
|
||||
Node: Redirections115449
|
||||
Node: Executing Commands125258
|
||||
Node: Simple Command Expansion125925
|
||||
Node: Command Search and Execution128036
|
||||
Node: Command Execution Environment130444
|
||||
Node: Environment133753
|
||||
Node: Exit Status135457
|
||||
Node: Signals137242
|
||||
Node: Shell Scripts140856
|
||||
Node: Shell Builtin Commands143948
|
||||
Node: Bourne Shell Builtins146059
|
||||
Node: Bash Builtins170463
|
||||
Node: Modifying Shell Behavior205068
|
||||
Node: The Set Builtin205410
|
||||
Node: The Shopt Builtin216925
|
||||
Node: Special Builtins233661
|
||||
Node: Shell Variables234650
|
||||
Node: Bourne Shell Variables235084
|
||||
Node: Bash Variables237277
|
||||
Node: Bash Features273827
|
||||
Node: Invoking Bash274841
|
||||
Node: Bash Startup Files281240
|
||||
Node: Interactive Shells286552
|
||||
Node: What is an Interactive Shell?286960
|
||||
Node: Is this Shell Interactive?287626
|
||||
Node: Interactive Shell Behavior288450
|
||||
Node: Bash Conditional Expressions292204
|
||||
Node: Shell Arithmetic297378
|
||||
Node: Aliases300460
|
||||
Node: Arrays303415
|
||||
Node: The Directory Stack310214
|
||||
Node: Directory Stack Builtins311011
|
||||
Node: Controlling the Prompt315460
|
||||
Node: The Restricted Shell318598
|
||||
Node: Bash POSIX Mode321385
|
||||
Node: Shell Compatibility Mode338866
|
||||
Node: Job Control347352
|
||||
Node: Job Control Basics347809
|
||||
Node: Job Control Builtins352983
|
||||
Node: Job Control Variables358943
|
||||
Node: Command Line Editing360120
|
||||
Node: Introduction and Notation361824
|
||||
Node: Readline Interaction363468
|
||||
Node: Readline Bare Essentials364656
|
||||
Node: Readline Movement Commands366474
|
||||
Node: Readline Killing Commands367471
|
||||
Node: Readline Arguments369449
|
||||
Node: Searching370506
|
||||
Node: Readline Init File372735
|
||||
Node: Readline Init File Syntax374017
|
||||
Node: Conditional Init Constructs398955
|
||||
Node: Sample Init File403320
|
||||
Node: Bindable Readline Commands406441
|
||||
Node: Commands For Moving407666
|
||||
Node: Commands For History409766
|
||||
Node: Commands For Text414849
|
||||
Node: Commands For Killing418924
|
||||
Node: Numeric Arguments421725
|
||||
Node: Commands For Completion422877
|
||||
Node: Keyboard Macros427193
|
||||
Node: Miscellaneous Commands427894
|
||||
Node: Readline vi Mode434548
|
||||
Node: Programmable Completion435500
|
||||
Node: Programmable Completion Builtins443457
|
||||
Node: A Programmable Completion Example455023
|
||||
Node: Using History Interactively460368
|
||||
Node: Bash History Facilities461049
|
||||
Node: Bash History Builtins464161
|
||||
Node: History Interaction469404
|
||||
Node: Event Designators473729
|
||||
Node: Word Designators475312
|
||||
Node: Modifiers477298
|
||||
Node: Installing Bash479207
|
||||
Node: Basic Installation480341
|
||||
Node: Compilers and Options484220
|
||||
Node: Compiling For Multiple Architectures484970
|
||||
Node: Installation Names486719
|
||||
Node: Specifying the System Type488953
|
||||
Node: Sharing Defaults489699
|
||||
Node: Operation Controls490413
|
||||
Node: Optional Features491432
|
||||
Node: Reporting Bugs503234
|
||||
Node: Major Differences From The Bourne Shell504583
|
||||
Node: GNU Free Documentation License522392
|
||||
Node: Indexes547569
|
||||
Node: Builtin Index548020
|
||||
Node: Reserved Word Index555118
|
||||
Node: Variable Index557563
|
||||
Node: Function Index574694
|
||||
Node: Concept Index588550
|
||||
Node: Top895
|
||||
Node: Introduction2830
|
||||
Node: What is Bash?3043
|
||||
Node: What is a shell?4184
|
||||
Node: Definitions6763
|
||||
Node: Basic Shell Features9939
|
||||
Node: Shell Syntax11159
|
||||
Node: Shell Operation12186
|
||||
Node: Quoting13484
|
||||
Node: Escape Character14797
|
||||
Node: Single Quotes15295
|
||||
Node: Double Quotes15644
|
||||
Node: ANSI-C Quoting16987
|
||||
Node: Locale Translation18372
|
||||
Node: Creating Internationalized Scripts19716
|
||||
Node: Comments23914
|
||||
Node: Shell Commands24549
|
||||
Node: Reserved Words25488
|
||||
Node: Simple Commands26353
|
||||
Node: Pipelines27012
|
||||
Node: Lists30075
|
||||
Node: Compound Commands31947
|
||||
Node: Looping Constructs32956
|
||||
Node: Conditional Constructs35500
|
||||
Node: Command Grouping50404
|
||||
Node: Coprocesses51891
|
||||
Node: GNU Parallel54587
|
||||
Node: Shell Functions55505
|
||||
Node: Shell Parameters63611
|
||||
Node: Positional Parameters68144
|
||||
Node: Special Parameters69079
|
||||
Node: Shell Expansions72386
|
||||
Node: Brace Expansion74575
|
||||
Node: Tilde Expansion77238
|
||||
Node: Shell Parameter Expansion80004
|
||||
Node: Command Substitution99111
|
||||
Node: Arithmetic Expansion102644
|
||||
Node: Process Substitution103609
|
||||
Node: Word Splitting104746
|
||||
Node: Filename Expansion106887
|
||||
Node: Pattern Matching109983
|
||||
Node: Quote Removal115216
|
||||
Node: Redirections115520
|
||||
Node: Executing Commands125329
|
||||
Node: Simple Command Expansion125996
|
||||
Node: Command Search and Execution128107
|
||||
Node: Command Execution Environment130515
|
||||
Node: Environment133824
|
||||
Node: Exit Status135528
|
||||
Node: Signals137313
|
||||
Node: Shell Scripts140927
|
||||
Node: Shell Builtin Commands144019
|
||||
Node: Bourne Shell Builtins146130
|
||||
Node: Bash Builtins170534
|
||||
Node: Modifying Shell Behavior205139
|
||||
Node: The Set Builtin205481
|
||||
Node: The Shopt Builtin216996
|
||||
Node: Special Builtins233732
|
||||
Node: Shell Variables234721
|
||||
Node: Bourne Shell Variables235155
|
||||
Node: Bash Variables237348
|
||||
Node: Bash Features273898
|
||||
Node: Invoking Bash274912
|
||||
Node: Bash Startup Files281311
|
||||
Node: Interactive Shells286623
|
||||
Node: What is an Interactive Shell?287031
|
||||
Node: Is this Shell Interactive?287697
|
||||
Node: Interactive Shell Behavior288521
|
||||
Node: Bash Conditional Expressions292275
|
||||
Node: Shell Arithmetic297449
|
||||
Node: Aliases300531
|
||||
Node: Arrays303486
|
||||
Node: The Directory Stack310285
|
||||
Node: Directory Stack Builtins311082
|
||||
Node: Controlling the Prompt315531
|
||||
Node: The Restricted Shell318669
|
||||
Node: Bash POSIX Mode321456
|
||||
Node: Shell Compatibility Mode338937
|
||||
Node: Job Control347423
|
||||
Node: Job Control Basics347880
|
||||
Node: Job Control Builtins353054
|
||||
Node: Job Control Variables359014
|
||||
Node: Command Line Editing360191
|
||||
Node: Introduction and Notation361895
|
||||
Node: Readline Interaction363539
|
||||
Node: Readline Bare Essentials364727
|
||||
Node: Readline Movement Commands366545
|
||||
Node: Readline Killing Commands367542
|
||||
Node: Readline Arguments369520
|
||||
Node: Searching370577
|
||||
Node: Readline Init File372806
|
||||
Node: Readline Init File Syntax374088
|
||||
Node: Conditional Init Constructs399026
|
||||
Node: Sample Init File403391
|
||||
Node: Bindable Readline Commands406512
|
||||
Node: Commands For Moving407737
|
||||
Node: Commands For History409837
|
||||
Node: Commands For Text414920
|
||||
Node: Commands For Killing418995
|
||||
Node: Numeric Arguments421796
|
||||
Node: Commands For Completion422948
|
||||
Node: Keyboard Macros427264
|
||||
Node: Miscellaneous Commands427965
|
||||
Node: Readline vi Mode434619
|
||||
Node: Programmable Completion435571
|
||||
Node: Programmable Completion Builtins443528
|
||||
Node: A Programmable Completion Example455094
|
||||
Node: Using History Interactively460439
|
||||
Node: Bash History Facilities461120
|
||||
Node: Bash History Builtins464232
|
||||
Node: History Interaction469475
|
||||
Node: Event Designators473800
|
||||
Node: Word Designators475383
|
||||
Node: Modifiers477369
|
||||
Node: Installing Bash479278
|
||||
Node: Basic Installation480412
|
||||
Node: Compilers and Options484291
|
||||
Node: Compiling For Multiple Architectures485041
|
||||
Node: Installation Names486790
|
||||
Node: Specifying the System Type489024
|
||||
Node: Sharing Defaults489770
|
||||
Node: Operation Controls490484
|
||||
Node: Optional Features491503
|
||||
Node: Reporting Bugs503305
|
||||
Node: Major Differences From The Bourne Shell504654
|
||||
Node: GNU Free Documentation License522463
|
||||
Node: Indexes547640
|
||||
Node: Builtin Index548091
|
||||
Node: Reserved Word Index555189
|
||||
Node: Variable Index557634
|
||||
Node: Function Index574765
|
||||
Node: Concept Index588621
|
||||
|
||||
End Tag Table
|
||||
|
||||
|
||||
+138
-137
@@ -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, 19 February 2024).
|
||||
Bash shell (version 5.3, 25 March 2024).
|
||||
|
||||
This is Edition 5.3, last updated 19 February 2024, of ‘The GNU Bash
|
||||
This is Edition 5.3, last updated 25 March 2024, of ‘The GNU Bash
|
||||
Reference Manual’, for ‘Bash’, Version 5.3.
|
||||
|
||||
Copyright © 1988-2023 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, 19 February 2024). The Bash home page is
|
||||
Bash shell (version 5.3, 25 March 2024). The Bash home page is
|
||||
<http://www.gnu.org/software/bash/>.
|
||||
|
||||
This is Edition 5.3, last updated 19 February 2024, of ‘The GNU Bash
|
||||
This is Edition 5.3, last updated 25 March 2024, of ‘The GNU Bash
|
||||
Reference Manual’, for ‘Bash’, Version 5.3.
|
||||
|
||||
Bash contains features that appear in other popular shells, and some
|
||||
@@ -2219,7 +2219,8 @@ omitted, the operator tests only for existence.
|
||||
Produces a possibly-quoted version of the value of PARAMETER,
|
||||
except that it prints the values of indexed and associative
|
||||
arrays as a sequence of quoted key-value pairs (*note
|
||||
Arrays::).
|
||||
Arrays::). The keys and values are quoted in a format that
|
||||
can be reused as input.
|
||||
‘a’
|
||||
The expansion is a string consisting of flag values
|
||||
representing PARAMETER's attributes.
|
||||
@@ -12924,138 +12925,138 @@ D.5 Concept Index
|
||||
|
||||
|
||||
Tag Table:
|
||||
Node: Top904
|
||||
Node: Introduction2848
|
||||
Node: What is Bash?3064
|
||||
Node: What is a shell?4208
|
||||
Node: Definitions6790
|
||||
Node: Basic Shell Features9969
|
||||
Node: Shell Syntax11192
|
||||
Node: Shell Operation12222
|
||||
Node: Quoting13523
|
||||
Node: Escape Character14839
|
||||
Node: Single Quotes15340
|
||||
Node: Double Quotes15692
|
||||
Node: ANSI-C Quoting17038
|
||||
Node: Locale Translation18426
|
||||
Node: Creating Internationalized Scripts19773
|
||||
Node: Comments23974
|
||||
Node: Shell Commands24612
|
||||
Node: Reserved Words25554
|
||||
Node: Simple Commands26422
|
||||
Node: Pipelines27084
|
||||
Node: Lists30150
|
||||
Node: Compound Commands32025
|
||||
Node: Looping Constructs33037
|
||||
Node: Conditional Constructs35584
|
||||
Node: Command Grouping50491
|
||||
Node: Coprocesses51981
|
||||
Node: GNU Parallel54680
|
||||
Node: Shell Functions55601
|
||||
Node: Shell Parameters63710
|
||||
Node: Positional Parameters68246
|
||||
Node: Special Parameters69184
|
||||
Node: Shell Expansions72494
|
||||
Node: Brace Expansion74686
|
||||
Node: Tilde Expansion77352
|
||||
Node: Shell Parameter Expansion80121
|
||||
Node: Command Substitution99148
|
||||
Node: Arithmetic Expansion102684
|
||||
Node: Process Substitution103652
|
||||
Node: Word Splitting104792
|
||||
Node: Filename Expansion106936
|
||||
Node: Pattern Matching110035
|
||||
Node: Quote Removal115271
|
||||
Node: Redirections115578
|
||||
Node: Executing Commands125390
|
||||
Node: Simple Command Expansion126060
|
||||
Node: Command Search and Execution128174
|
||||
Node: Command Execution Environment130585
|
||||
Node: Environment133897
|
||||
Node: Exit Status135604
|
||||
Node: Signals137392
|
||||
Node: Shell Scripts141009
|
||||
Node: Shell Builtin Commands144104
|
||||
Node: Bourne Shell Builtins146218
|
||||
Node: Bash Builtins170625
|
||||
Node: Modifying Shell Behavior205233
|
||||
Node: The Set Builtin205578
|
||||
Node: The Shopt Builtin217096
|
||||
Node: Special Builtins233835
|
||||
Node: Shell Variables234827
|
||||
Node: Bourne Shell Variables235264
|
||||
Node: Bash Variables237460
|
||||
Node: Bash Features274013
|
||||
Node: Invoking Bash275030
|
||||
Node: Bash Startup Files281432
|
||||
Node: Interactive Shells286747
|
||||
Node: What is an Interactive Shell?287158
|
||||
Node: Is this Shell Interactive?287827
|
||||
Node: Interactive Shell Behavior288654
|
||||
Node: Bash Conditional Expressions292411
|
||||
Node: Shell Arithmetic297588
|
||||
Node: Aliases300673
|
||||
Node: Arrays303631
|
||||
Node: The Directory Stack310433
|
||||
Node: Directory Stack Builtins311233
|
||||
Node: Controlling the Prompt315685
|
||||
Node: The Restricted Shell318826
|
||||
Node: Bash POSIX Mode321616
|
||||
Node: Shell Compatibility Mode339100
|
||||
Node: Job Control347589
|
||||
Node: Job Control Basics348049
|
||||
Node: Job Control Builtins353226
|
||||
Node: Job Control Variables359189
|
||||
Node: Command Line Editing360369
|
||||
Node: Introduction and Notation362076
|
||||
Node: Readline Interaction363723
|
||||
Node: Readline Bare Essentials364914
|
||||
Node: Readline Movement Commands366735
|
||||
Node: Readline Killing Commands367735
|
||||
Node: Readline Arguments369716
|
||||
Node: Searching370776
|
||||
Node: Readline Init File373008
|
||||
Node: Readline Init File Syntax374293
|
||||
Node: Conditional Init Constructs399234
|
||||
Node: Sample Init File403602
|
||||
Node: Bindable Readline Commands406726
|
||||
Node: Commands For Moving407954
|
||||
Node: Commands For History410057
|
||||
Node: Commands For Text415143
|
||||
Node: Commands For Killing419221
|
||||
Node: Numeric Arguments422025
|
||||
Node: Commands For Completion423180
|
||||
Node: Keyboard Macros427499
|
||||
Node: Miscellaneous Commands428203
|
||||
Node: Readline vi Mode434860
|
||||
Node: Programmable Completion435815
|
||||
Node: Programmable Completion Builtins443775
|
||||
Node: A Programmable Completion Example455344
|
||||
Node: Using History Interactively460692
|
||||
Node: Bash History Facilities461376
|
||||
Node: Bash History Builtins464491
|
||||
Node: History Interaction469737
|
||||
Node: Event Designators474065
|
||||
Node: Word Designators475651
|
||||
Node: Modifiers477640
|
||||
Node: Installing Bash479552
|
||||
Node: Basic Installation480689
|
||||
Node: Compilers and Options484571
|
||||
Node: Compiling For Multiple Architectures485324
|
||||
Node: Installation Names487076
|
||||
Node: Specifying the System Type489313
|
||||
Node: Sharing Defaults490062
|
||||
Node: Operation Controls490779
|
||||
Node: Optional Features491801
|
||||
Node: Reporting Bugs503606
|
||||
Node: Major Differences From The Bourne Shell504958
|
||||
Node: GNU Free Documentation License522770
|
||||
Node: Indexes547950
|
||||
Node: Builtin Index548404
|
||||
Node: Reserved Word Index555505
|
||||
Node: Variable Index557953
|
||||
Node: Function Index575087
|
||||
Node: Concept Index588946
|
||||
Node: Top898
|
||||
Node: Introduction2836
|
||||
Node: What is Bash?3052
|
||||
Node: What is a shell?4196
|
||||
Node: Definitions6778
|
||||
Node: Basic Shell Features9957
|
||||
Node: Shell Syntax11180
|
||||
Node: Shell Operation12210
|
||||
Node: Quoting13511
|
||||
Node: Escape Character14827
|
||||
Node: Single Quotes15328
|
||||
Node: Double Quotes15680
|
||||
Node: ANSI-C Quoting17026
|
||||
Node: Locale Translation18414
|
||||
Node: Creating Internationalized Scripts19761
|
||||
Node: Comments23962
|
||||
Node: Shell Commands24600
|
||||
Node: Reserved Words25542
|
||||
Node: Simple Commands26410
|
||||
Node: Pipelines27072
|
||||
Node: Lists30138
|
||||
Node: Compound Commands32013
|
||||
Node: Looping Constructs33025
|
||||
Node: Conditional Constructs35572
|
||||
Node: Command Grouping50479
|
||||
Node: Coprocesses51969
|
||||
Node: GNU Parallel54668
|
||||
Node: Shell Functions55589
|
||||
Node: Shell Parameters63698
|
||||
Node: Positional Parameters68234
|
||||
Node: Special Parameters69172
|
||||
Node: Shell Expansions72482
|
||||
Node: Brace Expansion74674
|
||||
Node: Tilde Expansion77340
|
||||
Node: Shell Parameter Expansion80109
|
||||
Node: Command Substitution99219
|
||||
Node: Arithmetic Expansion102755
|
||||
Node: Process Substitution103723
|
||||
Node: Word Splitting104863
|
||||
Node: Filename Expansion107007
|
||||
Node: Pattern Matching110106
|
||||
Node: Quote Removal115342
|
||||
Node: Redirections115649
|
||||
Node: Executing Commands125461
|
||||
Node: Simple Command Expansion126131
|
||||
Node: Command Search and Execution128245
|
||||
Node: Command Execution Environment130656
|
||||
Node: Environment133968
|
||||
Node: Exit Status135675
|
||||
Node: Signals137463
|
||||
Node: Shell Scripts141080
|
||||
Node: Shell Builtin Commands144175
|
||||
Node: Bourne Shell Builtins146289
|
||||
Node: Bash Builtins170696
|
||||
Node: Modifying Shell Behavior205304
|
||||
Node: The Set Builtin205649
|
||||
Node: The Shopt Builtin217167
|
||||
Node: Special Builtins233906
|
||||
Node: Shell Variables234898
|
||||
Node: Bourne Shell Variables235335
|
||||
Node: Bash Variables237531
|
||||
Node: Bash Features274084
|
||||
Node: Invoking Bash275101
|
||||
Node: Bash Startup Files281503
|
||||
Node: Interactive Shells286818
|
||||
Node: What is an Interactive Shell?287229
|
||||
Node: Is this Shell Interactive?287898
|
||||
Node: Interactive Shell Behavior288725
|
||||
Node: Bash Conditional Expressions292482
|
||||
Node: Shell Arithmetic297659
|
||||
Node: Aliases300744
|
||||
Node: Arrays303702
|
||||
Node: The Directory Stack310504
|
||||
Node: Directory Stack Builtins311304
|
||||
Node: Controlling the Prompt315756
|
||||
Node: The Restricted Shell318897
|
||||
Node: Bash POSIX Mode321687
|
||||
Node: Shell Compatibility Mode339171
|
||||
Node: Job Control347660
|
||||
Node: Job Control Basics348120
|
||||
Node: Job Control Builtins353297
|
||||
Node: Job Control Variables359260
|
||||
Node: Command Line Editing360440
|
||||
Node: Introduction and Notation362147
|
||||
Node: Readline Interaction363794
|
||||
Node: Readline Bare Essentials364985
|
||||
Node: Readline Movement Commands366806
|
||||
Node: Readline Killing Commands367806
|
||||
Node: Readline Arguments369787
|
||||
Node: Searching370847
|
||||
Node: Readline Init File373079
|
||||
Node: Readline Init File Syntax374364
|
||||
Node: Conditional Init Constructs399305
|
||||
Node: Sample Init File403673
|
||||
Node: Bindable Readline Commands406797
|
||||
Node: Commands For Moving408025
|
||||
Node: Commands For History410128
|
||||
Node: Commands For Text415214
|
||||
Node: Commands For Killing419292
|
||||
Node: Numeric Arguments422096
|
||||
Node: Commands For Completion423251
|
||||
Node: Keyboard Macros427570
|
||||
Node: Miscellaneous Commands428274
|
||||
Node: Readline vi Mode434931
|
||||
Node: Programmable Completion435886
|
||||
Node: Programmable Completion Builtins443846
|
||||
Node: A Programmable Completion Example455415
|
||||
Node: Using History Interactively460763
|
||||
Node: Bash History Facilities461447
|
||||
Node: Bash History Builtins464562
|
||||
Node: History Interaction469808
|
||||
Node: Event Designators474136
|
||||
Node: Word Designators475722
|
||||
Node: Modifiers477711
|
||||
Node: Installing Bash479623
|
||||
Node: Basic Installation480760
|
||||
Node: Compilers and Options484642
|
||||
Node: Compiling For Multiple Architectures485395
|
||||
Node: Installation Names487147
|
||||
Node: Specifying the System Type489384
|
||||
Node: Sharing Defaults490133
|
||||
Node: Operation Controls490850
|
||||
Node: Optional Features491872
|
||||
Node: Reporting Bugs503677
|
||||
Node: Major Differences From The Bourne Shell505029
|
||||
Node: GNU Free Documentation License522841
|
||||
Node: Indexes548021
|
||||
Node: Builtin Index548475
|
||||
Node: Reserved Word Index555576
|
||||
Node: Variable Index558024
|
||||
Node: Function Index575158
|
||||
Node: Concept Index589017
|
||||
|
||||
End Tag Table
|
||||
|
||||
|
||||
+3
-2
@@ -2296,6 +2296,7 @@ coproc_active (void)
|
||||
return ((sh_coproc.c_flags & COPROC_DEAD) ? NO_PID : sh_coproc.c_pid);
|
||||
#endif
|
||||
}
|
||||
|
||||
void
|
||||
coproc_setvars (struct coproc *cp)
|
||||
{
|
||||
@@ -6072,14 +6073,14 @@ shell_execve (char *command, char **args, char **env)
|
||||
interp = getinterp (sample, sample_len, (int *)NULL);
|
||||
ilen = strlen (interp);
|
||||
errno = i;
|
||||
if (interp[ilen - 1] == '\r')
|
||||
if (interp > 0 && interp[ilen - 1] == '\r')
|
||||
{
|
||||
interp = xrealloc (interp, ilen + 2);
|
||||
interp[ilen - 1] = '^';
|
||||
interp[ilen] = 'M';
|
||||
interp[ilen + 1] = '\0';
|
||||
}
|
||||
sys_error (_("%s: %s: bad interpreter"), command, interp ? interp : "");
|
||||
sys_error (_("%s: %s: bad interpreter"), command, interp);
|
||||
FREE (interp);
|
||||
return (EX_NOEXEC);
|
||||
}
|
||||
|
||||
+126
-127
@@ -6,9 +6,9 @@
|
||||
.\" Case Western Reserve University
|
||||
.\" chet.ramey@case.edu
|
||||
.\"
|
||||
.\" Last Change: Mon Feb 5 14:37:12 EST 2024
|
||||
.\" Last Change: Fri Mar 29 12:03:51 EDT 2024
|
||||
.\"
|
||||
.TH HISTORY 3 "2024 February 5" "GNU History 8.3"
|
||||
.TH HISTORY 3 "2024 March 29" "GNU History 8.3"
|
||||
.\"
|
||||
.ie \n(.g \{\
|
||||
.ds ' \(aq
|
||||
@@ -18,11 +18,24 @@
|
||||
.\}
|
||||
.el \{\
|
||||
.ds ' '
|
||||
.\" not usable in macro arguments on AT&T troff (DWB, Solaris 10)
|
||||
.ds " ""\" two adjacent quotes and no space before this comment
|
||||
.ds ^ ^
|
||||
.ds ~ ~
|
||||
.\}
|
||||
.
|
||||
.\" Fix broken EX/EE macros on DWB troff.
|
||||
.\" Detect it: only DWB sets up a `)Y` register.
|
||||
.if \n()Y \{\
|
||||
.\" Revert the undesired changes to indentation.
|
||||
.am EX
|
||||
.in -5n
|
||||
..
|
||||
.am EE
|
||||
.in +5n
|
||||
..
|
||||
.\}
|
||||
.
|
||||
.\" File Name macro. This used to be `.PN', for Path Name,
|
||||
.\" but Sun doesn't seem to like that very much.
|
||||
.\"
|
||||
@@ -39,16 +52,16 @@
|
||||
.ds lp \fR\|(\fP
|
||||
.ds rp \fR\|)\fP
|
||||
.\" FnN return-value fun-name N arguments
|
||||
.de Fn1
|
||||
.de F1
|
||||
\fI\\$1\fP \fB\\$2\fP \\*(lp\fI\\$3\fP\\*(rp
|
||||
.br
|
||||
..
|
||||
.de Fn2
|
||||
.de F2
|
||||
.if t \fI\\$1\fP \fB\\$2\fP \\*(lp\fI\\$3,\|\\$4\fP\\*(rp
|
||||
.if n \fI\\$1\fP \fB\\$2\fP \\*(lp\fI\\$3, \\$4\fP\\*(rp
|
||||
.br
|
||||
..
|
||||
.de Fn3
|
||||
.de F3
|
||||
.if t \fI\\$1\fP \fB\\$2\fP \\*(lp\fI\\$3,\|\\$4,\|\\$5\fP\|\\*(rp
|
||||
.if n \fI\\$1\fP \fB\\$2\fP \\*(lp\fI\\$3, \\$4, \\$5\fP\\*(rp
|
||||
.br
|
||||
@@ -67,11 +80,10 @@ 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
|
||||
.SH "HISTORY EXPANSION"
|
||||
The history library supports a history expansion feature that
|
||||
is identical to the history expansion in
|
||||
.BR bash.
|
||||
.BR bash .
|
||||
This section describes what syntax features are available.
|
||||
.PP
|
||||
History expansions introduce words from the history list into
|
||||
@@ -122,11 +134,11 @@ Start a history substitution, except when followed by a
|
||||
.BR blank ,
|
||||
newline, = or (.
|
||||
.TP
|
||||
.B !\fIn\fR
|
||||
.B !\fIn\fP
|
||||
Refer to command line
|
||||
.IR n .
|
||||
.TP
|
||||
.B !\-\fIn\fR
|
||||
.B !\-\fIn\fP
|
||||
Refer to the current command minus
|
||||
.IR n .
|
||||
.TP
|
||||
@@ -134,16 +146,14 @@ Refer to the current command minus
|
||||
Refer to the previous command. This is a synonym for
|
||||
.Q !\-1 .
|
||||
.TP
|
||||
.B !\fIstring\fR
|
||||
Refer to the most recent command
|
||||
preceding the current position in the history list
|
||||
starting with
|
||||
.B !\fIstring\fP
|
||||
Refer to the most recent command preceding the current position in the
|
||||
history list starting with
|
||||
.IR string .
|
||||
.TP
|
||||
.B !?\fIstring\fR\fB[?]\fR
|
||||
Refer to the most recent command
|
||||
preceding the current position in the history list
|
||||
containing
|
||||
.B !?\fIstring\fR\fB[?]\fP
|
||||
Refer to the most recent command preceding the current position in the
|
||||
history list containing
|
||||
.IR string .
|
||||
The trailing \fB?\fP may be omitted if
|
||||
.I string
|
||||
@@ -151,13 +161,13 @@ is followed immediately by a newline.
|
||||
If \fIstring\fP is missing, the string from the most recent search is used;
|
||||
it is an error if there is no previous search string.
|
||||
.TP
|
||||
.B \d\s+2\*^\s-2\u\fIstring1\fP\d\s+2\*^\s-2\u\fIstring2\fP\d\s+2\*^\s-2\u
|
||||
.B \*^\fIstring1\fP\*^\fIstring2\fP\*^
|
||||
Quick substitution. Repeat the last command, replacing
|
||||
.I string1
|
||||
with
|
||||
.IR string2 .
|
||||
Equivalent to
|
||||
.Q !!:s\d\s+2\*^\s-2\u\fIstring1\fP\d\s+2\*^\s-2\u\fIstring2\fP\d\s+2\*^\s-2\u
|
||||
.Q !!:s\*^\fIstring1\fP\*^\fIstring2\fP\*^
|
||||
(see \fBModifiers\fP below).
|
||||
.TP
|
||||
.B !#
|
||||
@@ -186,7 +196,7 @@ The zeroth word. For the shell, this is the command
|
||||
word.
|
||||
.TP
|
||||
.I n
|
||||
The \fIn\fRth word.
|
||||
The \fIn\fPth word.
|
||||
.TP
|
||||
.B \*^
|
||||
The first argument. That is, word 1.
|
||||
@@ -197,15 +207,15 @@ zeroth word if there is only one word in the line.
|
||||
.TP
|
||||
.B %
|
||||
The first word matched by the most recent
|
||||
.Q ?\fIstring\fR?
|
||||
.Q ?\fIstring\fP?
|
||||
search,
|
||||
if the search string begins with a character that is part of a word.
|
||||
.TP
|
||||
.I x\fB\-\fPy
|
||||
A range of words;
|
||||
.Q \-\fIy\fR
|
||||
.Q \-\fIy\fP
|
||||
abbreviates
|
||||
.Q 0\-\fIy\fR .
|
||||
.Q 0\-\fIy\fP .
|
||||
.TP
|
||||
.B *
|
||||
All of the words but the zeroth.
|
||||
@@ -289,7 +299,7 @@ substituted, or, if no previous history substitutions took place,
|
||||
the last
|
||||
.I string
|
||||
in a
|
||||
.B !?\fIstring\fR\fB[?]\fR
|
||||
.B !?\fIstring\fP[?]
|
||||
search.
|
||||
If
|
||||
.I new
|
||||
@@ -318,7 +328,7 @@ An \fBa\fP may be used as a synonym for \fBg\fP.
|
||||
.B G
|
||||
Apply the following
|
||||
.Q \fBs\fP
|
||||
or
|
||||
or
|
||||
.Q \fB&\fP
|
||||
modifier once to each word in the event line.
|
||||
.PD
|
||||
@@ -373,16 +383,18 @@ The history list itself might therefore be declared as
|
||||
The state of the History library is encapsulated into a single structure:
|
||||
.PP
|
||||
.nf
|
||||
.EX
|
||||
/*
|
||||
* A structure used to pass around the current state of the history.
|
||||
*/
|
||||
typedef struct _hist_state {
|
||||
HIST_ENTRY **entries; /* Pointer to the entries themselves. */
|
||||
int offset; /* The location pointer within this array. */
|
||||
int length; /* Number of elements within this array. */
|
||||
int size; /* Number of slots allocated to this array. */
|
||||
HIST_ENTRY **entries; /* Pointer to entry records. */
|
||||
int offset; /* The current record. */
|
||||
int length; /* Number of records in list. */
|
||||
int size; /* Number of records allocated. */
|
||||
int flags;
|
||||
} HISTORY_STATE;
|
||||
.EE
|
||||
.fi
|
||||
.PP
|
||||
If the flags member includes \fBHS_STIFLED\fP, the history has been
|
||||
@@ -394,192 +406,181 @@ exported by the GNU History library.
|
||||
This section describes functions used to initialize and manage
|
||||
the state of the History library when you want to use the history
|
||||
functions in your program.
|
||||
|
||||
.Fn1 void using_history void
|
||||
.PP
|
||||
.F1 void using_history void
|
||||
Begin a session in which the history functions might be used. This
|
||||
initializes the interactive variables.
|
||||
|
||||
.Fn1 "HISTORY_STATE *" history_get_history_state void
|
||||
.PP
|
||||
.F1 "HISTORY_STATE *" history_get_history_state void
|
||||
Return a structure describing the current state of the input history.
|
||||
|
||||
.Fn1 void history_set_history_state "HISTORY_STATE *state"
|
||||
.PP
|
||||
.F1 void history_set_history_state "HISTORY_STATE *state"
|
||||
Set the state of the history list according to \fIstate\fP.
|
||||
|
||||
.SS History List Management
|
||||
These functions manage individual entries on the history list, or set
|
||||
parameters managing the list itself.
|
||||
|
||||
.Fn1 void add_history "const char *string"
|
||||
.PP
|
||||
.F1 void add_history "const char *string"
|
||||
Place \fIstring\fP at the end of the history list. The associated data
|
||||
field (if any) is set to \fBNULL\fP.
|
||||
If the maximum number of history entries has been set using
|
||||
\fBstifle_history()\fP, and the new number of history entries would exceed
|
||||
that maximum, the oldest history entry is removed.
|
||||
|
||||
.Fn1 void add_history_time "const char *string"
|
||||
.PP
|
||||
.F1 void add_history_time "const char *string"
|
||||
Change the time stamp associated with the most recent history entry to
|
||||
\fIstring\fP.
|
||||
|
||||
.Fn1 "HIST_ENTRY *" remove_history "int which"
|
||||
.PP
|
||||
.F1 "HIST_ENTRY *" remove_history "int which"
|
||||
Remove history entry at offset \fIwhich\fP from the history. The
|
||||
removed element is returned so you can free the line, data,
|
||||
and containing structure.
|
||||
|
||||
.Fn1 "histdata_t" free_history_entry "HIST_ENTRY *histent"
|
||||
.PP
|
||||
.F1 "histdata_t" free_history_entry "HIST_ENTRY *histent"
|
||||
Free the history entry \fIhistent\fP and any history library private
|
||||
data associated with it. Returns the application-specific data
|
||||
so the caller can dispose of it.
|
||||
|
||||
.Fn3 "HIST_ENTRY *" replace_history_entry "int which" "const char *line" "histdata_t data"
|
||||
.PP
|
||||
.F3 "HIST_ENTRY *" replace_history_entry "int which" "const char *line" "histdata_t data"
|
||||
Make the history entry at offset \fIwhich\fP have \fIline\fP and \fIdata\fP.
|
||||
This returns the old entry so the caller can dispose of any
|
||||
application-specific data. In the case
|
||||
of an invalid \fIwhich\fP, a \fBNULL\fP pointer is returned.
|
||||
|
||||
.Fn1 void clear_history "void"
|
||||
.PP
|
||||
.F1 void clear_history "void"
|
||||
Clear the history list by deleting all the entries.
|
||||
|
||||
.Fn1 void stifle_history "int max"
|
||||
.PP
|
||||
.F1 void stifle_history "int max"
|
||||
Stifle the history list, remembering only the last \fImax\fP entries.
|
||||
The history list will contain only \fImax\fP entries at a time.
|
||||
|
||||
.Fn1 int unstifle_history "void"
|
||||
.PP
|
||||
.F1 int unstifle_history "void"
|
||||
Stop stifling the history. This returns the previously-set
|
||||
maximum number of history entries (as set by \fBstifle_history()\fP).
|
||||
history was stifled. The value is positive if the history was
|
||||
stifled, negative if it wasn't.
|
||||
|
||||
.Fn1 int history_is_stifled "void"
|
||||
.PP
|
||||
.F1 int history_is_stifled "void"
|
||||
Returns non-zero if the history is stifled, zero if it is not.
|
||||
|
||||
.SS Information About the History List
|
||||
|
||||
These functions return information about the entire history list or
|
||||
individual list entries.
|
||||
|
||||
.Fn1 "HIST_ENTRY **" history_list "void"
|
||||
.PP
|
||||
.F1 "HIST_ENTRY **" history_list "void"
|
||||
Return a \fBNULL\fP terminated array of \fIHIST_ENTRY *\fP which is the
|
||||
current input history. Element 0 of this list is the beginning of time.
|
||||
If there is no history, return \fBNULL\fP.
|
||||
|
||||
.Fn1 int where_history "void"
|
||||
.PP
|
||||
.F1 int where_history "void"
|
||||
Returns the offset of the current history element.
|
||||
|
||||
.Fn1 "HIST_ENTRY *" current_history "void"
|
||||
.PP
|
||||
.F1 "HIST_ENTRY *" current_history "void"
|
||||
Return the history entry at the current position, as determined by
|
||||
\fBwhere_history()\fP. If there is no entry there, return a \fBNULL\fP
|
||||
pointer.
|
||||
|
||||
.Fn1 "HIST_ENTRY *" history_get "int offset"
|
||||
.PP
|
||||
.F1 "HIST_ENTRY *" history_get "int offset"
|
||||
Return the history entry at position \fIoffset\fP.
|
||||
The range of valid values of \fIoffset\fP starts at \fBhistory_base\fP
|
||||
and ends at \fBhistory_length\fP \- 1.
|
||||
If there is no entry there, or if \fIoffset\fP is outside the valid
|
||||
range, return a \fBNULL\fP pointer.
|
||||
|
||||
.Fn1 "time_t" history_get_time "HIST_ENTRY *"
|
||||
.PP
|
||||
.F1 "time_t" history_get_time "HIST_ENTRY *"
|
||||
Return the time stamp associated with the history entry passed as the argument.
|
||||
|
||||
.Fn1 int history_total_bytes "void"
|
||||
.PP
|
||||
.F1 int history_total_bytes "void"
|
||||
Return the number of bytes that the primary history entries are using.
|
||||
This function returns the sum of the lengths of all the lines in the
|
||||
history.
|
||||
|
||||
.SS Moving Around the History List
|
||||
|
||||
These functions allow the current index into the history list to be
|
||||
set or changed.
|
||||
|
||||
.Fn1 int history_set_pos "int pos"
|
||||
.PP
|
||||
.F1 int history_set_pos "int pos"
|
||||
Set the current history offset to \fIpos\fP, an absolute index
|
||||
into the list.
|
||||
Returns 1 on success, 0 if \fIpos\fP is less than zero or greater
|
||||
than the number of history entries.
|
||||
|
||||
.Fn1 "HIST_ENTRY *" previous_history "void"
|
||||
.PP
|
||||
.F1 "HIST_ENTRY *" previous_history "void"
|
||||
Back up the current history offset to the previous history entry, and
|
||||
return a pointer to that entry. If there is no previous entry, return
|
||||
a \fBNULL\fP pointer.
|
||||
|
||||
.Fn1 "HIST_ENTRY *" next_history "void"
|
||||
.PP
|
||||
.F1 "HIST_ENTRY *" next_history "void"
|
||||
If the current history offset refers to a valid history entry,
|
||||
increment the current history offset.
|
||||
If the possibly-incremented history offset refers to a valid history
|
||||
entry, return a pointer to that entry;
|
||||
otherwise, return a \fBNULL\fP pointer.
|
||||
|
||||
.SS Searching the History List
|
||||
|
||||
These functions allow searching of the history list for entries containing
|
||||
a specific string. Searching may be performed both forward and backward
|
||||
from the current history position. The search may be \fIanchored\fP,
|
||||
meaning that the string must match at the beginning of the history entry.
|
||||
|
||||
.Fn2 int history_search "const char *string" "int direction"
|
||||
.PP
|
||||
.F2 int history_search "const char *string" "int direction"
|
||||
Search the history for \fIstring\fP, starting at the current history offset.
|
||||
If \fIdirection\fP is less than 0, then the search is through
|
||||
previous entries, otherwise through subsequent entries.
|
||||
If \fIstring\fP is found, then
|
||||
the current history index is set to that history entry, and the value
|
||||
returned is the offset in the line of the entry where
|
||||
\fIstring\fP was found. Otherwise, nothing is changed, and a -1 is
|
||||
returned.
|
||||
|
||||
.Fn2 int history_search_prefix "const char *string" "int direction"
|
||||
\fIstring\fP was found.
|
||||
Otherwise, nothing is changed, and the function returns \-1.
|
||||
.PP
|
||||
.F2 int history_search_prefix "const char *string" "int direction"
|
||||
Search the history for \fIstring\fP, starting at the current history
|
||||
offset. The search is anchored: matching lines must begin with
|
||||
\fIstring\fP. If \fIdirection\fP is less than 0, then the search is
|
||||
through previous entries, otherwise through subsequent entries.
|
||||
If \fIstring\fP is found, then the
|
||||
current history index is set to that entry, and the return value is 0.
|
||||
Otherwise, nothing is changed, and a -1 is returned.
|
||||
|
||||
.Fn3 int history_search_pos "const char *string" "int direction" "int pos"
|
||||
Otherwise, nothing is changed, and the function returns \-1.
|
||||
.PP
|
||||
.F3 int history_search_pos "const char *string" "int direction" "int pos"
|
||||
Search for \fIstring\fP in the history list, starting at \fIpos\fP, an
|
||||
absolute index into the list. If \fIdirection\fP is negative, the search
|
||||
proceeds backward from \fIpos\fP, otherwise forward. Returns the absolute
|
||||
index of the history element where \fIstring\fP was found, or -1 otherwise.
|
||||
|
||||
index of the history element where \fIstring\fP was found, or \-1 otherwise.
|
||||
.SS Managing the History File
|
||||
The History library can read the history from and write it to a file.
|
||||
This section documents the functions for managing a history file.
|
||||
|
||||
.Fn1 int read_history "const char *filename"
|
||||
.PP
|
||||
.F1 int read_history "const char *filename"
|
||||
Add the contents of \fIfilename\fP to the history list, a line at a time.
|
||||
If \fIfilename\fP is \fBNULL\fP, then read from \fI\*~/.history\fP.
|
||||
Returns 0 if successful, or \fBerrno\fP if not.
|
||||
|
||||
.Fn3 int read_history_range "const char *filename" "int from" "int to"
|
||||
.PP
|
||||
.F3 int read_history_range "const char *filename" "int from" "int to"
|
||||
Read a range of lines from \fIfilename\fP, adding them to the history list.
|
||||
Start reading at line \fIfrom\fP and end at \fIto\fP.
|
||||
If \fIfrom\fP is zero, start at the beginning. If \fIto\fP is less than
|
||||
\fIfrom\fP, then read until the end of the file. If \fIfilename\fP is
|
||||
\fBNULL\fP, then read from \fI\*~/.history\fP. Returns 0 if successful,
|
||||
or \fBerrno\fP if not.
|
||||
|
||||
.Fn1 int write_history "const char *filename"
|
||||
.PP
|
||||
.F1 int write_history "const char *filename"
|
||||
Write the current history to \fIfilename\fP, overwriting \fIfilename\fP
|
||||
if necessary.
|
||||
If \fIfilename\fP is \fBNULL\fP, then write the history list to \fI\*~/.history\fP.
|
||||
Returns 0 on success, or \fBerrno\fP on a read or write error.
|
||||
|
||||
|
||||
.Fn2 int append_history "int nelements" "const char *filename"
|
||||
.PP
|
||||
.F2 int append_history "int nelements" "const char *filename"
|
||||
Append the last \fInelements\fP of the history list to \fIfilename\fP.
|
||||
If \fIfilename\fP is \fBNULL\fP, then append to \fI\*~/.history\fP.
|
||||
Returns 0 on success, or \fBerrno\fP on a read or write error.
|
||||
|
||||
.Fn2 int history_truncate_file "const char *filename" "int nlines"
|
||||
.PP
|
||||
.F2 int history_truncate_file "const char *filename" "int nlines"
|
||||
Truncate the history file \fIfilename\fP, leaving only the last
|
||||
\fInlines\fP lines.
|
||||
If \fIfilename\fP is \fBNULL\fP, then \fI\*~/.history\fP is truncated.
|
||||
Returns 0 on success, or \fBerrno\fP on failure.
|
||||
|
||||
.SS History Expansion
|
||||
|
||||
These functions implement history expansion.
|
||||
|
||||
.Fn2 int history_expand "const char *string" "char **output"
|
||||
.PP
|
||||
.F2 int history_expand "const char *string" "char **output"
|
||||
Expand \fIstring\fP, placing the result into \fIoutput\fP, a pointer
|
||||
to a string. Returns:
|
||||
.RS
|
||||
@@ -593,7 +594,7 @@ character);
|
||||
1
|
||||
if expansions did take place;
|
||||
.TP
|
||||
-1
|
||||
\-1
|
||||
if there was an error in expansion;
|
||||
.TP
|
||||
2
|
||||
@@ -603,42 +604,40 @@ as with the \fB:p\fP modifier.
|
||||
.RE
|
||||
If an error occurred in expansion, then \fIoutput\fP contains a descriptive
|
||||
error message.
|
||||
|
||||
.Fn3 "char *" get_history_event "const char *string" "int *cindex" "int qchar"
|
||||
.PP
|
||||
.F3 "char *" get_history_event "const char *string" "int *cindex" "int qchar"
|
||||
Returns the text of the history event beginning at \fIstring\fP +
|
||||
\fI*cindex\fP. \fI*cindex\fP is modified to point to after the event
|
||||
specifier. At function entry, \fIcindex\fP points to the index into
|
||||
\fIstring\fP where the history event specification begins. \fIqchar\fP
|
||||
is a character that is allowed to end the event specification in addition
|
||||
to the ``normal'' terminating characters.
|
||||
|
||||
.Fn1 "char **" history_tokenize "const char *string"
|
||||
.PP
|
||||
.F1 "char **" history_tokenize "const char *string"
|
||||
Return an array of tokens parsed out of \fIstring\fP, much as the
|
||||
shell might.
|
||||
The tokens are split on the characters in the
|
||||
\fBhistory_word_delimiters\fP variable,
|
||||
and shell quoting conventions are obeyed.
|
||||
|
||||
.Fn3 "char *" history_arg_extract "int first" "int last" "const char *string"
|
||||
.PP
|
||||
.F3 "char *" history_arg_extract "int first" "int last" "const char *string"
|
||||
Extract a string segment consisting of the \fIfirst\fP through \fIlast\fP
|
||||
arguments present in \fIstring\fP. Arguments are split using
|
||||
\fBhistory_tokenize()\fP.
|
||||
|
||||
.SS History Variables
|
||||
|
||||
This section describes the externally-visible variables exported by
|
||||
the GNU History Library.
|
||||
|
||||
.PP
|
||||
.Vb int history_base
|
||||
The logical offset of the first entry in the history list.
|
||||
|
||||
.PP
|
||||
.Vb int history_length
|
||||
The number of entries currently stored in the history list.
|
||||
|
||||
.PP
|
||||
.Vb int history_max_entries
|
||||
The maximum number of history entries. This must be changed using
|
||||
\fBstifle_history()\fP.
|
||||
|
||||
.PP
|
||||
.Vb int history_write_timestamps
|
||||
If non-zero, timestamps are written to the history file, so they can be
|
||||
preserved between sessions. The default value is 0, meaning that
|
||||
@@ -646,35 +645,35 @@ timestamps are not saved.
|
||||
The current timestamp format uses the value of \fIhistory_comment_char\fP
|
||||
to delimit timestamp entries in the history file. If that variable does
|
||||
not have a value (the default), timestamps will not be written.
|
||||
|
||||
.PP
|
||||
.Vb char history_expansion_char
|
||||
The character that introduces a history event. The default is \fB!\fP.
|
||||
Setting this to 0 inhibits history expansion.
|
||||
|
||||
.PP
|
||||
.Vb char history_subst_char
|
||||
The character that invokes word substitution if found at the start of
|
||||
a line. The default is \fB\*^\fP.
|
||||
|
||||
.PP
|
||||
.Vb char history_comment_char
|
||||
During tokenization, if this character is seen as the first character
|
||||
of a word, then it and all subsequent characters up to a newline are
|
||||
ignored, suppressing history expansion for the remainder of the line.
|
||||
This is disabled by default.
|
||||
|
||||
.PP
|
||||
.Vb "char *" history_word_delimiters
|
||||
The characters that separate tokens for \fBhistory_tokenize()\fP.
|
||||
The default value is \fB\*"\ \et\en()<>;&|\*"\fP.
|
||||
|
||||
.PP
|
||||
.Vb "char *" history_no_expand_chars
|
||||
The list of characters which inhibit history expansion if found immediately
|
||||
following \fBhistory_expansion_char\fP. The default is space, tab, newline,
|
||||
\fB\er\fP, and \fB=\fP.
|
||||
|
||||
.PP
|
||||
.Vb "char *" history_search_delimiter_chars
|
||||
The list of additional characters which can delimit a history search
|
||||
string, in addition to space, tab, \fI:\fP and \fI?\fP in the case of
|
||||
a substring search. The default is empty.
|
||||
|
||||
.PP
|
||||
.Vb int history_quotes_inhibit_expansion
|
||||
If non-zero, the history expansion code implements shell-like quoting:
|
||||
single-quoted words are not scanned for the history expansion
|
||||
@@ -682,7 +681,7 @@ character or the history comment character, and double-quoted words may
|
||||
have history expansion performed, since single quotes are not special
|
||||
within double quotes.
|
||||
The default value is 0.
|
||||
|
||||
.PP
|
||||
.Vb int history_quoting_state
|
||||
An application may set this variable to indicate that the current line
|
||||
being expanded is subject to existing quoting. If set to \fI\*'\fP, the
|
||||
@@ -693,7 +692,7 @@ it reads an unquoted closing double quote. If set to zero, the default,
|
||||
the history expansion function will assume the line is not quoted and
|
||||
treat quote characters within the line as described above.
|
||||
This is only effective if \fBhistory_quotes_inhibit_expansion\fP is set.
|
||||
|
||||
.PP
|
||||
.Vb "rl_linebuf_func_t *" history_inhibit_expansion_function
|
||||
This should be set to the address of a function that takes two arguments:
|
||||
a \fBchar *\fP (\fIstring\fP)
|
||||
@@ -742,7 +741,7 @@ Once you have determined that a bug actually exists, mail a
|
||||
bug report to \fIbug\-readline\fP@\fIgnu.org\fP.
|
||||
If you have a fix, you are welcome to mail that
|
||||
as well! Suggestions and `philosophical' bug reports may be mailed
|
||||
to \fPbug-readline\fP@\fIgnu.org\fP or posted to the Usenet
|
||||
to \fIbug\-readline\fP@\fIgnu.org\fP or posted to the Usenet
|
||||
newsgroup
|
||||
.BR gnu.bash.bug .
|
||||
.PP
|
||||
|
||||
@@ -6,9 +6,9 @@
|
||||
.\" Case Western Reserve University
|
||||
.\" chet.ramey@case.edu
|
||||
.\"
|
||||
.\" Last Change: Mon Feb 5 10:50:56 EST 2024
|
||||
.\" Last Change: Fri Mar 29 11:54:44 EDT 2024
|
||||
.\"
|
||||
.TH READLINE 3 "2024 February 5" "GNU Readline 8.3"
|
||||
.TH READLINE 3 "2024 March 29" "GNU Readline 8.3"
|
||||
.\"
|
||||
.ie \n(.g \{\
|
||||
.ds ' \(aq
|
||||
@@ -18,6 +18,7 @@
|
||||
.\}
|
||||
.el \{\
|
||||
.ds ' '
|
||||
.\" not usable in macro arguments on AT&T troff (DWB, Solaris 10)
|
||||
.ds " ""\" two adjacent quotes and no space before this comment
|
||||
.ds ^ ^
|
||||
.ds ~ ~
|
||||
@@ -100,11 +101,12 @@ treated as a newline.
|
||||
.SH NOTATION
|
||||
.LP
|
||||
An Emacs-style notation is used to denote
|
||||
keystrokes. Control keys are denoted by C\-\fIkey\fR, e.g., C\-n
|
||||
means Control\-N. Similarly,
|
||||
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\fR, so M\-x means Meta\-X. (On keyboards
|
||||
without a
|
||||
keys are denoted by M\-\fIkey\fP, so M\-x means Meta\-X.
|
||||
(On keyboards without a
|
||||
.I meta
|
||||
key, M\-\fIx\fP means ESC \fIx\fP, i.e., press the Escape key
|
||||
then the
|
||||
@@ -437,7 +439,7 @@ environment variable.
|
||||
.\" finesse. We require `\c`, and while the single-font macros don't
|
||||
.\" honor input trap continuation, the font alternation macros do.
|
||||
.TP
|
||||
.BR comment\-begin\ (\c
|
||||
.BR comment\-begin\ ( \c
|
||||
.Q \fB#\fP \fB)\fP
|
||||
The string that is inserted when the
|
||||
.B insert\-comment
|
||||
@@ -588,7 +590,7 @@ locale contains eight-bit characters.
|
||||
This variable is dependent on the \fBLC_CTYPE\fP locale category, and
|
||||
may change if the locale is changed.
|
||||
.TP
|
||||
.BR isearch\-terminators\ (\c
|
||||
.BR isearch\-terminators\ ( \c
|
||||
.Q \fBC\-[C\-J\fP \fB)\fP
|
||||
The string of characters that should terminate an incremental
|
||||
search without subsequently executing the character as a command.
|
||||
|
||||
@@ -9,7 +9,7 @@ msgstr ""
|
||||
"Project-Id-Version: bash-5.2-rc1\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2022-01-11 14:50-0500\n"
|
||||
"PO-Revision-Date: 2023-05-23 19:54-0700\n"
|
||||
"PO-Revision-Date: 2024-03-31 18:43-0700\n"
|
||||
"Last-Translator: Božidar Putanec <bozidarp@yahoo.com>\n"
|
||||
"Language-Team: Croatian <lokalizacija@linux.hr>\n"
|
||||
"Language: hr\n"
|
||||
@@ -957,12 +957,12 @@ msgstr "oktalni broj"
|
||||
#: builtins/umask.def:232
|
||||
#, c-format
|
||||
msgid "`%c': invalid symbolic mode operator"
|
||||
msgstr "„%c“: nevaljan operator u simboličkom načinu"
|
||||
msgstr "„%c“: nevaljan operator u simboličnom načinu"
|
||||
|
||||
#: builtins/umask.def:287
|
||||
#, c-format
|
||||
msgid "`%c': invalid symbolic mode character"
|
||||
msgstr "„%c“: nevaljan znak u simboličkom načinu"
|
||||
msgstr "„%c“: nevaljan znak u simboličnom načinu"
|
||||
|
||||
#: error.c:89 error.c:373 error.c:375 error.c:377
|
||||
msgid " line "
|
||||
@@ -2810,10 +2810,10 @@ msgstr ""
|
||||
" naziv, „cd“ prijeđe u direktorij s tim nazivom.\n"
|
||||
"\n"
|
||||
" Opcije:\n"
|
||||
" -L slijedi simboličke poveznice; simboličke poveznice u DIREKTORIJU razriješi\n"
|
||||
" -L slijedi simbolične poveznice; simbolične poveznice u DIREKTORIJU razriješi\n"
|
||||
" nakon obrade instance „..“\n"
|
||||
" -P rabi fizičku strukturu direktorija umjesto da slijedi simboličke\n"
|
||||
" poveznice; simboličke poveznice u DIREKTORIJU razriješi prije obrade\n"
|
||||
" -P rabi fizičku strukturu direktorija umjesto da slijedi simbolične\n"
|
||||
" poveznice; simbolične poveznice u DIREKTORIJU razriješi prije obrade\n"
|
||||
" instance „..“\n"
|
||||
" -e ako je dana s opcijom „-P“, i trenutni radni direktorij nije\n"
|
||||
" moguće uspješno odrediti nakon uspješne promjene direktorija,\n"
|
||||
@@ -2821,7 +2821,7 @@ msgstr ""
|
||||
" -@ opiše proširene atribute povezane s datotekom kao direktorij\n"
|
||||
" koji sadrži atribute datoteke (ako sustav to podržava)\n"
|
||||
"\n"
|
||||
" Zadano, simboličke poveznice se slijede kao da je navedena opcija -L.\n"
|
||||
" Zadano, simbolične poveznice se slijede kao da je navedena opcija -L.\n"
|
||||
" „..“ (ako se pojavi u DIREKTORIJU) obradi se uklanjanjem komponente\n"
|
||||
" staze koja mu neposredno prethodi unatrag do kose crte „/“ ili do početka\n"
|
||||
" DIREKTORIJA.\n"
|
||||
@@ -2849,7 +2849,7 @@ msgstr ""
|
||||
"\n"
|
||||
" Opcije:\n"
|
||||
" -L ispiše vrijednost od $PWD ako sadrži trenutni radni direktorij\n"
|
||||
" -P ispiše stvarnu fizičku stazu do direktorija bez simboličkih poveznica\n"
|
||||
" -P ispiše stvarnu fizičku stazu do direktorija bez simboličnih poveznica\n"
|
||||
"\n"
|
||||
" Bez opcija, „pwd“ se ponaša kao da je navedena opcija „-L“\n"
|
||||
"\n"
|
||||
@@ -3275,7 +3275,7 @@ msgid ""
|
||||
" Exit Status:\n"
|
||||
" Returns success unless COMMAND is not found or a redirection error occurs."
|
||||
msgstr ""
|
||||
"Zamjeni ljusku s danom naredbom.\n"
|
||||
"Zamijeni ljusku s danom naredbom.\n"
|
||||
"\n"
|
||||
" Izvrši danu NAREDBU, zamjenjujući ovu ljusku s ovim programom.\n"
|
||||
" Eventualni ARGUMENTI postanu argumenti NAREDBE. Ako NAREDBA nije\n"
|
||||
@@ -3948,7 +3948,7 @@ msgstr ""
|
||||
" -m upravljanje poslovima je omogućeno (zadano)\n"
|
||||
" -n pročita, ali ne izvrši naredbe\n"
|
||||
" -o IME_OPCIJE omogući tu opciju (v. niže duge nazive za IME_OPCIJE)\n"
|
||||
" -P ne razriješi simboličke poveznice pri izvršavanju naredbi poput „cd“\n"
|
||||
" -P ne razriješi simbolične poveznice pri izvršavanju naredbi poput „cd“\n"
|
||||
" koje promjene trenutni direktorij\n"
|
||||
" -p uključi privilegirani način: datoteke BASH_ENV i ENV se zanemare,\n"
|
||||
" funkcije ljuske se ne uvoze iz okoline, a zanemari se i\n"
|
||||
@@ -4272,9 +4272,9 @@ msgstr ""
|
||||
" -f DATOTEKA istina ako je datoteka regularna datoteka\n"
|
||||
" -G DATOTEKA istina ako je datoteka efektivno vlasništvo vaše skupine\n"
|
||||
" -g DATOTEKA istina ako je datoteka SETGUID\n"
|
||||
" -h DATOTEKA istina ako je datoteka simbolička poveznica\n"
|
||||
" -h DATOTEKA istina ako je datoteka simbolična poveznica\n"
|
||||
" -k DATOTEKA istina ako datoteka ima postavljeni \"sticky\" bit\n"
|
||||
" -L DATOTEKA istina ako je datoteka simbolička poveznica\n"
|
||||
" -L DATOTEKA istina ako je datoteka simbolična poveznica\n"
|
||||
" -N DATOTEKA istina ako se datoteka promijenila od zadnjeg čitanja\n"
|
||||
" -O DATOTEKA istina ako je datoteka efektivno vaše vlasništvo\n"
|
||||
" -p DATOTEKA istina ako je datoteka imenovana cijev\n"
|
||||
@@ -4580,12 +4580,12 @@ msgstr ""
|
||||
" Ako MODE nije naveden, ispiše trenutnu vrijednost maske.\n"
|
||||
"\n"
|
||||
" Ako MODE počinje sa znamenkom, interpretira se kao oktalni broj;\n"
|
||||
" inače to je simbolički mode string kakav prihvaća chmod(1).\n"
|
||||
" inače to je simbolični mode string kakav prihvaća chmod(1).\n"
|
||||
"\n"
|
||||
" Opcije:\n"
|
||||
" -p ako nije naveden MODE, generira izlaz u obliku\n"
|
||||
" koji se može iskoristiti kao ulaz\n"
|
||||
" -S napravi simbolički izlaz; inače izlaz je oktalni broj\n"
|
||||
" -S napravi simbolični izlaz; inače izlaz je oktalni broj\n"
|
||||
"\n"
|
||||
" Završi s uspjehom osim ako MODE nije valjan ili je dana nevaljana opcija."
|
||||
|
||||
|
||||
Reference in New Issue
Block a user