summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorKaz Kylheku <kaz@kylheku.com>2020-12-31 06:32:03 -0800
committerKaz Kylheku <kaz@kylheku.com>2020-12-31 06:32:03 -0800
commit82d3ade3689462caa8864470b5edf5c281fc9861 (patch)
tree7fc12eba2b9076bc24a4adc8f6c91d1640caad46
parent21f4b2adb8e238ed996ec676056b77e9560b08d9 (diff)
downloadtxr-82d3ade3689462caa8864470b5edf5c281fc9861.tar.gz
txr-82d3ade3689462caa8864470b5edf5c281fc9861.tar.bz2
txr-82d3ade3689462caa8864470b5edf5c281fc9861.zip
doc: improve awk fconv documenation.
* txr.1: List the no-conversion - operator among the shortcuts, so it is easier to discover. Add a note that that fconv is potentially applicable to non-string fields.
-rw-r--r--txr.116
1 files changed, 16 insertions, 0 deletions
diff --git a/txr.1 b/txr.1
index 8f9260d4..98612ad7 100644
--- a/txr.1
+++ b/txr.1
@@ -58372,6 +58372,8 @@ Thus fields which are non-numeric strings or the object
.code nil
get converted to 0, or 0.0 in the case of
.codn rz .
+.coIP -
+Performs no conversion: the corresponding field is taken as-is.
.RE
.IP
Because
@@ -58399,6 +58401,20 @@ expression can be used as the condition in an
clause which triggers the action if one or more fields have been
extracted, and performs conversions on them.
+
+Note: although
+.code fconv
+is intended for converting textual fields, and the semantic descriptions below
+consequently make references to string inputs, the behavior of
+.code fconv
+with respect to non-string fields can be inferred. For instance if a field
+actually holds the floating-point value 3.14, and the
+.code i
+conversion is applied to it, it will produce 3, because it works by
+means of the
+.code toint
+function which.
+
.TP* Examples:
.verb