summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorKaz Kylheku <kaz@kylheku.com>2017-05-24 20:20:43 -0700
committerKaz Kylheku <kaz@kylheku.com>2017-05-24 20:20:43 -0700
commit14ce6cae2aac2931fa7f895fade2c3cac627cddd (patch)
tree84c85d78774ff290203ad40a10d171a844593b46
parentc75baad41d9e6cbe11d83e208ccfe35c18a6b19d (diff)
downloadtxr-14ce6cae2aac2931fa7f895fade2c3cac627cddd.tar.gz
txr-14ce6cae2aac2931fa7f895fade2c3cac627cddd.tar.bz2
txr-14ce6cae2aac2931fa7f895fade2c3cac627cddd.zip
doc: clean up description of bident and lident.
* txr.1: Fix false, contradictory text claiming that an underscore may be part of a bident but not sident. (Reported by user "death" on Reddit). Add clarifying text explaining that only the slash character may be in a lident but not bident, and improve some surrounding text.
-rw-r--r--txr.127
1 files changed, 20 insertions, 7 deletions
diff --git a/txr.1 b/txr.1
index a3277998..0acaa2a0 100644
--- a/txr.1
+++ b/txr.1
@@ -1583,7 +1583,7 @@ which are not allowed in a
.metn sident :
.cblk
- ! $ % & * + - < = > ? \e _ ~
+ ! $ % & * + - < = > ? \e ~
.cble
The rule still holds that a name cannot look like a number so
@@ -10552,18 +10552,31 @@ all the same characters, as well as the
.metn bident .
Thus a
.meta lident
-may consist of these characters, in addition to letters and numbers:
+may consist of these characters, in addition to letters, numbers and
+underscores:
.cblk
- ! $ % & * + - < = > ? \e _ ~ /
+ ! $ % & * + - < = > ? \e ~ /
.cble
-and of course, may not look like a number. A lone
+and of course, may not look like a number.
+
+The character allowed in a
+.meta lident
+but not in a
+.meta bident
+is
.code /
-is a symbol in \*(TL. The token
+(forward slash).
+
+A lone
+.code /
+is a valid
+.meta lident
+and consequently a symbol token in \*(TL. The token
.code /abc/
-is also a symbol, and not a regular expression, like it is in the braced
-variable syntax. Within \*(TL, regular expressions are written with
+is also a symbol, and, unlike in a braced expression, is not a regular
+expression. In \*(TL expressions, regular expressions are written with
a leading
.codn # .