[poppler] utils manpages in mdoc(7)

[Jan Stary]

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.

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