The pod2mdoc utility is a converter from POD into mdoc. It's meant to operate like pod2man; however, it doesn't require a Perl installation: pod2mdoc is a standalone ISC-licensed ISO C utility and should compile on any modern UNIX system.
Be aware, as stated in the manual:
By way of being a presentational language, POD is not well-represented by mdoc(7). Semantic content must be inferred and may be wrong.
The pod2mdoc utility is still in an early stage of development and far from complete.
However, when translating the LibreSSL
it has been shown that with some manual postprocessing, it is already usable for real-world tasks.
Contact the mandoc developers with questions, but please make sure any formatting issue hasn't already been covered in the manual.
In addition to the release notes given below, a full ChangeLog is available.
New in version 0.1 (November 17, 2014)
Ft/Fo/Fa/Fc parser and formatter for the SYNOPSIS.
New in version 0.0.13 (July 19, 2014)
Proper translation of POD commands and formatting codes into mdoc macros, including correct whitespace handling. Only capital ASCII letters A-Z can start a formatting code. Do not skip the content of invalid formatting codes. Improved handling of filename extensions.
New in version 0.0.12 (July 11, 2014)
Correctly check the number of arguments.
Show the usage() message if there are too many arguments.
Mention the optional "file" argument in the usage() message.
New in version 0.0.11 (April 7, 2014)
#include in the SYNOPSIS with
Handle nested escape codes in
L<> links (and ignore them).
Properly consume whitespace following