Project

General

Profile

Feature #11190

Update mandoc to 1.14.5

Added by Michal Nowak over 1 year ago. Updated over 1 year ago.

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

100%

Estimated time:
Difficulty:
Medium
Tags:
Gerrit CR:

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: \?ClosedMichal Nowak

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

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

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

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

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

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

Actions
#1

Updated by Michal Nowak over 1 year ago

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

Updated by Michal Nowak over 1 year ago

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

Updated by Michal Nowak over 1 year ago

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

Updated by Michal Nowak over 1 year ago

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

Updated by Michal Nowak over 1 year ago

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

Updated by Michal Nowak over 1 year 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 over 1 year ago

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

Updated by Gergő Mihály Doma over 1 year ago

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

Updated by Electric Monk over 1 year 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