summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorKaz Kylheku <kaz@kylheku.com>2021-08-25 07:37:13 -0700
committerKaz Kylheku <kaz@kylheku.com>2021-08-25 07:37:13 -0700
commita2ef505ea974292a2647999e32a8d3119bc30501 (patch)
tree0f108a61b26f5fa9f320529c157ff89a014b4b41
parent98ec48bea40e4e80d25b26c99fbe44fc3e98459f (diff)
downloadtxr-a2ef505ea974292a2647999e32a8d3119bc30501.tar.gz
txr-a2ef505ea974292a2647999e32a8d3119bc30501.tar.bz2
txr-a2ef505ea974292a2647999e32a8d3119bc30501.zip
doc: improvement in awk range operators.
* txr.1: Prompted by a sentence with faulty grammar, improving the description of the table which summarizes the semantics of the nine range operators.
-rw-r--r--txr.128
1 files changed, 20 insertions, 8 deletions
diff --git a/txr.1 b/txr.1
index 729c5dd3..8977491d 100644
--- a/txr.1
+++ b/txr.1
@@ -64290,11 +64290,16 @@ expression yields a Boolean true value when it is evaluated in the context
of processing any of the records which are included in the range.
The table below summarizes the semantic variations of these nine
-range macro operators. The leftmost column represents the file of records
-being processed. The remaining columns indicate, using the character
+range macro operators. The leftmost column labeled
+.code DATA
+represents the stream of records being processed. Each entry in this column gives
+the literal piece of text which comprises the content of one record in the stream.
+The remaining nine columns, labeled with the nine range operators, inform about
+the behavior of these operators with respect to these records. In each of these
+columns the letter
.code X
-those rows for each of the nine range operators yield true. Each operator
-is assumed to be invoked with the arguments
+marks those records for which the column's range operator yields true,
+if it is invoked with the arguments
.code #/H/
and
.code #/T/
@@ -64302,10 +64307,16 @@ as its
.meta from-condition
and
.metn to-condition ,
-respectively: for example,
+respectively.
+For example, the
+.code rng
+column the values of the
.code "(rng #/H/ #/T/)"
-in the case of
-.codn rng :
+expression, indicating that the expression starts being true when the
+.code H1
+record is seen, stays true for the
+.code T1
+record, and then reverts to false:
.verb
DATA rng -rng rng- -rng- --rng --rng- rng+ -rng+ --rng+
@@ -64322,7 +64333,8 @@ in the case of
EPILOG
.brev
-The prefix or suffix characters are mnemonic. A single
+The prefix and suffix characters of the operator names are intended
+to be mnemonic. A single
.code -
(dash) indicates the exclusion of one record. A double
.code --