commit 782afdf8c6202298a35f37bbe6eaedc5f63a7776
Author: Andrea Calligaris <ac89.hk.pub...@gmail.com>
AuthorDate: Fri Dec 6 10:37:37 2024 +0100
Commit: Roberto E. Vargas Caballero <k...@shike2.com>
CommitDate: Tue Dec 17 11:25:12 2024 +0100
sed.1: add some missing info
There are some features that are coded already, might as well document them.
diff --git a/sed.1 b/sed.1
index 5ccce6d..b7c6098 100644
--- 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
corresponding
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
