![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to index.xml CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [cvsweb.bsd.lv] / pod2mdoc|
Return to index.xml CVS log | Up to [cvsweb.bsd.lv] / pod2mdoc |
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: —
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&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>
1.7 ! schwarze 55: The <span class="nm">pod2mdoc</span> utility is still in an early stage of development and far from complete.
! 56: However, when translating the <a href="http://www.libressl.org/">LibreSSL</a> <code>-lssl</code> manuals,
! 57: it has been shown that with some manual postprocessing, it is already usable for real-world tasks.
! 58: </p>
! 59: <p>
! 60: Contact the <a href="http://mdocml.bsd.lv/contact.html">mandoc developers</a> with questions,
! 61: but please make sure any formatting issue
1.1 kristaps 62: hasn't already been covered in the <a href="pod2mdoc.1.html">manual</a>.
63: </p>
1.7 ! schwarze 64: <p>
! 65: In addition to the release notes given below, a full <a href="ChangeLog">ChangeLog</a> is available.
! 66: </p>
! 67: <h2>
! 68: New in version 0.1 (November 17, 2014)
! 69: </h2>
! 70: <p>
! 71: Simple <code>Ft/Fo/Fa/Fc</code> parser and formatter for the SYNOPSIS.
! 72: </p>
1.2 kristaps 73: <h2>
1.6 schwarze 74: New in version 0.0.13 (July 19, 2014)
75: </h2>
76: <p>
77: Proper translation of POD commands
78: and formatting codes into mdoc macros,
79: including correct whitespace handling.
80: Only capital ASCII letters A-Z
81: can start a formatting code.
82: Do not skip the content of invalid
83: formatting codes.
84: Improved handling of filename extensions.
85: </p>
86: <h2>
1.5 schwarze 87: New in version 0.0.12 (July 11, 2014)
88: </h2>
89: <p>
90: Render <code>B<NULL></code> as <code>.Dv NULL</code>.
91: Correctly check the number of arguments.
92: Show the usage() message if there are too many arguments.
93: Mention the optional "file" argument in the usage() message.
94: </p>
95: <h2>
96: New in version 0.0.11 (April 7, 2014)
1.2 kristaps 97: </h2>
98: <p>
1.4 kristaps 99: Properly render <code>#include</code> in the SYNOPSIS with <code>In</code>.
100: Handle nested escape codes in <code>L<></code> links (and ignore them).
101: Properly consume whitespace following <code>X<></code> and <code>N<></code>.
1.2 kristaps 102: </p>
1.1 kristaps 103: </article>
104: <footer>
1.6 schwarze 105: © 2014 <a href="http://kristaps.bsd.lv">Kristaps Dzonsons</a> and Ingo Schwarze,
1.7 ! schwarze 106: $Date: 2014/07/19 00:47:38 $
1.1 kristaps 107: </footer>
108: </body>
109: </html>