manpages is mdoc(7)

Jan Stary hans at stare.cz
Thu Mar 30 18:08:41 UTC 2017


Err, the intended subject was "manpages in mdoc(7)" :-)
But yes, manpages is mdoc(7), imho.

On Mar 30 19:08:44, hans at stare.cz 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?
> 
> 	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


More information about the macports-dev mailing list