manpages is mdoc(7)

[Clemens Lang]

Hey,

On Thu, Mar 30, 2017 at 07:08:44PM +0200, Jan Stary wrote:
> 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?

There's in fact so much interest in getting rid of the legacy format
that the current version of most of the port-* manpages are generated
from asciidoc versions that are right next to them.

See for example
 https://github.com/macports/macports-base/blob/master/doc/port-activate.1.txt
 https://github.com/macports/macports-base/blob/master/doc/port-activate.1

Not all of the manpages have been converted yet, though. If you want to
help out, asciidoc versions of portfile(7) and porthier(7) would be very
welcome.

-- 
Clemens