=================================================================== RCS file: /cvs/pod2mdoc/index.xml,v retrieving revision 1.1 retrieving revision 1.7 diff -u -p -r1.1 -r1.7 --- pod2mdoc/index.xml 2014/03/24 01:43:42 1.1 +++ pod2mdoc/index.xml 2014/11/17 18:46:23 1.7 @@ -18,6 +18,7 @@ a { text-decoration: none; } footer { margin-top: 1em; font-size: smaller; color: #666; } footer a { color: #000; } + h2 { font-size: larger; font-weight: bolder; color: #333; } @@ -35,7 +36,7 @@

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 -lssl manuals, + 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) +

+ Simple 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) +

+ Render 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) +

+ Properly render #include in the SYNOPSIS with In. + Handle nested escape codes in L<> links (and ignore them). + Properly consume whitespace following X<> and N<>. +