The pod2mdoc utility is a converter from POD into mdoc.
+ href="http://www.openbsd.org/cgi-bin/man.cgi?query=mdoc&sec=7">mdoc.
It's meant to operate like pod2man; however, it
doesn't require a Perl installation: pod2mdoc is a
standalone
By way of being a presentational language, POD is not well-represented
by mdoc(7).
- Semantic content will be necessarily lost.
+ Semantic content must be inferred and may be wrong.
- Contact Kristaps with questions, but please make sure any formatting issue
+ The pod2mdoc utility is still in an early stage of development and far from complete.
+ However, when translating the LibreSSL
+ 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.
+
+ Simple
+ 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.
+
+ Render
+ Properly render -lssl manuals,
+ it has been shown that with some manual postprocessing, it is already usable for real-world tasks.
+
+ 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)
+
+
+ New in version 0.0.12 (July 11, 2014)
+
+ B<NULL> as .Dv NULL.
+ 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 In.
+ Handle nested escape codes in L<> links (and ignore them).
+ Properly consume whitespace following X<> and N<>.
+