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

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

Revision 1.7, Fri Jun 3 12:15:58 2022 UTC (2 years ago) by schwarze
Branch: MAIN
CVS Tags: HEAD
Changes since 1.6: +9 -7 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.

mandoc: escname.in:22:2: ERROR: escaped character not allowed in a name: first\e
mandoc: escname.in:32:10: WARNING: undefined escape, printing literally: \G
mandoc: escname.in:51:7: WARNING: undefined escape, printing literally: \G
mandoc: escname.in:55:19: ERROR: escaped character not allowed in a name: first\e
mandoc: escname.in:56:2: ERROR: skipping unknown macro: .first
mandoc: escname.in:58:2: ERROR: skipping unknown macro: .first\second 
mandoc: escname.in:61:5: ERROR: skipping excess arguments: .de ... excess arguments
mandoc: escname.in:64:1: ERROR: escaped character not allowed in a name: witharg\(en
mandoc: escname.in:66:1: ERROR: escaped character not allowed in a name: de\e
mandoc: escname.in:66:2: WARNING: skipping empty request: de