From 6d59713bfd1e8aa23aba10622e9686f9a8c2b138 Mon Sep 17 00:00:00 2001
From: Kaz Kylheku <kaz@kylheku.com>
Date: Wed, 24 May 2017 20:20:43 -0700
Subject: 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.
---
 txr.1 | 27 ++++++++++++++++++++-------
 1 file 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 # .
 
-- 
cgit v1.2.3