[BACK]Return to escname.in CVS log [TXT][DIR] Up to [cvsweb.bsd.lv] / mandoc / regress / roff / nr

File: [cvsweb.bsd.lv] / mandoc / regress / roff / nr / escname.in (download)

Revision 1.3, Fri Jun 3 12:16:01 2022 UTC (2 years ago) by schwarze
Branch: MAIN
CVS Tags: HEAD
Changes since 1.2: +5 -3 lines

During identifier parsing, handle undefined escape sequences
in the same way as groff:
* \\ is always reduced to \
* \. is always reduced to .
* other undefined escape sequences are usually reduced to the escape name,
for example \G to G, except during the expansion of expanding escape
sequences having the standard argument form (in particular \* and \n),
in which case the backslash is preserved literally.

Yes, this is confusing indeed.
For example, the following have the same meaning:
* .ds \.   and   .ds .     which is not the same as   .ds \\.
* \*[\.]   and   \*[.]     which is not the same as   \*[\\.]
* .ds \G   and   .ds G     which is not the same as   .ds \\G
* \*[\G]   and   \*[\\G]   which is not the same as   \*[G]   <- sic!

To feel less dirty, have a leaning toothpick, if you are so inclined.

This patch also slightly improves the string shown by the "escaped
character not allowed in a name" error message.

.\" $OpenBSD: escname.in,v 1.4 2022/06/03 11:50:25 schwarze Exp $
.TH NR-ESCNAME 1 "June 3, 2022"
.SH NAME
nr-escname \- escape sequences in register names
.SH DESCRIPTION
.nr first 1
.nr second 2
.nr first\\second 3
.nr first\esecond 4
.nr first\.second 5
.nr first\Gsecond 6
\n[first] \n[second] \n[first\\second] \n[first.second] \n[firstGsecond]
.PP
.rr first\esecond
\n[first] \n[second] \n[first\\second]
.PP
.rr first\\second
\n[first] \n[second] \n[first\\second]
.PP
incomplete: \n[second