sed.1: add some missing info - sbase - suckless unix tools | |
git clone git://git.suckless.org/sbase | |
Log | |
Files | |
Refs | |
README | |
LICENSE | |
--- | |
commit 782afdf8c6202298a35f37bbe6eaedc5f63a7776 | |
parent 20c27b1ad0f2fae65ede721c43f8cb66186d3049 | |
Author: Andrea Calligaris <[email protected]> | |
Date: Fri, 6 Dec 2024 10:37:37 +0100 | |
sed.1: add some missing info | |
There are some features that are coded already, might as well document them. | |
Diffstat: | |
M sed.1 | 22 ++++++++++++++++++++-- | |
1 file changed, 20 insertions(+), 2 deletions(-) | |
--- | |
diff --git a/sed.1 b/sed.1 | |
@@ -50,16 +50,32 @@ Append the commands from | |
to the list of editing commands. | |
.El | |
.Sh EXTENDED DESCRIPTION | |
-Editing commands take the form | |
+Editing commands take the form: | |
.Pp | |
[address[,address]]function | |
+.Pp | |
+Commands can be separated by ';' or by a new line. | |
+.Pp | |
+Multiple functions for the specified address (or address-range) can be enclosed | |
+in blocks with '{' and '}': | |
+.Pp | |
+[address[,address]] { function ; function } | |
+.Pp | |
.Ss Addresses | |
Addresses are either blank, a positive decimal integer denoting a line | |
number, the character '$' denoting the last line of input, or a regular | |
-expression. | |
+expression (in the format | |
+.No / Ns | |
+.Ar regexp Ns /). | |
A command with no addresses matches every line, one address matches | |
individual lines, and two addresses matches a range of lines from the | |
first to the second address inclusive. | |
+.Pp | |
+The character '!' may be appended after the addresses, | |
+in which case the function is executed only if the addresses | |
+.Em don't | |
+match. | |
+.Pp | |
.Ss Functions | |
.Bl -tag -width Ds | |
.It Ar a Op Ar text | |
@@ -152,6 +168,8 @@ Replace each occurrence of a character from set 1 with the … | |
character from set 2. | |
.It Ar :label | |
Create a label for b and t commands. | |
+.It Ar #comment | |
+The comment extends until the next newline. | |
.It Ar = | |
Write current input line number to output. | |
.El |