Project

General

Profile

Bug #11192

zpool.1m: UNSUPP: unsupported escape sequence: \?

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 zpool.1m with mandoc 1.14.5 (https://www.illumos.org/issues/11190) reveals following UNSUPP warnings:

$ mandoc -Tlint -Wwarning ~/ws/illumos-gate/usr/src/man/man1m/zpool.1m 
mandoc: /export/home/newman/ws/illumos-gate/usr/src/man/man1m/zpool.1m:37:5: UNSUPP: unsupported escape sequence: \?
mandoc: /export/home/newman/ws/illumos-gate/usr/src/man/man1m/zpool.1m:833:5: 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/1971/

#3

Updated by Electric Monk 4 months ago

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

git commit 2da8e96eb94b431165f3682ff0231d2ac4422c94

commit  2da8e96eb94b431165f3682ff0231d2ac4422c94
Author: Michal Nowak <mnowak@startmail.com>
Date:   2019-06-13T19:06:34.000Z

    11192 zpool.1m: UNSUPP: unsupported escape sequence: \?
    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

With mandoc 1.14.5.

Before:

$ mandoc -Tlint -Wwarning ~/ws/illumos-gate/usr/src/man/man1m/zpool.1m 
mandoc: /export/home/newman/ws/illumos-gate/usr/src/man/man1m/zpool.1m:37:5: UNSUPP: unsupported escape sequence: \?
mandoc: /export/home/newman/ws/illumos-gate/usr/src/man/man1m/zpool.1m:833:5: UNSUPP: unsupported escape sequence: \?

After:

$ mandoc -Tlint -Wwarning /usr/share/man/man1m/zpool.1m

$ mandoc -l /usr/share/man/man1m/zpool.1m

ZPOOL(1M)                    Maintenance Commands                    ZPOOL(1M)

NAME
     zpool – configure ZFS storage pools

SYNOPSIS
     zpool -?
...
     zpool -?
             Displays a help message.

Also available in: Atom PDF