summaryrefslogtreecommitdiffstats
path: root/txr.1
diff options
context:
space:
mode:
authorKaz Kylheku <kaz@kylheku.com>2015-11-20 06:10:38 -0800
committerKaz Kylheku <kaz@kylheku.com>2015-11-20 16:17:20 -0800
commit2f8d42ce8308fa4668213e8410d5abb204b0e712 (patch)
tree7321ab58549bc4d9fe36a0403b26b7ecce373824 /txr.1
parent3c09800abda31a3f5da8157b0ef2863850f6b662 (diff)
downloadtxr-2f8d42ce8308fa4668213e8410d5abb204b0e712.tar.gz
txr-2f8d42ce8308fa4668213e8410d5abb204b0e712.tar.bz2
txr-2f8d42ce8308fa4668213e8410d5abb204b0e712.zip
TXR_COMPAT option.
* txr.c (txr_main): Implement handling of TXR_COMPAT environment variable. Also, before entering interactive mode, if compatibility has been set via TXR_COMPAT, emit an informative message about this. * txr.1: Documented TXR_COMPAT.
Diffstat (limited to 'txr.1')
-rw-r--r--txr.132
1 files changed, 31 insertions, 1 deletions
diff --git a/txr.1 b/txr.1
index 067e9b85..045d760e 100644
--- a/txr.1
+++ b/txr.1
@@ -664,6 +664,12 @@ supports that behavior, or even that exact version.
If the option is specified more than once, the behavior is not specified.
+Compatibility can also be requested via the
+.code TXR_COMPAT
+environment variable instead of the
+.code -C
+option.
+
For more information, see the COMPATIBILITY section.
.meIP >> --gc-delta= number
@@ -37894,7 +37900,31 @@ option can be used to request emulation of old behavior.
The option was introduced in \*(TX 98, and so the oldest \*(TX version which
can be emulated is \*(TX 97.
-Here are version values which have a special meaning as arguments to the
+Side effects occur in the processing of the option. If the option is specified
+multiple times, the behavior is unspecified.
+
+.coNP Environment variable @ TXR_COMPAT
+
+If the
+.code TXR_COMPAT
+environment variable exists, and its value is not en empty string,
+it must contain a decimal integer. Its value is taken by \*(TX as a request
+to emulate old behaviors, just like the value of the
+.code -C
+option.
+
+If the variable has incorrect contents or an out-of-range value,
+\*(TX will print an error diagnostic and exit.
+
+If both
+.code -C
+and the
+.code TXR_COMPAT
+environment variable are supplied, the behavior is unspecified.
+
+.coNP Compatibility Version Values
+
+The following version values which have a special meaning as arguments to the
.code -C
option, along with a description of what behaviors are affected. For each
of these version values, the described behaviors are provided if