Project

General

Profile

Feature #11190

Update mandoc to 1.14.5

Added by Michal Nowak 23 days ago. Updated 5 days ago.

Status:
Closed
Priority:
Normal
Assignee:
Category:
cmd - userland programs
Start date:
Due date:
% Done:

100%

Estimated time:
Difficulty:
Medium
Tags:

Description

http://mandoc.bsd.lv/NEWS
http://mandoc.bsd.lv/ChangeLog

Due to extended linting capabilities following pages need to be fixed:

  • zfs.1m
  • zpool.1m
  • cmn_err.9f

Will file separate bugs for them.


Related issues

Related to illumos gate - Bug #11191: zfs.1m: UNSUPP: unsupported escape sequence: \?Closed

Actions
Related to illumos gate - Bug #11192: zpool.1m: UNSUPP: unsupported escape sequence: \?Closed

Actions
Related to illumos gate - Bug #11193: cmn_err.9f: UNSUPP: unsupported escape sequencesClosed

Actions
Related to illumos gate - Bug #11194: syseventadm.1m: ERROR: using macro argument outside macroClosed

Actions
Related to illumos gate - Feature #11195: Lint old man pages for errors with mandocClosed

Actions
Related to illumos gate - Feature #11232: Ship mandoc.css for better rendered HTML man pagesNew

Actions
Precedes illumos gate - Bug #11259: mandoc should allow ERRORS section in all man section 7 variantsClosed

Actions

History

#1

Updated by Michal Nowak 23 days ago

  • Related to Bug #11191: zfs.1m: UNSUPP: unsupported escape sequence: \? added
#2

Updated by Michal Nowak 23 days ago

  • Related to Bug #11192: zpool.1m: UNSUPP: unsupported escape sequence: \? added
#3

Updated by Michal Nowak 23 days ago

  • Related to Bug #11193: cmn_err.9f: UNSUPP: unsupported escape sequences added
#4

Updated by Michal Nowak 23 days ago

  • Related to Bug #11194: syseventadm.1m: ERROR: using macro argument outside macro added
#5

Updated by Michal Nowak 23 days ago

  • Related to Feature #11195: Lint old man pages for errors with mandoc added
#6

Updated by Michal Nowak 21 days ago

I went thru all mandoc files we ship in illumos like this cvs diff -r VERSION_1_14_4 -r VERSION_1_14_5 $file and applied those patches directly to illumos mandoc. There were few conflicts I had to resolve, one file was removed upstream (libroff.h), content of st.in was moved to st.c, several files - mostly headers - were added to satisfy the build.

On top of VERSION_1_14_5 I applied handful of upstream post-1.14.5-release patches to satisfy illumos build and to fix a crash in -Thtml as we might be hit by this once https://illumos.org/man/ is regenerated.

I tested updated mandoc with a clean illumos build, thus triggering -Tlint -Wwarning on all mandoc-style man pages, and, thanks to #11195, I also linted all old man pages for errors.

Displayed several man pages from illumos and OI userland with the updated mandoc, generated webrev and verified that man page is displayed sanely as TXT and HTML.

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

#7

Updated by Michal Nowak 15 days ago

  • Related to Feature #11232: Ship mandoc.css for better rendered HTML man pages added
#8

Updated by Gergő Mihály Doma 5 days ago

  • Precedes Bug #11259: mandoc should allow ERRORS section in all man section 7 variants added
#9

Updated by Electric Monk 5 days ago

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

git commit cec8643b41ebefad6c677010fc784dc4bb0550f3

commit  cec8643b41ebefad6c677010fc784dc4bb0550f3
Author: Michal Nowak <mnowak@startmail.com>
Date:   2019-06-21T18:59:14.000Z

    11190 Update mandoc to 1.14.5
    Reviewed by: Robert Mustacchi <rm@joyent.com>
    Reviewed by: Gergő Doma <domag02@gmail.com>
    Approved by: Dan McDonald <danmcd@joyent.com>

Also available in: Atom PDF