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
commit6d59713bfd1e8aa23aba10622e9686f9a8c2b138 (patch)
tree84c85d78774ff290203ad40a10d171a844593b46
parent77cf6015476ef9ae6a8f0e190afbec76b6561f66 (diff)
downloadtxr-6d59713bfd1e8aa23aba10622e9686f9a8c2b138.tar.gz
txr-6d59713bfd1e8aa23aba10622e9686f9a8c2b138.tar.bz2
txr-6d59713bfd1e8aa23aba10622e9686f9a8c2b138.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 # .