From 50aeb31ff80e7bdde9b8edd50ab924e3791fe606 Mon Sep 17 00:00:00 2001 From: Sahal Ansari Date: Fri, 18 Oct 2024 17:57:25 -0500 Subject: [PATCH 1/5] missed some table formatting in last commit. --- docs/commands/builtin/cd.md | 10 +-- docs/commands/builtin/declare.md | 72 +++++++----------- docs/commands/builtin/echo.md | 44 +++++------ docs/commands/builtin/exec.md | 10 +-- docs/commands/builtin/exit.md | 6 +- docs/commands/builtin/export.md | 20 ++--- docs/commands/builtin/kill.md | 26 +++---- docs/commands/builtin/mapfile.md | 18 ++--- docs/commands/builtin/read.md | 69 +++++++++-------- docs/dict/exit_status.md | 122 +++++++++++-------------------- docs/howto/pax.md | 42 +++++------ docs/scripting/basics.md | 33 +++++---- docs/scripting/newbie_traps.md | 12 +-- docs/scripting/terminalcodes.md | 43 ++++------- docs/snipplets/awkcsv.md | 21 +++--- docs/snipplets/wrapperargs.md | 20 ++--- docs/syntax/pe.md | 16 ++-- docs/syntax/shellvars.md | 32 ++++---- 18 files changed, 275 insertions(+), 341 deletions(-) diff --git a/docs/commands/builtin/cd.md b/docs/commands/builtin/cd.md index e1567da..833bc28 100644 --- a/docs/commands/builtin/cd.md +++ b/docs/commands/builtin/cd.md @@ -26,11 +26,11 @@ is given or the shell is configured to do so (see the `-P` option of ### Options - Option Description - -------- ---------------------------------------------------- - `-L` Follow symbolic links (default) - `-P` Do not follow symbolic links - `-@` Browse a file's extended attributed, if supported +|Option|Description| +|------|-----------| +|`-L`|Follow symbolic links (default)| +|`-P`|Do not follow symbolic links| +|`-@`|Browse a file's extended attributed, if supported| ### Exit status diff --git a/docs/commands/builtin/declare.md b/docs/commands/builtin/declare.md index e38b6c4..b8a65e2 100644 --- a/docs/commands/builtin/declare.md +++ b/docs/commands/builtin/declare.md @@ -30,54 +30,36 @@ tagged as obsolete. Below, `[-+]X` indicates an attribute, use `-X` to set the attribute, `+X` to remove it. - ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- - Option Description - --------- ------------------------------------------------------------------------------------------------------------------------------------------------------------------ - `[-+]a` make NAMEs indexed arrays (removing with `+a` is valid syntax, but leads to an error message) - - `[-+]A` make NAMEs associative arrays - - `[-+]c` **Undocumented** convert NAMEs to "capcase" on assignment (makes the first letter upper-case and the rest lower). Requires Bash built with `-DCASEMOD_CAPCASE` - - `-f` restrict action or display to function names and definitions (removing with `+f` is valid syntax, but leads to an error message) - - `-F` restrict display to function names only (plus line number and source file when debugging) - - `-g` create global variables when used in a shell function; otherwise ignored (by default, `declare` declares local scope variables when used in shell functions) - - `[-+]i` make NAMEs have the "integer" attribute - - `[-+]l` convert NAMEs to lower case on assignment (makes sure the variable contains only lower case letters) - - `[-+]n` make NAME a reference to the variable named by its value. Introduced in Bash 4.3-alpha. - ''`${!NAME}`'' reveals the reference variable name, VALUE. - Use `unset -n NAME` to unset the variable. (`unset -v NAME` unsets the VALUE variable.) - Use `[[ -R NAME ]]` to test if NAME has been set to a VALUE, another variable's name. - - `-p` display the attributes and value of each NAME - - `[-+]r` make NAMEs readonly (removing with `+r` is valid syntax, but not possible) - - `[-+]t` make NAMEs have the "trace" attribute (effective only for functions) - - `[-+]u` convert NAMEs to upper case on assignment (makes sure the variable contains only upper case letters) - - `[-+]x` make NAMEs exported - ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- +|Option|Description| +|------|-----------| +|`[-+]a`|make NAMEs indexed arrays (removing with `+a` is valid syntax, but leads to an error message)| +|`[-+]A`|make NAMEs associative arrays| +|`[-+]c`|**Undocumented** convert NAMEs to "capcase" on assignment (makes the first letter upper-case and the rest lower). Requires Bash built with `-DCASEMOD_CAPCASE`| +|`-f`|restrict action or display to function names and definitions (removing with `+f` is valid syntax, but leads to an error message)| +|`-F`|restrict display to function names only (plus line number and source file when debugging)| +|`-g`|create global variables when used in a shell function; otherwise ignored (by default, `declare` declares local scope variables when used in shell functions)| +|`[-+]i`|make NAMEs have the "integer" attribute| +|`[-+]l`|convert NAMEs to lower case on assignment (makes sure the variable contains only lower case letters)| +|`[-+]n`|make NAME a reference to the variable named by its value. Introduced in Bash 4.3-alpha. ''`${!NAME}`'' reveals the reference variable name, VALUE. Use `unset -n NAME` to unset the variable. (`unset -v NAME` unsets the VALUE variable.) Use `[[ -R NAME ]]` to test if NAME has been set to a VALUE, another variable's name.| +|`-p`|display the attributes and value of each NAME| +|`[-+]r`|make NAMEs readonly (removing with `+r` is valid syntax, but not possible)| +|`[-+]t`|make NAMEs have the "trace" attribute (effective only for functions)| +|`[-+]u`|convert NAMEs to upper case on assignment (makes sure the variable contains only upper case letters)| +|`[-+]x`|make NAMEs exported| ### Return status - Status Reason - -------- ---------------------------------------------------------------------------------------- - 0 no error - != 0 invalid option - != 0 invalid variable name given - != 0 attempt to **define** a function using `-f` - != 0 assignment to a readonly variable - != 0 removing the readonly-attribute from a readonly variable - != 0 assignment to an array variable without the compound assignment syntax (`array=(...)`) - != 0 attempt to use `+a` to "destroy" an array - != 0 attemt to display a non-existent function with `-f` +|Status|Reason| +|------|------| +|0|no error| +|!= 0|invalid option| +|!= 0|invalid variable name given| +|!= 0|attempt to **define** a function using `-f`| +|!= 0|assignment to a readonly variable| +|!= 0|removing the readonly-attribute from a readonly variable| +|!= 0|assignment to an array variable without the compound assignment syntax (`array=(...)`)| +|!= 0|attempt to use `+a` to "destroy" an array| +|!= 0|attemt to display a non-existent function with `-f`| ## Notes diff --git a/docs/commands/builtin/echo.md b/docs/commands/builtin/echo.md index 047bb0d..a180acd 100644 --- a/docs/commands/builtin/echo.md +++ b/docs/commands/builtin/echo.md @@ -16,31 +16,31 @@ if given. ### Options - Option Description - -------- ---------------------------------------------------------------------------------------------------------------- - `-n` The trailing newline is suppressed. - `-e` Interpretation of the following backslash-escaped characters (below) is enabled. - `-E` Disables the interpretation of these escape characters, even on systems where they are interpreted by default. +Option|Description| +------|-----------| +|`-n`|The trailing newline is suppressed.| +|`-e`|Interpretation of the following backslash-escaped characters (below) is enabled.| +|`-E`|Disables the interpretation of these escape characters, even on systems where they are interpreted by default.| ### Escape sequences - Escape Description - -------------- --------------------------------------------------------------------------------------------------------------- - `\a` alert (bell) - `\b` backspace - `\c` suppress further output - `\e` - `\E` an escape character - `\f` form feed - `\n` new line - `\r` carriage return - `\t` horizontal tab - `\v` vertical tab - `\\` backslash - `\0nnn` the eight-bit character whose value is the octal value nnn (zero to three octal digits) - `\xHH` the eight-bit character whose value is the hexadecimal value HH (one or two hex digits) - `\uHHHH` the Unicode (ISO/IEC 10646) character whose value is the hexadecimal value HHHH (one to four hex digits) - `\UHHHHHHHH` the Unicode (ISO/IEC 10646) character whose value is the hexadecimal value HHHHHHHH (one to eight hex digits) +|Escape|Description| +|------|-----------| +|`\a`|alert (bell)| +|`\b`|backspace| +|`\c`|suppress further output| +|`\e`| +|`\E`|an escape character| +|`\f`|form feed| +|`\n`|new line| +|`\r`|carriage return| +|`\t`|horizontal tab| +|`\v`|vertical tab| +|`\\`|backslash| +|`\0nnn`|the eight-bit character whose value is the octal value nnn (zero to three octal digits)| +|`\xHH`|the eight-bit character whose value is the hexadecimal value HH (one or two hex digits)| +|`\uHHHH`|the Unicode (ISO/IEC 10646) character whose value is the hexadecimal value HHHH (one to four hex digits)| +|`\UHHHHHHHH`|the Unicode (ISO/IEC 10646) character whose value is the hexadecimal value HHHHHHHH (one to eight hex digits)| ## Examples diff --git a/docs/commands/builtin/exec.md b/docs/commands/builtin/exec.md index 84676ce..3775a17 100644 --- a/docs/commands/builtin/exec.md +++ b/docs/commands/builtin/exec.md @@ -17,11 +17,11 @@ shell without executing any program. ### Options - Option Description - ----------- ---------------------------------------------------------------------------------------------------------------------- - `-a NAME` Passes `NAME` as zeroth argument for the program to be executed - `-c` Execute the program with an empty (cleared) environment - `-l` Prepends a dash (`-`) to the zeroth argument of the program to be executed, similar to what the `login` program does +|Option|Description| +|------|-----------| +|`-a NAME`|Passes `NAME` as zeroth argument for the program to be executed| +|`-c`|Execute the program with an empty (cleared) environment| +|`-l`|Prepends a dash (`-`) to the zeroth argument of the program to be executed, similar to what the `login` program does| ### Exit status diff --git a/docs/commands/builtin/exit.md b/docs/commands/builtin/exit.md index b2272e9..de91bd0 100644 --- a/docs/commands/builtin/exit.md +++ b/docs/commands/builtin/exit.md @@ -25,9 +25,9 @@ There are no options. Naturally, you can't ask for the exit status from within the shell that executed the `exit` command, because the shell exits. - Status Reason - -------- ---------------------------------------------------------------------------- - 255 invalid (e.g. non-numeric) argument - this staus is returned to the parent +|Status|Reason| +|------|------| +|255|invalid (e.g. non-numeric) argument - this staus is returned to the parent| ## Examples diff --git a/docs/commands/builtin/export.md b/docs/commands/builtin/export.md index 95a350e..517efb7 100644 --- a/docs/commands/builtin/export.md +++ b/docs/commands/builtin/export.md @@ -14,21 +14,21 @@ it. ### Options - Option Description - -------- ------------------------------------------------------------------------------------------------------------ - `-f` refer to shell functions - `-n` remove the export property from any referenced `NAME` - `-p` print all exported variables, with `-f`, print all exported functions - all in a format re-usable as input +|Option|Description| +|------|-----------| +|`-f`|refer to shell functions| +|`-n`|remove the export property from any referenced `NAME`| +|`-p`|print all exported variables, with `-f`, print all exported functions - all in a format re-usable as input| An argument of `--` disables further option processing. ### Return status - Status Reason - -------- --------------------------- - 0 no error - !=0 invalid option - !=0 a given `NAME` is invalid +|Status|Reason| +|------|------| +|0|no error| +|!=0|invalid option| +|!=0|a given `NAME` is invalid| ## Examples diff --git a/docs/commands/builtin/kill.md b/docs/commands/builtin/kill.md index a534e1f..614c3aa 100644 --- a/docs/commands/builtin/kill.md +++ b/docs/commands/builtin/kill.md @@ -32,22 +32,22 @@ external `kill` command of the operating system to ### Options - Option Description - ------------------- ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- - `-s SIGNAL` specifies the signal to send - `-n SIGNALNUMBER` specifies the signal to send - `-SIGNAL` specifies the signal to send - `-l [SIGNAL...]` Lists supported/known signal numbers and their symbolic name. If `SIGNAL` is given, only list this signal, translated (if a number is given the symbolic name is printed, and vice versa) - `-L [SIGNAL...]` Same as `-l [SIGNAL]` (compatiblity option) +|Option|Description| +|------|-----------| +|`-s SIGNAL`|specifies the signal to send| +|`-n SIGNALNUMBER`|specifies the signal to send| +|`-SIGNAL`|specifies the signal to send| +|`-l [SIGNAL...]`|Lists supported/known signal numbers and their symbolic name. If `SIGNAL` is given, only list this signal, translated (if a number is given the symbolic name is printed, and vice versa)| +|`-L [SIGNAL...]`|Same as `-l [SIGNAL]` (compatiblity option)| ### Return status - Status Reason - -------- ----------------------------------------------------------------------------------------------------- - 0 no error/success - !=0 invalid option - !=0 invalid signal specification - !=0 error returned by the system function (e.g. insufficient permissions to send to a specific process) +|Status|Reason| +|------|------| +|0|no error/success| +|!=0|invalid option| +|!=0|invalid signal specification| +|!=0|error returned by the system function (e.g. insufficient permissions to send to a specific process)| ## Examples diff --git a/docs/commands/builtin/mapfile.md b/docs/commands/builtin/mapfile.md index 8f5108a..bd2c3c7 100644 --- a/docs/commands/builtin/mapfile.md +++ b/docs/commands/builtin/mapfile.md @@ -19,15 +19,15 @@ target array must be a "normal" integer indexed array. `mapfile` returns success (0) unless an invalid option is given or the given array `ARRAY` is set readonly. - Option Description - --------------- --------------------------------------------------------------------------------------------------------------------------------------------------------------- - `-c QUANTUM` Specifies the number of lines that have to be read between every call to the callback specified with `-C`. The default QUANTUM is 5000 - `-C CALLBACK` Specifies a callback. The string `CALLBACK` can be any shell code, the index of the array that will be assigned, and the line is appended at evaluation time. - `-n COUNT` Reads at most `COUNT` lines, then terminates. If `COUNT` is 0, then all lines are read (default). - `-O ORIGIN` Starts populating the given array `ARRAY` at the index `ORIGIN` rather than clearing it and starting at index 0. - `-s COUNT` Discards the first `COUNT` lines read. - `-t` Remove any trailing newline from a line read, before it is assigned to an array element. - `-u FD` Read from filedescriptor `FD` rather than standard input. +|Option|Description| +|------|-----------| +|`-c QUANTUM`|Specifies the number of lines that have to be read between every call to the callback specified with `-C`. The default QUANTUM is 5000| +|`-C CALLBACK`|Specifies a callback. The string `CALLBACK` can be any shell code, the index of the array that will be assigned, and the line is appended at evaluation time.| +|`-n COUNT`|Reads at most `COUNT` lines, then terminates. If `COUNT` is 0, then all lines are read (default).| +|`-O ORIGIN`|Starts populating the given array `ARRAY` at the index `ORIGIN` rather than clearing it and starting at index 0.| +|`-s COUNT`|Discards the first `COUNT` lines read.| +|`-t`|Remove any trailing newline from a line read, before it is assigned to an array element.| +|`-u FD`|Read from filedescriptor `FD` rather than standard input.| While `mapfile` isn't a common or portable shell feature, it's functionality will be familiar to many programmers. Almost all diff --git a/docs/commands/builtin/read.md b/docs/commands/builtin/read.md index 42e8d03..fa3aa59 100644 --- a/docs/commands/builtin/read.md +++ b/docs/commands/builtin/read.md @@ -39,19 +39,19 @@ line is read). That means the timeout can occur during input, too. ### Options - Option Description - ---------------- ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- - `-a ` read the data word-wise into the specified array `` instead of normal variables - `-d ` recognize `` as data-end, rather than `` - `-e` on interactive shells: use Bash's readline interface to read the data. Since version 5.1-alpha, this can also be used on specified file descriptors using `-u` - `-i ` preloads the input buffer with text from ``, only works when Readline (`-e`) is used - `-n ` reads `` characters of input, then quits - `-N ` reads `` characters of input, *ignoring any delimiter*, then quits - `-p ` the prompt string `` is output (without a trailing automatic newline) before the read is performed - `-r` raw input - **disables** interpretion of **backslash escapes** and **line-continuation** in the read data - `-s` secure input - don't echo input if on a terminal (passwords!) - `-t ` wait for data `` seconds, then quit (exit code 1). Fractional seconds ("5.33") are allowed since Bash 4. A value of 0 immediately returns and indicates if data is waiting in the exit code. Timeout is indicated by an exit code greater than 128. If timeout arrives before data is read completely (before end-of-line), the partial data is saved. - `-u ` use the filedescriptor number `` rather than `stdin` (0) +|Option|Description| +|------|-----------| +|`-a `|read the data word-wise into the specified array `` instead of normal variables| +|`-d `|recognize `` as data-end, rather than ``| +|`-e`|on interactive shells: use Bash's readline interface to read the data. Since version 5.1-alpha, this can also be used on specified file descriptors using `-u`| +|`-i `|preloads the input buffer with text from ``, only works when Readline (`-e`) is used| +|`-n `|reads `` characters of input, then quits| +|`-N `|reads `` characters of input, *ignoring any delimiter*, then quits| +|`-p `|the prompt string `` is output (without a trailing automatic newline) before the read is performed| +|`-r`|raw input - **disables** interpretion of **backslash escapes** and **line-continuation** in the read data| +|`-s`|secure input - don't echo input if on a terminal (passwords!)| +|`-t `|wait for data `` seconds, then quit (exit code 1). Fractional seconds ("5.33") are allowed since Bash 4. A value of 0 immediately returns and indicates if data is waiting in the exit code. Timeout is indicated by an exit code greater than 128. If timeout arrives before data is read completely (before end-of-line), the partial data is saved.| +|`-u `|use the filedescriptor number `` rather than `stdin` (0)| When both, `-a ` and a variable name `` is given, then the array is set, but not the variable. @@ -61,38 +61,35 @@ Of course it's valid to set individual array elements without using read MYARRAY[5] - +!!! WARNING + Reading into array elements using the syntax above **may cause [pathname + expansion](../../syntax/expansion/globs.md) to occur**. -Reading into array elements using the syntax above **may cause [pathname -expansion](../../syntax/expansion/globs.md) to occur**. + Example: You are in a directory with a file named `x1`, and you want to + read into an array `x`, index `1` with -Example: You are in a directory with a file named `x1`, and you want to -read into an array `x`, index `1` with + read x[1] - read x[1] + then pathname expansion will expand to the filename `x1` and break your + processing! -then pathname expansion will expand to the filename `x1` and break your -processing! + Even worse, if `nullglob` is set, your array/index will disappear. -Even worse, if `nullglob` is set, your array/index will disappear. + To avoid this, either **disable pathname expansion** or **quote** the + array name and index: -To avoid this, either **disable pathname expansion** or **quote** the -array name and index: - - read 'x[1]' - - + read 'x[1]' ### Return status - Status Reason - -------- --------------------------------------------------- - 0 no error - 0 error when assigning to a read-only variable [^1] - 2 invalid option - >128 timeout (see `-t`) - !=0 invalid filedescriptor supplied to `-u` - !=0 end-of-file reached +|Status|Reason| +|------|------| +|0|no error| +|0|error when assigning to a read-only variable [^1]| +|2|invalid option| +|>128|timeout (see `-t`)| +|!=0|invalid filedescriptor supplied to `-u`| +|!=0|end-of-file reached| ### read without -r diff --git a/docs/dict/exit_status.md b/docs/dict/exit_status.md index fdc3390..9d041fc 100644 --- a/docs/dict/exit_status.md +++ b/docs/dict/exit_status.md @@ -32,15 +32,15 @@ The code is a number between 0 and 255, where the part from 126 to 255 is reserved to be used by the Bash shell directly or for special purposes, like reporting a termination by a signal: - Code Description - --------- ------------------------------------------------------------------------------------------------------------------------------------------------------------ - 0 success - 1-255 failure (in general) - 126 the requested command (file) can't be executed (but was found) - 127 command (file) not found - 128 according to ABS it's used to report an invalid argument to the exit builtin, but I wasn't able to verify that in the source code of Bash (see code 255) - 128 + N the shell was terminated by the signal N (also used like this by various other programs) - 255 wrong argument to the exit builtin (see code 128) +|Code|Description| +|----|-----------| +|0|success| +|1-255|failure (in general)| +|126|the requested command (file) can't be executed (but was found)| +|127|command (file) not found| +|128|according to ABS it's used to report an invalid argument to the exit builtin, but I wasn't able to verify that in the source code of Bash (see code 255)| +|128+N|the shell was terminated by the signal N (also used like this by various other programs)| +|255|wrong argument to the exit builtin (see code 128)| The lower codes 0 to 125 are not reserved and may be used for whatever the program likes to report. A value of **0 means successful** @@ -56,85 +56,51 @@ negation (`! pipeline`). ### Misc - -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- - test bash\ bash\ zsh 5.0.2\ ksh93\ mksh\ posh\ dash\ busybox\ heirloom\ - 4.2.45 (POSIX) (emulate ksh) 93v- 2013-03-18 R44 2013/02/24 0.11 0.5.7.3 1.2.1 050706 - ----------------------------------------------------------------------------------------------------- -------- --------- --------------- ----------------- ---------------- ------- --------- ---------- ----------- - `` :; : `false` `echo $? >&2` `` 1 1 1 1 0 0 0 0 1 +|test|bash 4.2.45|bash (POSIX)|zsh 5.0.2 (emulate ksh)|ksh93 93v- 2013-03-18|mksh R44 2013/02/24|posh 0.11|dash 0.5.7.3|busybox 1.2.1|heirloom 050706| +|--|--|--|--|--|--|--|--|--|--| +|
:; : \`false\` \`echo $? >&2\`
|1|1|1|1|0|0|0|0|1| +|
false; eval; echo $?
|0|0|0|0|0|1|0|1|0| +|
x=\`false\` eval echo $?
|1|1|1|1|0|0|0|0|1| +|
eval echo \$? <&0\`false\`
|1|1|1|1|0|0|0|0|1| +|
while :; do ! break; done; echo $?
|1|1|1|1|0|0|1|1|-| +|
false; :| echo $?

[discussion](https://lists.gnu.org/archive/html/bug-bash/2010-09/msg00009.html)|1|1|1|0|1|1|1|1|0| +|
(exit 2); for x in "\`exit 3\`"; do echo $?; done
|3|3|3|3|2|2|0|0|3| - `false; eval; echo $?` 0 0 0 0 0 1 0 1 0 - - `` x=`false` eval echo \$? `` 1 1 1 1 0 0 0 0 1 - - `` eval echo \$? <&0`false` `` 1 1 1 1 0 0 0 0 1 - - `while :; do ! break; done; echo $?` 1 1 1 1 0 0 1 1 - - - [discussion](https://lists.gnu.org/archive/html/bug-bash/2010-09/msg00009.html)`false; : | echo $?` 1 1 1 0 1 1 1 1 0 - - `` (exit 2); for x in "`exit 3`"; do echo $?; done `` 3 3 3 3 2 2 0 0 3 - -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ### functions Measuring side-effects during the function call, during return, and transparency of the return builtin. - ------------------------------------------------------------------------------------------------------------------------------------------- - test bash bash\ zsh\ ksh93 mksh posh dash busybox heirloom - (POSIX) (emulate ksh) - -------------------------------------------------------- ------ --------- --------------- ------- ------ ------ ------ --------- ---------- - `` f() { echo $?; }; :; f `false` `` 1 1 1 1 0 0 0 0 1 - - `f() { return; }; false; f; echo $?` 1 1 1 0 1 1 1 1 1 - - `f() { return $?; }; false; f; echo $?` 1 1 1 1 1 1 1 1 1 - - `f() { ! return; }; f; echo $?` 0 0 1 0 0 0 1 1 - - - `f() { ! return; }; false; f; echo $?` 1 1 0 0 1 1 0 0 - - - `` f() { return; }; x=`false` f; echo $? `` 1 1 1 1 0 0 0 0 0 - - `` f() { return; }; f <&0`false`; echo $? `` 1 1 1 1 0 0 0 0 1 - - `` f() { x=`false` return; }; f; echo $? `` 1 1 1 0 0 0 0 0 1 - - `` f() { return <&0`false`; }; f; echo $? `` 1 1 1 0 0 0 0 0 1 - - `` f() { x=`false` return <&0`false`; }; f; echo $? `` 1 1 1 1 0 0 0 0 1 - ------------------------------------------------------------------------------------------------------------------------------------------- +|test|bash|bash
(POSIX)|zsh
(emulate ksh)|ksh93|mksh|posh|dash|busybox|heirloom +|--|--|--|--|--|--|--|--|--|--| +|
f() { echo $?; }; :; f \`false\`
|1|1|1|1|0|0|0|0|1| +|
f() { return; }; false; f; echo $?
|1|1|1|0|1|1|1|1|1| +|
f() { return $?; }; false; f; echo $?
|1|1|1|1|1|1|1|1|1| +|
f() { ! return; }; f; echo $?
|0|0|1|0|0|0|1|1|-| +|
f() { ! return; }; false; f; echo $?
|1|1|0|0|1|1|0|0|-| +|
f() { return; }; x=\`false\` f; echo $?
|1|1|1|1|0|0|0|0|0| +|
f() { return; }; f <&0\`false\`; echo $?
|1|1|1|1|0|0|0|0|1| +|
f() { x=\`false\` return; }; f; echo $?
|1|1|1|0|0|0|0|0|1| +|
f() { return <&0\`false\`; }; f; echo $?
|1|1|1|0|0|0|0|0|1| +|
f() { x=\`false\` return <&0\`false\`; }; f; echo $?
|1|1|1|1|0|0|0|0|1| ### case..esac Statuses measured within the command and after, with matching and non-matching patterns. - ------------------------------------------------------------------------------------------------------------------------------------------------- - test bash bash\ zsh\ ksh93 mksh posh dash busybox heirloom - (POSIX) (emulate ksh) - -------------------------------------------------------------- ------ --------- --------------- ------- ------ ------ ------ --------- ---------- - `(exit 2); case x in x) echo $?;; esac` 2 2 0 2 2 2 0 0 2 - - `` (exit 2); case `exit 3`x in x) echo $?;; esac `` 3 3 0 3 2 2 0 0 3 - - `` (exit 2); case x in `exit 4`x) echo $?;; esac `` 4 4 4 4 2 2 0 0 4 - - `` (exit 2); case `exit 3`x in `exit 4`x) echo $?;; esac `` 4 4 4 4 2 2 0 0 4 - - `(exit 2); case x in x);; esac; echo $?` 0 0 0 0 0 0 0 0 2 - - `(exit 2); case x in "");; esac; echo $?` 0 0 0 0 0 0 0 0 2 - - `` (exit 2); case `exit 3`x in x);; esac; echo $? `` 0 0 0 3 0 0 0 0 3 - - `` (exit 2); case `exit 3`x in "");; esac; echo $? `` 0 0 0 3 0 0 0 0 3 - - `` (exit 2); case x in `exit 4`x);; esac; echo $? `` 0 0 0 4 0 0 0 0 4 - - `` (exit 2); case x in `exit 4`);; esac; echo $? `` 0 0 4 4 0 0 0 0 4 - - `` (exit 2); case `exit 3`x in `exit 4`);; esac; echo $? `` 0 0 4 4 0 0 0 0 4 - - `` (exit 2); case `exit 3`x in `exit 4`x);; esac; echo $? `` 0 0 0 4 0 0 0 0 4 - ------------------------------------------------------------------------------------------------------------------------------------------------- +|test|bash|bash
(POSIX)|zsh
(emulate ksh)|ksh93|mksh|posh|dash|busybox|heirloom| +|--|--|--|--|--|--|--|--|--|--| +|
(exit 2); case x in x) echo $?;; esac
|2|2|0|2|2|2|0|0|2| +|
 (exit 2); case \`exit 3\`x in x) echo $?;; esac
|3|3|0|3|2|2|0|0|3| +|
 (exit 2); case x in \`exit 4\`x) echo $?;; esac
|4|4|4|4|2|2|0|0|4| +|
 (exit 2); case \`exit 3\`x in \`exit 4\`x) echo $?;; esac
|4|4|4|4|2|2|0|0|4| +|
(exit 2); case x in x);; esac; echo $?
|0|0|0|0|0|0|0|0|2| +|
(exit 2); case x in "");; esac; echo $?
|0|0|0|0|0|0|0|0|2| +|
(exit 2); case \`exit 3\`x in x);; esac; echo $?
|0|0|0|3|0|0|0|0|3| +|
(exit 2); case \`exit 3\`x in "");; esac; echo $?
|0|0|0|3|0|0|0|0|3| +|
(exit 2); case x in \`exit 4\`x);; esac; echo $?
|0|0|0|4|0|0|0|0|4| +|
(exit 2); case x in \`exit 4\`);; esac; echo $?
|0|0|4|4|0|0|0|0|4| +|
(exit 2); case \`exit 3\`x in \`exit 4\`);; esac; echo $?
|0|0|4|4|0|0|0|0|4| +|
 (exit 2); case \`exit 3\`x in \`exit 4\`x);; esac; echo $?
|0|0|0|4|0|0|0|0|4| diff --git a/docs/howto/pax.md b/docs/howto/pax.md index af15f57..4b52c37 100644 --- a/docs/howto/pax.md +++ b/docs/howto/pax.md @@ -38,12 +38,12 @@ There are four basic operation modes to *list*, *read*, *write* and *copy* archives. They're switched with combinations of `-r` and `-w` command line options: - Mode RW-Options - ------- ----------------- - List *no RW-options* - Read `-r` - Write `-w` - Copy `-r -w` +|Mode|RW-Options| +|----|----------| +|List|*no RW-options*| +|Read|`-r`| +|Write|`-w`| +|Copy|`-r -w`| #### List @@ -99,14 +99,14 @@ creates `ustar` if no options are specified). The following archive formats are supported (Berkeley implementation): - --------- ---------------------------- - ustar POSIX TAR format (default) - cpio POSIX CPIO format - tar classic BSD TAR format - bcpio old binary CPIO format - sv4cpio SVR4 CPIO format - sv4crc SVR4 CPIO format with CRC - --------- ---------------------------- +| | | +|--|--| +|ustar|POSIX TAR format (default)| +|cpio|POSIX CPIO format| +|tar|classic BSD TAR format| +|bcpio|old binary CPIO format| +|sv4cpio|SVR4 CPIO format| +|sv4crc|SVR4 CPIO format with CRC| Berkeley `pax` supports options `-z` and `-j`, similar to GNU `tar`, to filter archive files through GZIP/BZIP2. @@ -337,13 +337,13 @@ in your `~/.bashrc` can be useful :-D. Here is a quick table comparing (GNU) `tar` and `pax` to help you to make the switch: - TAR PAX Notes - ------------------------------------- ------------------------------------------ ----------------------------------------------------------------------- - `tar xzvf file.tar.gz` `pax -rvz -f file.tar.gz` `-z` is an extension, POSIXly: `gunzip archive.tar.gz` - `tar xjvf file.tar.bz2` `bunzip2 archive.tar.bz2` - `tar tzvf file.tar.gz` `pax -vz -f file.tar.gz` `-z` is an extension, POSIXly: `gunzip archive.tar.gz`| +|`tar xjvf file.tar.bz2`|`bunzip2 archive.tar.bz2`| +|`tar tzvf file.tar.gz`|`pax -vz -f file.tar.gz`|`-z` is an extension, POSIXly: `gunzip **Attention:**When the -specified interpreter is unavailable or not executable (permissions), -you usually get a "`bad interpreter`" error message., If you get -nothing and it fails, check the shebang. Older Bash versions will -respond with a "`no such file or directory`" error for a nonexistant -interpreter specified by the shebang. +!!! WARNING + **Attention:**When the + specified interpreter is unavailable or not executable (permissions), + you usually get a "`bad interpreter`" error message., If you get + nothing and it fails, check the shebang. Older Bash versions will + respond with a "`no such file or directory`" error for a nonexistant + interpreter specified by the shebang. **Additional note:** When you specify `#!/bin/sh` as shebang and that's a link to a Bash, then Bash will run in POSIX(r) mode! See: @@ -130,16 +131,16 @@ and system-variable names are usually all in UPPERCASE. However, you should avoid naming your variables any of the following (incomplete list!): - ---------------- ------------- ---------------- --------------- ------------------ ----------------- - `BASH` `BASH_ARGC` `BASH_ARGV` `BASH_LINENO` `BASH_SOURCE` `BASH_VERSINFO` - `BASH_VERSION` `COLUMNS` `DIRSTACK` `DISPLAY` `EDITOR` `EUID` - `GROUPS` `HISTFILE` `HISTFILESIZE` `HISTSIZE` `HOME` `HOSTNAME` - `IFS` `LANG` `LANGUAGE` `LC_ALL` `LINES` `LOGNAME` - `LS_COLORS` `MACHTYPE` `MAILCHECK` `OLDPWD` `OPTERR` `OPTIND` - `OSTYPE` `PATH` `PIPESTATUS` `PPID` `PROMPT_COMMAND` `PS1` - `PS2` `PS4` `PS3` `PWD` `SHELL` `SHELLOPTS` - `SHLVL` `TERM` `UID` `USER` `USERNAME` `XAUTHORITY` - ---------------- ------------- ---------------- --------------- ------------------ ----------------- +| | | | | | | +|--|--|--|--|--|--| +|`BASH`|`BASH_ARGC`|`BASH_ARGV`|`BASH_LINENO`|`BASH_SOURCE`|`BASH_VERSINFO`| +|`BASH_VERSION`|`COLUMNS`|`DIRSTACK`|`DISPLAY`|`EDITOR`|`EUID`| +|`GROUPS`|`HISTFILE`|`HISTFILESIZE`|`HISTSIZE`|`HOME`|`HOSTNAME`| +|`IFS`|`LANG`|`LANGUAGE`|`LC_ALL`|`LINES`|`LOGNAME`| +|`LS_COLORS`|`MACHTYPE`|`MAILCHECK`|`OLDPWD`|`OPTERR`|`OPTIND`| +|`OSTYPE`|`PATH`|`PIPESTATUS`|`PPID`|`PROMPT_COMMAND`|`PS1`| +|`PS2`|`PS4`|`PS3`|`PWD`|`SHELL`|`SHELLOPTS`| +|`SHLVL`|`TERM`|`UID`|`USER`|`USERNAME`|`XAUTHORITY`| This list is incomplete. **The safest way is to use all-lowercase variable names.** diff --git a/docs/scripting/newbie_traps.md b/docs/scripting/newbie_traps.md index 3705471..d56157f 100644 --- a/docs/scripting/newbie_traps.md +++ b/docs/scripting/newbie_traps.md @@ -154,12 +154,12 @@ Let's define an example variable containing text with spaces: example="Hello world" - Used form result number of words - -------------- --------------- ----------------- - `$example` `Hello world` 2 - `"$example"` `Hello world` 1 - `\$example` `$example` 1 - `'$example'` `$example` 1 +|Used form|result|number of words| +|---------|------|---------------| +|`$example`|`Hello world`|2| +|`"$example"`|`Hello world`|1| +|`\$example`|`$example`|1| +|`'$example'`|`$example`|1| If you use parameter expansion, you **must** use the **name** (`PATH`) of the referenced variables/parameters. i.e. **not** (`$PATH`): diff --git a/docs/scripting/terminalcodes.md b/docs/scripting/terminalcodes.md index 96c1996..bf73621 100644 --- a/docs/scripting/terminalcodes.md +++ b/docs/scripting/terminalcodes.md @@ -89,37 +89,23 @@ terminals. ### Cursor handling - ------------------------------------------------------------------------------------------------------------------------------- - ANSI terminfo equivalent Description - ----------------------------------------- --------------------- --------------------------------------------------------------- - `[ ; H`\ `cup ` Home-positioning to `X` and `Y` coordinates\ - `[ ; f` :!: it seems that ANSI uses 1-1 as home while `tput` uses 0-0 - - `[ H` `home` Move cursor to home position (0-0) - - `7` `sc` Save current cursor position - - `8` `rc` Restore saved cursor position - - :?: most likely a normal code like `\b` `cub1` move left one space (backspace) - - VT100 `[ ? 25 l` `civis` make cursor invisible - - VT100 `[ ? 25 h` `cvvis` make cursor visible - ------------------------------------------------------------------------------------------------------------------------------- +|ANSI | terminfo equivalent | Description | +|----------------------------------------|---------------------|-------------| +|`[ ; H`
`[ ; f`|`cup `|Home-positioning to `X` and `Y` coordinates
:!: it seems that ANSI uses 1-1 as home while `tput` uses 0-0| +|`[ H`|`home`|Move cursor to home position (0-0)| +|`7`|`sc`|Save current cursor position| +|`8`|`rc`|Restore saved cursor position| +|:?: most likely a normal code like `\b`|`cub1`|move left one space (backspace)| +|VT100 `[ ? 25 l`|`civis`|make cursor invisible| +|VT100 `[ ? 25 h`|`cvvis`|make cursor visible| ### Erasing text - ------------------------------------------------------------------------------------------------ - ANSI terminfo equivalent Description - --------- --------------------- ---------------------------------------------------------------- - `[ K`\ `el` **Clear line** from current cursor position **to end** of line - `[ 0 K` - - `[ 1 K` `el1` **Clear line from beginning** to current cursor position - - `[ 2 K` `el2`:?: **Clear whole line** (cursor position unchanged) - ------------------------------------------------------------------------------------------------ +|ANSI |terminfo equivalent |Description| +|---------|---------------------|-----------| +|`[ K`
`[ 0 K`|`el`|**Clear line** from current cursor position **to end** of line| +|`[ 1 K`|`el1`|**Clear line from beginning** to current cursor position| +|`[ 2 K`|`el2` :?:|**Clear whole line** (cursor position unchanged)| ### General text attributes @@ -133,6 +119,7 @@ terminals. |`[ 5 m`|`blink`|Set "blink" attribute| |`[ 7 m`|`rev`|Set "reverse" attribute| |`[ 8 m`|`invis`|Set "hidden" attribute| + ### Foreground coloring |ANSI|terminfo equivalent|Description| diff --git a/docs/snipplets/awkcsv.md b/docs/snipplets/awkcsv.md index bd1b9e9..b484c5d 100644 --- a/docs/snipplets/awkcsv.md +++ b/docs/snipplets/awkcsv.md @@ -1,10 +1,11 @@ +--- +tags: + - awk + - csv +--- + # Using `awk` to deal with CSV that uses quoted/unquoted delimiters ----- dataentry snipplet ---- snipplet_tags : awk, csv -LastUpdate_dt : 2010-07-31 Contributors : SiegX (IRC) type : snipplet - ------------------------------------------------------------------------- - CSV files are a mess, yes. Assume you have CSV files that use the comma as delimiter and quoted @@ -21,11 +22,11 @@ Solution: Use the field separator `", "|^"|"$` for `awk`. This is an OR-ed list of 3 possible separators: - -------- ----------------------------------------------- - `", "` matches the area between the datafields - `^"` matches the area left of the first datafield - `"$` matches the area right of the last data field - -------- ----------------------------------------------- +| | | +|--------|----------------------------------------------| +|`", "` | matches the area between the datafields| +|`^"` | matches the area left of the first datafield| +|`"$` | matches the area right of the last data field| You can tune these delimiters if you have other needs (for example if you don't have a space after the commas). diff --git a/docs/snipplets/wrapperargs.md b/docs/snipplets/wrapperargs.md index 9078a70..3947ce3 100644 --- a/docs/snipplets/wrapperargs.md +++ b/docs/snipplets/wrapperargs.md @@ -1,15 +1,15 @@ +--- +tags: + - arguments + - quoting + - escape + - quote + - wrapper + - generate +--- + # Generate code with own arguments properly quoted ----- dataentry snipplet ---- snipplet_tags: arguments, quoting, -escaping, wrapper LastUpdate_dt: 2010-07-31 Contributors: Jan Schampera -type: snipplet - ------------------------------------------------------------------------- - - Keywords: arguments,escape,quote,wrapper,generate - -------------- ----------------------------------------- - Contributor: self - There are situations where Bash code needs to generate Bash code. A script that writes out another script the user or cron may start, for example. diff --git a/docs/syntax/pe.md b/docs/syntax/pe.md index 9d90e47..26ed6dd 100644 --- a/docs/syntax/pe.md +++ b/docs/syntax/pe.md @@ -322,10 +322,10 @@ will try to remove the shortest text matching the pattern, while following examples to get the idea (matched text ~~marked striked~~, remember it will be removed!): - Syntax Result - -------------------- ---------------------------------------------------------------------- - `${MYSTRING#*in}` ~~Be liberal in~~ what you accept, and conservative in what you send - `${MYSTRING##*in}` ~~Be liberal in what you accept, and conservative in~~ what you send +|Syntax|Result| +|------|------| +|`${MYSTRING#*in}`|~~Be liberal in~~ what you accept, and conservative in what you send| +|`${MYSTRING##*in}`|~~Be liberal in what you accept, and conservative in~~ what you send| ### From the end @@ -334,10 +334,10 @@ remember it will be removed!): In the second form everything will be the same, except that Bash now tries to match the pattern from the end of the string: - Syntax Result - -------------------- ---------------------------------------------------------------------- - `${MYSTRING%in*}` Be liberal in what you accept, and conservative ~~in what you send~~ - `${MYSTRING%%in*}` Be liberal ~~in what you accept, and conservative in what you send~~ +|Syntax|Result| +|------|------| +|`${MYSTRING%in*}`|Be liberal in what you accept, and conservative ~~in what you send~~| +|`${MYSTRING%%in*}`|Be liberal ~~in what you accept, and conservative in what you send~~| The second form nullifies variables that begin with `in`, by working from the end. diff --git a/docs/syntax/shellvars.md b/docs/syntax/shellvars.md index 030bfcc..a21678f 100644 --- a/docs/syntax/shellvars.md +++ b/docs/syntax/shellvars.md @@ -233,14 +233,14 @@ A readonly array variable whose members hold version information for this instance of Bash. The values assigned to the array members are as follows: - -------------------- ---------------------------------------- - BASH_VERSINFO\[0\] The major version number (the release) - BASH_VERSINFO\[1\] The minor version number (the version) - BASH_VERSINFO\[2\] The patch level - BASH_VERSINFO\[3\] The build version - BASH_VERSINFO\[4\] The release status (e.g., beta1) - BASH_VERSINFO\[5\] The value of `MACHTYPE` - -------------------- ---------------------------------------- +|--|--| +|--|--| +|BASH_VERSINFO\[0\]|The major version number (the release)| +|BASH_VERSINFO\[1\]|The minor version number (the version)| +|BASH_VERSINFO\[2\]|The patch level| +|BASH_VERSINFO\[3\]|The build version| +|BASH_VERSINFO\[4\]|The release status (e.g., beta1)| +|BASH_VERSINFO\[5\]|The value of `MACHTYPE`| ### BASH_VERSION @@ -316,13 +316,13 @@ current command, the value of this variable is equal to `${#COMP_LINE}`. Set to an integer value corresponding to the type of completion attempted that caused a completion function to be called: - ------- --------------------------------------------------- - `TAB` normal completion - `?` listing completions after successive tabs - `!` listing alternatives on partial word completion - `@` to list completions if the word is not unmodified - `%` for menu completion - ------- --------------------------------------------------- +|--|--| +|--|--| +|`TAB`|normal completion| +|`?`|listing completions after successive tabs| +|`!`|listing alternatives on partial word completion| +|`@`|to list completions if the word is not unmodified| +|`%`|for menu completion| !!! warning "FIXME" where are the integer values? @@ -1047,7 +1047,7 @@ selected with a variable starting with `LC_`. ### LC_ALL | Variable: |`LC_ALL` |Since: |unknown| - -------------- ----------------- ------------ --------- +| -------------- |----------------- |------------ |---------| | Type: |normal variable |Read-only: |no| | Set by Bash: |no |Default: |n/a| From 267eb1add1b7a305bce3a8780b6fe08111199166 Mon Sep 17 00:00:00 2001 From: Sahal Ansari Date: Fri, 18 Oct 2024 18:29:52 -0500 Subject: [PATCH 2/5] formatting fixes for parameter expansion - my favorite article. --- docs/syntax/pe.md | 131 +++++++++++++++++++++++++--------------------- 1 file changed, 72 insertions(+), 59 deletions(-) diff --git a/docs/syntax/pe.md b/docs/syntax/pe.md index 26ed6dd..803108f 100644 --- a/docs/syntax/pe.md +++ b/docs/syntax/pe.md @@ -52,47 +52,47 @@ For a more technical view what a parameter is and which types exist, Looking for a specific syntax you saw, without knowing the name? -- [Simple usage](#simple_usage) +- [Simple usage](#simple-usage) - `$PARAMETER` - `${PARAMETER}` - [Indirection](#indirection) - `${!PARAMETER}` -- [Case modification](#case_modification) +- [Case modification](#case-modification) - `${PARAMETER^}` - `${PARAMETER^^}` - `${PARAMETER,}` - `${PARAMETER,,}` - `${PARAMETER~}` - `${PARAMETER~~}` -- [Variable name expansion](#variable_name_expansion) +- [Variable name expansion](#variable-name-expansion) - `${!PREFIX*}` - `${!PREFIX@}` -- [Substring removal](#substring_removal) (also for **filename +- [Substring removal](#substring-removal) (also for **filename manipulation**!) - `${PARAMETER#PATTERN}` - `${PARAMETER##PATTERN}` - `${PARAMETER%PATTERN}` - `${PARAMETER%%PATTERN}` -- [Search and replace](#search_and_replace) +- [Search and replace](#search-and-replace) - `${PARAMETER/PATTERN/STRING}` - `${PARAMETER//PATTERN/STRING}` - `${PARAMETER/PATTERN}` - `${PARAMETER//PATTERN}` -- [String length](#string_length) +- [String length](#string-length) - `${#PARAMETER}` -- [Substring expansion](#substring_expansion) +- [Substring expansion](#substring-expansion) - `${PARAMETER:OFFSET}` - `${PARAMETER:OFFSET:LENGTH}` -- [Use a default value](#use_a_default_value) +- [Use a default value](#use-a-default-value) - `${PARAMETER:-WORD}` - `${PARAMETER-WORD}` -- [Assign a default value](#assign_a_default_value) +- [Assign a default value](#assign-a-default-value) - `${PARAMETER:=WORD}` - `${PARAMETER=WORD}` -- [Use an alternate value](#use_an_alternate_value) +- [Use an alternate value](#use-an-alternate-value) - `${PARAMETER:+WORD}` - `${PARAMETER+WORD}` -- [Display error if null or unset](#display_error_if_null_or_unset) +- [Display error if null or unset](#display-error-if-null-or-unset) - `${PARAMETER:?WORD}` - `${PARAMETER?WORD}` @@ -226,14 +226,11 @@ The `^` operator modifies the first character to uppercase, the `,` operator to lowercase. When using the double-form (`^^` and `,,`), all characters are converted. - - -The (**currently undocumented**) operators `~` and `~~` reverse the case -of the given text (in `PARAMETER`).`~` reverses the case of first letter -of words in the variable while `~~` reverses case for all. Thanks to -`Bushmills` and `geirha` on the Freenode IRC channel for this finding. - - +!!! INFO + The (**currently undocumented**) operators `~` and `~~` reverse the case + of the given text (in `PARAMETER`).`~` reverses the case of first letter + of words in the variable while `~~` reverses case for all. Thanks to + `Bushmills` and `geirha` on the Freenode IRC channel for this finding. **Example: Rename all `*.txt` filenames to lowercase** @@ -270,9 +267,8 @@ Assume: `array=(This is some Text)` - => `This Is Some Text` - `echo "${array[@]^^}"` - => `THIS IS SOME TEXT` - - * ''echo "${array[2]^^}"'' - * => ''SOME'' +- `echo "${array[2]^^}"` + - => `SOME` ## Variable name expansion @@ -351,16 +347,16 @@ filename**. Just look at the following list with examples: - **Get name without extension** - `${FILENAME%.*}` - - => `bash_hackers.txt` + - => bash_hackers.txt - **Get extension** - `${FILENAME##*.}` - - => `bash_hackers.txt` + - => bash_hackers.txt - **Get directory name** - `${PATHNAME%/*}` - - => `/home/bash/bash_hackers.txt` + - => /home/bash/bash_hackers.txt - **Get filename** - `${PATHNAME##*/}` - - => `/home/bash/bash_hackers.txt` + - => /home/bash/bash_hackers.txt These are the syntaxes for filenames with a single extension. Depending on your needs, you might need to adjust shortest/longest match. @@ -413,7 +409,7 @@ example string: ${MYSTRING//conservative/happy} => -`Be liberal in what you accept, and conservativehappy in what you send` +Be liberal in what you accept, and conservativehappy in what you send Since there is only one "conservative" in that example, it really doesn't matter which of the two forms we use. @@ -425,14 +421,14 @@ but let's substitute it with "by". ${MYSTRING/in/by} -=> `Be liberal inby what you accept, and conservative in what you send` +Be liberal inby what you accept, and conservative by what you send **Second form: Substitute all occurrences** ${MYSTRING//in/by} => -`Be liberal inby what you accept, and conservative inby what you send` +Be liberal inby what you accept, and conservative inby what you send **Anchoring** Additionally you can "anchor" an expression: A `#` (hashmark) will indicate that your expression is @@ -536,7 +532,7 @@ that the offset 0 is the first character: echo ${MYSTRING:35} => -`Be liberal in what you accept, and conservative in what you send` +Be liberal in what you accept, and conservative in what you send ### Using Offset and Length @@ -545,7 +541,7 @@ In the second form we also give a length value: echo ${MYSTRING:35:12} => -`Be liberal in what you accept, and conservative in what you send` +Be liberal in what you accept, and conservative in what you send ### Negative Offset Value @@ -570,7 +566,7 @@ then: echo "${MYSTRING:11:-17}" => -`Be liberal in what you accept, and conservative in what you send` +Be liberal in what you accept, and conservative in what you send This works since Bash 4.2-alpha, see also [bashchanges](../scripting/bashchanges.md). @@ -823,9 +819,11 @@ Removing the first 6 characters from a text string: parameters plus the adjacent expansion are concatenated into a single argument. As a workaround, each expansion needs to be quoted separately. Unfortunately, this bug took a very long time to - notice.`~ $ set -- a b c; x=foo; printf '<%s> ' "$@$x" "$*""$x" "$@""$x" + notice. + ``` + ~ $ set -- a b c; x=foo; printf '<%s> ' "$@$x" "$*""$x" "$@""$x" - ` + ``` - Almost all shells disagree about the treatment of an unquoted `$@`, `${arr[@]}`, `$*`, and `${arr[*]}` when @@ -836,7 +834,9 @@ Removing the first 6 characters from a text string: are few good reasons to leave `IFS` set to null for more than the duration of a command or two, and even fewer to expand `$@` and `$*` unquoted, this should be a rare issue. **Always quote - them**!`touch x 'y z' + them**! + ``` + touch x 'y z' for sh in bb {{d,b}a,{m,}k,z}sh; do echo "$sh" "$sh" -s a 'b c' d \* " $@ echo EOF - ``bb + ``` + ``` + bb dash @@ -866,7 +868,8 @@ Removing the first 6 characters from a text string: zsh - `When `IFS` is set to a non-null value, or unset, all shells behave + ``` + When `IFS` is set to a non-null value, or unset, all shells behave the same - first expanding into separate args, then applying pathname expansion and word-splitting to the results, except for zsh, which doesn't do pathname expansion in its default mode. @@ -875,7 +878,9 @@ Removing the first 6 characters from a text string: the behavior of inserting delimiter characters from IFS in `$*`, and the way adjacent arguments are concatenated, when IFS is modified in the middle of expansion through - side-effects.`for sh in bb {{d,b}a,po,{m,}k,z}sh; do + side-effects. + ``` + for sh in bb {{d,b}a,po,{m,}k,z}sh; do printf '%-4s: ' "$sh" "$sh" ' ${*}${IFS=}${*}${IFS:=-}"${*}" echo EOF - ``bb : + ``` + ``` + bb : dash: bash: posh: mksh: ksh : zsh : - `ksh93 and mksh can additionally achieve this side effect (and + ``` + ksh93 and mksh can additionally achieve this side effect (and others) via the `${ cmds;}` expansion. I haven't yet tested every possible side-effect that can affect expansion halfway through expansion that way. @@ -920,7 +928,8 @@ Removing the first 6 characters from a text string: if the first part is out of range, the second won't be evaluated. ksh93 and mksh always evaluate the subscript parts even if the parameter is unset. - ` $ bash -c 'n="y[\$(printf yo >&2)1]" m="y[\$(printf jo >&2)1]"; x=(); echo "${x[@]:n,6:m}"' # No output + ``` + $ bash -c 'n="y[\$(printf yo >&2)1]" m="y[\$(printf jo >&2)1]"; x=(); echo "${x[@]:n,6:m}"' # No output $ bash -c 'n="y[\$(printf yo >&2)1]" m="y[\$(printf jo >&2)1]"; x=([5]=hi); echo "${x[@]:n,6:m}"' yo $ bash -c 'n="y[\$(printf yo >&2)1]" m="y[\$(printf jo >&2)1]"; x=([6]=hi); echo "${x[@]:n,6:m}"' @@ -929,7 +938,7 @@ Removing the first 6 characters from a text string: yojo $ bash -c 'n="y[\$(printf yo >&2)1]" m="y[\$(printf jo >&2)1]"; x=12345; echo "${x:n,6:m}"' yo - ` + ``` ### Quote Nesting @@ -937,26 +946,30 @@ Removing the first 6 characters from a text string: expansion that expands to multiple words, and nesting such expansions, not all combinations of nested quoting are possible. - # Bash - $ typeset -a a=(meh bleh blerg) b - $ IFS=e - $ printf "<%s> " "${b[@]-"${a[@]}" "${a[@]}"}"; echo # The entire PE is quoted so Bash considers the inner quotes redundant. - - $ printf "<%s> " "${b[@]-${a[@]} ${a[@]}}"; echo # The outer quotes cause the inner expansions to be considered quoted. - - $ b=(meep beep) - $ printf "<%s> " "${b[@]-"${a[@]}" "${a[@]}"}" "${b[@]-${a[@]} ${a[@]}}"; echo # Again no surprises. Outer quotes quote everything recursively. - +``` +# Bash + $ typeset -a a=(meh bleh blerg) b + $ IFS=e + $ printf "<%s> " "${b[@]-"${a[@]}" "${a[@]}"}"; echo # The entire PE is quoted so Bash considers the inner quotes redundant. + + $ printf "<%s> " "${b[@]-${a[@]} ${a[@]}}"; echo # The outer quotes cause the inner expansions to be considered quoted. + + $ b=(meep beep) + $ printf "<%s> " "${b[@]-"${a[@]}" "${a[@]}"}" "${b[@]-${a[@]} ${a[@]}}"; echo # Again no surprises. Outer quotes quote everything recursively. + +``` Now lets see what can happen if we leave the outside unquoted. - # Bash - $ typeset -a a=(meh bleh blerg) b - $ IFS=e - $ printf "<%s> " ${b[@]-"${a[@]}" "${a[@]}"}; echo # Inner quotes make inner expansions quoted. - - $ printf "<%s> " ${b[@]-${a[@]} ${a[@]}}; echo' # No quotes at all wordsplits / globs, like you'd expect. - +``` +# Bash + $ typeset -a a=(meh bleh blerg) b + $ IFS=e + $ printf "<%s> " ${b[@]-"${a[@]}" "${a[@]}"}; echo # Inner quotes make inner expansions quoted. + + $ printf "<%s> " ${b[@]-${a[@]} ${a[@]}}; echo' # No quotes at all wordsplits / globs, like you'd expect. + +``` This all might be intuitive, and is the most common implementation, but this design sucks for a number of reasons. For one, it means Bash makes From 3fa162799845bdc77138a8e7bb138643ee643faf Mon Sep 17 00:00:00 2001 From: Sahal Ansari Date: Fri, 18 Oct 2024 22:52:27 -0500 Subject: [PATCH 3/5] updated remaining WRAP blocks with Mkdocs Admonitions --- docs/commands/builtin/let.md | 13 +++++++------ docs/commands/builtin/read.md | 19 +++++++++---------- docs/howto/mutex.md | 5 +++-- 3 files changed, 19 insertions(+), 18 deletions(-) diff --git a/docs/commands/builtin/let.md b/docs/commands/builtin/let.md index 1d4f1ca..5f1c2db 100644 --- a/docs/commands/builtin/let.md +++ b/docs/commands/builtin/let.md @@ -41,12 +41,13 @@ command](../../syntax/ccmd/arithmetic_eval.md): $ echo "$a - $b - $?" 4 - 2 - 0 - Remember that inside arithmetic evaluation contexts, all -other expansions are processed as usual (from left-to-right), and the -resulting text is evaluated as an arithmetic expression. Arithmetic -already has a way to control precedence using parentheses, so it's very -rare to need to nest arithmetic expansions within one another. It's -used above only to illustrate how this precedence works. +!!! INFO "" + Remember that inside arithmetic evaluation contexts, all + other expansions are processed as usual (from left-to-right), and the + resulting text is evaluated as an arithmetic expression. Arithmetic + already has a way to control precedence using parentheses, so it's very + rare to need to nest arithmetic expansions within one another. It's + used above only to illustrate how this precedence works. Unlike `((`, being a simple command `let` has its own environment. In Bash, built-ins that can set variables process any arithmetic under diff --git a/docs/commands/builtin/read.md b/docs/commands/builtin/read.md index fa3aa59..830c72a 100644 --- a/docs/commands/builtin/read.md +++ b/docs/commands/builtin/read.md @@ -20,17 +20,16 @@ If `` is given, the line is word-split using ``. The remaining words are all assigned to the last `` if more words than variable names are present. - If no `` is given, the whole line -read (without performing word-splitting!) is assigned to the shell -variable [REPLY](../../syntax/shellvars.md#REPLY). Then, `REPLY` really contains -the line as it was read, without stripping pre- and postfix spaces and -other things! +!!! INFO + If no `` is given, the whole line + read (without performing word-splitting!) is assigned to the shell + variable [REPLY](../../syntax/shellvars.md#REPLY). Then, `REPLY` really contains + the line as it was read, without stripping pre- and postfix spaces and + other things! - while read -r; do - printf '"%s"\n' "$REPLY" - done <<<" a line with prefix and postfix space " - - + while read -r; do + printf '"%s"\n' "$REPLY" + done <<<" a line with prefix and postfix space " If a timeout is given, or if the shell variable [TMOUT](../../syntax/shellvars.md#TMOUT) is set, it is counted from initially diff --git a/docs/howto/mutex.md b/docs/howto/mutex.md index a765882..211356b 100644 --- a/docs/howto/mutex.md +++ b/docs/howto/mutex.md @@ -61,8 +61,9 @@ they are succesfully locked, and can operate without colliding. Setting the timestamp is similar: One step to check the timespamp, a second step to set the timestamp. - **Conclusion:** We need an -operation that does the check and the locking in one step. +!!! NOTE "" + **Conclusion:** We need an + operation that does the check and the locking in one step. A simple way to get that is to create a **lock directory** - with the mkdir command. It will: From 304c1df565e2168361407a5121e6c45873e58590 Mon Sep 17 00:00:00 2001 From: Sahal Ansari Date: Fri, 18 Oct 2024 23:01:02 -0500 Subject: [PATCH 4/5] fix improper escape. --- docs/scripting/newbie_traps.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/scripting/newbie_traps.md b/docs/scripting/newbie_traps.md index d56157f..ea80acc 100644 --- a/docs/scripting/newbie_traps.md +++ b/docs/scripting/newbie_traps.md @@ -116,7 +116,7 @@ for example When you need the **content** of a variable, you prefix its name with **a dollar-sign**, like -- echo \"The used picture is: \$picture\" + echo "The used picture is: $picture" #### Whitespace From 1b9b1fcc5db5741e70a60a6e3e5d2b85dacea47d Mon Sep 17 00:00:00 2001 From: Sahal Ansari Date: Fri, 18 Oct 2024 23:15:49 -0500 Subject: [PATCH 5/5] added script to generate diff table for PRs. --- scripts/generate-diff-links.sh | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100755 scripts/generate-diff-links.sh diff --git a/scripts/generate-diff-links.sh b/scripts/generate-diff-links.sh new file mode 100755 index 0000000..f538fd6 --- /dev/null +++ b/scripts/generate-diff-links.sh @@ -0,0 +1,26 @@ +#!/usr/bin/env bash + +set -o errexit +set -o nounset + +GIT_HASH="${1:-50aeb31ff80e7bdde9b8edd50ab924e3791fe606}" + +BASE_LOCAL_URL="http://127.0.0.1:8000/bash-hackers-wiki/" +BASE_DEPLOY_URL="https://flokoe.github.io/bash-hackers-wiki/" +BASE_ARCHIVE_URL="https://web.archive.org/web/20230127020427/https://wiki.bash-hackers.org/" + +# Table Headers +cat << EOF +|Filename|Local Version|Deployed Version|Archive Version| +|--|--|--|--| +EOF + +for file in $(git show --name-only "${GIT_HASH}" | grep md$); do + filename_no_docs_prefix="${file#*docs/}" + filename_no_ext="${filename_no_docs_prefix%.*}" + echo "|"${filename_no_docs_prefix} \ + "|[${filename_no_ext}](${BASE_LOCAL_URL}${filename_no_ext})" \ + "|[${filename_no_ext}](${BASE_DEPLOY_URL}${filename_no_ext})" \ + "|[${filename_no_ext}](${BASE_ARCHIVE_URL}${filename_no_ext})|" +done +