summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorG. Branden Robinson <g.branden.robinson@gmail.com>2023-04-24 07:50:18 -0500
committerG. Branden Robinson <g.branden.robinson@gmail.com>2023-04-24 23:46:36 -0500
commit05b804f05583e8675e9c5df812c3ca0f89721cb7 (patch)
tree91686e43f2b31162190ddc0e94a1e29b588b586e /man
parent3778beb2e00f28262c02de2bea7db5915c734c2b (diff)
downloadgroff-git-05b804f05583e8675e9c5df812c3ca0f89721cb7.tar.gz
[docs]: Tweak escape/control character discussion.
* Introduce term "ordinary character", an input character that is not invalid (cf. "special character"). * Recast discussion of control, no-break control, and escape control characters in terms of ordinary characters, ruling out the surmise that a special character can serve as any of these. * Parallelize wording of these. * Tighten and align wording with this terminology.
Diffstat (limited to 'man')
-rw-r--r--man/groff.7.man63
1 files changed, 33 insertions, 30 deletions
diff --git a/man/groff.7.man b/man/groff.7.man
index 8c50052bc..07944567d 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -1254,28 +1254,29 @@ containing them is surrounded by parentheses.
.\" ====================================================================
.
.\" BEGIN Keep (roughly) parallel with groff.texi node "Identifiers".
-GNU
+An identifier is a label for an object of syntactical importance:
+a register,
+name
+(macro,
+string,
+or diversion),
+typeface,
+color,
+special character,
+character class,
+environment,
+or stream.
+.
+Valid identifiers consist of one or more ordinary characters.
+.
+An
+.I ordinary character
+is an input character that is not a leader,
+tab,
+newline,
+or invalid as GNU
.I troff \" GNU
-has rules for properly formed
-.IR identifiers \[em]labels
-for objects with syntactical importance,
-like registers,
-names
-(macros,
-strings,
-or diversions),
-typefaces,
-glyphs,
-colors,
-character classes,
-environments,
-and streams.
-.
-An identifier consists of one or more characters excepting
-spaces,
-tabs,
-newlines,
-and invalid input characters.
+input.
.
.
.\" XXX: We might move this discussion earlier since it is applicable to
@@ -2577,9 +2578,10 @@ Reset no-break control character to
.dquoted_char \[aq] .
.
.TPx
-.REQ .c2 "c"
-Set no-break control character to
-.IR c .
+.REQ .c2 "o"
+Recognize ordinary character
+.I o
+as the no-break control character.
.
.TPx
.REQ .cc
@@ -2587,9 +2589,10 @@ Reset control character to
.squoted_char . .
.
.TPx
-.REQ .cc "c"
-Set control character to
-.IR c .
+.REQ .cc "o"
+Recognize ordinary character
+.I o
+as the control character.
.
.TPx
.REQ .ce
@@ -2951,9 +2954,9 @@ as the escape character.
.
.
.TPx
-.REQ .ec "c"
-Recognize
-.I c
+.REQ .ec "o"
+Recognize ordinary character
+.I o
as the escape character.
.
.