manpages is mdoc(7)

[Jan Stary]

Currently, the port-* manpages are written
using the legacy man(7) language which uses
low-level roff constructs to described presentational details.

I propose to rewrite them into the _semantic_ markup of mdoc(7) language.
Both have been around for decades and are well supported by groff.

As an example, please see a proposed rewrite of port-cat.1
(and compare it to the current version).

I there any interest in this?

	Jan


.Dd March 30, 2017
.Dt PORT-CAT 1
.Os
.Sh NAME
.Nm port-cat
.Nd print the contents of a Portfile
.Sh SYNOPSIS
.Nm
.Op Fl D Ar portdir
.Ic cat
.Op Ar portname | pseudo-portname | port-expressions | port-url
.Sh DESCRIPTION
Print the
.Pa Portfile
of the given port(s).
Note that the latest version in your local ports tree is printed.
.Sh SEE ALSO
.Xr port 1 ,
.Xr port-selfupdate
.Sh AUTHORS
.An Clemens Lang Aq mt cal at macports.org