Project

General

Profile

Bug #11193

cmn_err.9f: UNSUPP: unsupported escape sequences

Added by Michal Nowak 5 months ago. Updated 4 months ago.

Status:
Closed
Priority:
Normal
Assignee:
Category:
manpage - manual pages
Start date:
Due date:
% Done:

100%

Estimated time:
Difficulty:
Bite-size
Tags:

Description

Linting cmn_err.9f with mandoc 1.14.5 (https://www.illumos.org/issues/11190) reveals following UNSUPP warnings:

$ mandoc -Tlint -Wwarning ~/ws/illumos-gate/usr/src/man/man9f/cmn_err.9f 
mandoc: /export/home/newman/ws/illumos-gate/usr/src/man/man9f/cmn_err.9f:191:8: UNSUPP: unsupported escape sequence: \!
mandoc: /export/home/newman/ws/illumos-gate/usr/src/man/man9f/cmn_err.9f:195:8: UNSUPP: unsupported escape sequence: \?
mandoc: /export/home/newman/ws/illumos-gate/usr/src/man/man9f/cmn_err.9f:205:8: UNSUPP: unsupported escape sequence: \?
mandoc: /export/home/newman/ws/illumos-gate/usr/src/man/man9f/cmn_err.9f:356:8: UNSUPP: unsupported escape sequence: \?

Related issues

Related to illumos gate - Feature #11190: Update mandoc to 1.14.5Closed

Actions

History

#1

Updated by Michal Nowak 5 months ago

#2

Updated by Michal Nowak 5 months ago

Solution (https://man.openbsd.org/mandoc.1#Warnings_related_to_macros_and_nesting) to this matter is to insert & into the "escape sequence", e.g. \?\&?.

RB: https://illumos.org/rb/r/1972/

#3

Updated by Electric Monk 4 months ago

  • Status changed from New to Closed
  • % Done changed from 0 to 100

git commit 1f2dca3250468910bc4ef4471eb91650e6a39379

commit  1f2dca3250468910bc4ef4471eb91650e6a39379
Author: Michal Nowak <mnowak@startmail.com>
Date:   2019-06-13T19:07:15.000Z

    11193 cmn_err.9f: UNSUPP: unsupported escape sequences
    Reviewed by: Andy Fiddaman <omnios@citrus-it.co.uk>
    Reviewed by: Robert Mustacchi <rm@joyent.com>
    Approved by: Dan McDonald <danmcd@joyent.com>

#4

Updated by Michal Nowak 4 months ago

Testing

Before:

$ mandoc -Tlint -Wwarning ~/ws/illumos-gate/usr/src/man/man9f/cmn_err.9f 
mandoc: /export/home/newman/ws/illumos-gate/usr/src/man/man9f/cmn_err.9f:191:8: UNSUPP: unsupported escape sequence: \!
mandoc: /export/home/newman/ws/illumos-gate/usr/src/man/man9f/cmn_err.9f:195:8: UNSUPP: unsupported escape sequence: \?
mandoc: /export/home/newman/ws/illumos-gate/usr/src/man/man9f/cmn_err.9f:205:8: UNSUPP: unsupported escape sequence: \?
mandoc: /export/home/newman/ws/illumos-gate/usr/src/man/man9f/cmn_err.9f:356:8: UNSUPP: unsupported escape sequence: \?

After:

$ mandoc -Tlint -Wwarning /usr/share/man/man9f/cmn_err.9f 

$ mandoc -l /usr/share/man/man9f/cmn_err.9f

     !       The message goes only to the system log.
     ...
     ?       If level is also CE_CONT, the message is always sent to the
     ...
     condition is met, the "?" character has no effect and is simply
     ...
     Because of the leading "?" character in the format string, this

Also available in: Atom PDF