version 1.2, 2014/04/02 08:14:27 |
version 1.6, 2014/07/19 00:47:38 |
|
|
<p> |
<p> |
The <span class="nm">pod2mdoc</span> utility is a converter from <a |
The <span class="nm">pod2mdoc</span> utility is a converter from <a |
href="http://perldoc.perl.org/perlpod.html">POD</a> into <a |
href="http://perldoc.perl.org/perlpod.html">POD</a> into <a |
href="http://www.openbsd.org/cgi-bin/man.cgi?query=mdoc&sektion=7">mdoc</a>. |
href="http://www.openbsd.org/cgi-bin/man.cgi?query=mdoc&sec=7">mdoc</a>. |
It's meant to operate like <a class="nm" href="http://perldoc.perl.org/pod2man.html">pod2man</a>; however, it |
It's meant to operate like <a class="nm" href="http://perldoc.perl.org/pod2man.html">pod2man</a>; however, it |
doesn't require a <a href="http://www.perl.org/">Perl</a> installation: <span class="nm">pod2mdoc</span> is a |
doesn't require a <a href="http://www.perl.org/">Perl</a> installation: <span class="nm">pod2mdoc</span> is a |
standalone <a rel="license" |
standalone <a rel="license" |
|
|
<blockquote> |
<blockquote> |
By way of being a presentational language, POD is not well-represented |
By way of being a presentational language, POD is not well-represented |
by mdoc(7). |
by mdoc(7). |
Semantic content will be necessarily lost. |
Semantic content must be inferred and may be wrong. |
</blockquote> |
</blockquote> |
<p> |
<p> |
Contact <a href="http://kristaps.bsd.lv">Kristaps</a> with questions, but please make sure any formatting issue |
Contact <a href="http://kristaps.bsd.lv">Kristaps</a> with questions, but please make sure any formatting issue |
hasn't already been covered in the <a href="pod2mdoc.1.html">manual</a>. |
hasn't already been covered in the <a href="pod2mdoc.1.html">manual</a>. |
</p> |
</p> |
<h2> |
<h2> |
New in version @VERSION@... |
New in version 0.0.13 (July 19, 2014) |
</h2> |
</h2> |
<p> |
<p> |
More smarts in converting SYNOPSIS sections into useful mdoc(7). |
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. |
</p> |
</p> |
|
<h2> |
|
New in version 0.0.12 (July 11, 2014) |
|
</h2> |
|
<p> |
|
Render <code>B<NULL></code> as <code>.Dv NULL</code>. |
|
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. |
|
</p> |
|
<h2> |
|
New in version 0.0.11 (April 7, 2014) |
|
</h2> |
|
<p> |
|
Properly render <code>#include</code> in the SYNOPSIS with <code>In</code>. |
|
Handle nested escape codes in <code>L<></code> links (and ignore them). |
|
Properly consume whitespace following <code>X<></code> and <code>N<></code>. |
|
</p> |
</article> |
</article> |
<footer> |
<footer> |
© 2014 <a href="http://kristaps.bsd.lv">Kristaps Dzonsons</a>, |
© 2014 <a href="http://kristaps.bsd.lv">Kristaps Dzonsons</a> and Ingo Schwarze, |
$Date$ |
$Date$ |
</footer> |
</footer> |
</body> |
</body> |