[poppler] utils manpages in mdoc(7)

[Albert Astals Cid]

El Diumenge, 9 de novembre de 2014, a les 13:21:45, Jan Stary va escriure:
> Currently, the manpages of the poppler utils
> are written in the legacy man(7) markup language.
> Below please find a proposed rewrite of pdfunite.1
> into the _semantic_ mdoc(7) language.
> 
> Both languages are well supported for decades,
> by groff (on most linuxes) and by mandoc (the BSDs).
> The advantage of the semantic markup is that it allows
> for cinstructions like "There is an optional -h flag"
> 
> 	.Op Fl h
> 
> as opposed to the physical markup of
> "type a bracket, switch to italics, type -h,
> swithc back to roman, typed the closing bracket"
> and similarly for other manpage constructions.
> See http://manpages.bsd.lv/ for an elaborate discussion
> on why this is a good thing.

Can we have a short summary?

I went there and the formatting scared me away :/

Cheers,
  Albert

> 
> Please let me know if there is any interest in this,
> I am willing to do the work.
> 
> 	Your happy user
> 
> 		Jan
> 
> 
> 
> .Dd November 10, 2014
> .Dt PDFUNITE 1
> .Os
> .Sh NAME
> .Nm pdfunite
> .Nd merge PDF files
> .Sh SYNOPSIS
> .Nm pdfunite
> .Op Fl h
> .Op Fl v
> .Ar input1.pdf
> .Ar ...
> .Ar inputN.pdf
> .Ar oputput.pdf
> .Sh DESCRIPTION
> .Nm
> merges several PDF (Portable Document Format) files
> in order of their occurence on command line into one PDF output file.
> The input files must not be encrypted.
> .Pp
> The options are as follows.
> .Bl -tag -width Ds -compact
> .It Fl h
> Print usage information.
> .It Fl v
> Print copyright and version information.
> .El
> .Sh SEE ALSO
> .Xr pdfseparate 1
> .Pp
> .Lk http://poppler.freedesktop.org
> _______________________________________________
> poppler mailing list
> poppler at lists.freedesktop.org
> http://lists.freedesktop.org/mailman/listinfo/poppler