Project

General

Profile

Feature #11232

Ship mandoc.css for better rendered HTML man pages

Added by Michal Nowak 2 months ago.

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

0%

Estimated time:
Difficulty:
Bite-size
Tags:

Description

With our port of mandoc we don't ship upstream mandoc.css (apart from copy-paste in webrev.sh), which happens to be useful when generating HTML files via -Thtml.

In files attached to this ticket one can compare the mdoc page rendered with and without the CSS file (-Thtml -O style=mandoc.css). I suggest that the one with CSS is the superior one.

And, as rightly pointed in a review (https://www.illumos.org/rb/r/1975/), mandoc.1 refers to mandoc.css file being in /usr/share/misc/, this needs to be changed once it's clear where the file should be put.


Files

nocss_mdoc.7.html (151 KB) nocss_mdoc.7.html Rendered mdoc page without CSS Michal Nowak, 2019-06-12 07:09 AM
css_mdoc.7.html (150 KB) css_mdoc.7.html Rendered mdoc page with CSS Michal Nowak, 2019-06-12 07:09 AM
mandoc.css (8.34 KB) mandoc.css The actuall mandoc CSS file Michal Nowak, 2019-06-12 07:09 AM

Related issues

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

Actions

History

#1

Updated by Michal Nowak 2 months ago

Also available in: Atom PDF