[BACK]Return to index.xml CVS log [TXT][DIR] Up to [cvsweb.bsd.lv] / pod2mdoc

Annotation of pod2mdoc/index.xml, Revision 1.6

1.1       kristaps    1: <!DOCTYPE html>
                      2: <html>
                      3:        <head>
                      4:                <meta name="viewport" content="initial-scale=1.0, user-scalable=no" />
                      5:                <meta charset='utf-8' />
                      6:                <title>pod2mdoc | Convert POD data to mdoc input </title>
                      7:                <style>
                      8:                        html, body { margin: 0; padding: 0; }
                      9:                        header { margin-top: 1em; }
                     10:                        header span.nm { font-size: 16pt; }
                     11:                        header span.nd { font-size: 14pt; }
                     12:                        article span.nm, article a.nm { font-style: italic; }
                     13:                        header, article, footer { width: 80%; margin-left: auto; margin-right: auto; }
                     14:                        body { color: #333; font-family: Times,serif; line-height: 120%; }
                     15:                        nav { color: #666; margin-top: 0.5ex; }
                     16:                        nav span { border-left: thin solid silver; margin-left: 0.25ex; padding-left: 0.5ex; }
                     17:                        nav span:first-child { border: 0; padding: 0; margin: 0; }
                     18:                        a { text-decoration: none; }
                     19:                        footer { margin-top: 1em; font-size: smaller; color: #666; }
                     20:                        footer a { color: #000; }
1.2       kristaps   21:                        h2 { font-size: larger; font-weight: bolder; color: #333; }
1.1       kristaps   22:                </style>
                     23:        </head>
                     24:        <body>
                     25:                <header>
                     26:                        <span class="nm">pod2mdoc</span>
                     27:                        &#8212;
                     28:                        <span class="nd">Convert POD data to mdoc input</span>
                     29:                        <nav>
                     30:                                <span>version <span>@VERSION@</span></span>
                     31:                                <span><a href="snapshots/pod2mdoc.tgz">Sources</a></span>
                     32:                                <span><a href="snapshots">Archives</a></span>
                     33:                        </nav>
                     34:                </header>
                     35:                <article>
                     36:                        <p>
                     37:                                The <span class="nm">pod2mdoc</span> utility is a converter from <a
                     38:                                        href="http://perldoc.perl.org/perlpod.html">POD</a> into <a
1.6     ! schwarze   39:                                        href="http://www.openbsd.org/cgi-bin/man.cgi?query=mdoc&amp;sec=7">mdoc</a>.
1.1       kristaps   40:                                It's meant to operate like <a class="nm" href="http://perldoc.perl.org/pod2man.html">pod2man</a>; however, it
                     41:                                doesn't require a <a href="http://www.perl.org/">Perl</a> installation: <span class="nm">pod2mdoc</span> is a
                     42:                                standalone <a rel="license"
                     43:                                        href="https://www.isc.org/downloads/software-support-policy/isc-license/">ISC</a>-licensed ISO C utility
                     44:                                and should compile on any modern UNIX system.
                     45:                        </p>
                     46:                        <p>
                     47:                                Be aware, as stated in the <a href="pod2mdoc.1.html">manual</a>:
                     48:                        </p>
                     49:                        <blockquote>
                     50:                                By way of being a presentational language, POD is not well-represented
                     51:                                by mdoc(7).
1.3       kristaps   52:                                Semantic content must be inferred and may be wrong.
1.1       kristaps   53:                        </blockquote>
                     54:                        <p>
                     55:                                Contact <a href="http://kristaps.bsd.lv">Kristaps</a> with questions, but please make sure any formatting issue
                     56:                                hasn't already been covered in the <a href="pod2mdoc.1.html">manual</a>.
                     57:                        </p>
1.2       kristaps   58:                        <h2>
1.6     ! schwarze   59:                                New in version 0.0.13 (July 19, 2014)
        !            60:                        </h2>
        !            61:                        <p>
        !            62:                                Proper translation of POD commands
        !            63:                                and formatting codes into mdoc macros,
        !            64:                                including correct whitespace handling.
        !            65:                                Only capital ASCII letters A-Z
        !            66:                                can start a formatting code.
        !            67:                                Do not skip the content of invalid
        !            68:                                formatting codes.
        !            69:                                Improved handling of filename extensions.
        !            70:                        </p>
        !            71:                        <h2>
1.5       schwarze   72:                                New in version 0.0.12 (July 11, 2014)
                     73:                        </h2>
                     74:                        <p>
                     75:                                Render <code>B&lt;NULL&gt;</code> as <code>.Dv NULL</code>.
                     76:                                Correctly check the number of arguments.
                     77:                                Show the usage() message if there are too many arguments.
                     78:                                Mention the optional "file" argument in the usage() message.
                     79:                        </p>
                     80:                        <h2>
                     81:                                New in version 0.0.11 (April 7, 2014)
1.2       kristaps   82:                        </h2>
                     83:                        <p>
1.4       kristaps   84:                                Properly render <code>#include</code> in the SYNOPSIS with <code>In</code>.
                     85:                                Handle nested escape codes in <code>L&lt;&gt;</code> links (and ignore them).
                     86:                                Properly consume whitespace following <code>X&lt;&gt;</code> and <code>N&lt;&gt;</code>.
1.2       kristaps   87:                        </p>
1.1       kristaps   88:                </article>
                     89:                <footer>
1.6     ! schwarze   90:                        &#169; 2014 <a href="http://kristaps.bsd.lv">Kristaps Dzonsons</a> and Ingo Schwarze,
        !            91:                        $Date: 2014/07/11 09:27:24 $
1.1       kristaps   92:                </footer>
                     93:        </body>
                     94: </html>
CVSweb