diff options
author | G. Branden Robinson <g.branden.robinson@gmail.com> | 2023-04-24 07:50:18 -0500 |
---|---|---|
committer | G. Branden Robinson <g.branden.robinson@gmail.com> | 2023-04-24 23:46:36 -0500 |
commit | 05b804f05583e8675e9c5df812c3ca0f89721cb7 (patch) | |
tree | 91686e43f2b31162190ddc0e94a1e29b588b586e /man | |
parent | 3778beb2e00f28262c02de2bea7db5915c734c2b (diff) | |
download | groff-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.man | 63 |
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. . . |