Project

General

Profile

Actions

Bug #11193

closed

cmn_err.9f: UNSUPP: unsupported escape sequences

Added by Michal Nowak over 3 years ago. Updated over 3 years ago.

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

100%

Estimated time:
Difficulty:
Bite-size
Tags:
Gerrit CR:
External Bug:

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.5ClosedMichal Nowak

Actions
Actions #1

Updated by Michal Nowak over 3 years ago

Actions #2

Updated by Michal Nowak over 3 years 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/

Actions #3

Updated by Electric Monk over 3 years 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>

Actions #4

Updated by Michal Nowak over 3 years 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

Actions

Also available in: Atom PDF