version 1.6, 2014/04/02 07:55:26 |
version 1.12, 2016/04/06 15:45:43 |
|
|
<html> |
<html> |
<head> |
<head> |
<meta name="viewport" content="initial-scale=1.0, user-scalable=no" /> |
<meta name="viewport" content="initial-scale=1.0, user-scalable=no" /> |
<meta charset='utf-8' /> |
<meta charset='utf-8' /> |
<title>docbook2mdoc | Convert DocBook refentry to mdoc</title> |
<title>docbook2mdoc | Convert DocBook refentry to mdoc</title> |
<style> |
<style> |
html, body { margin: 0; padding: 0; } |
html, body { margin: 0; padding: 0; } |
|
|
<article> |
<article> |
<p> |
<p> |
The <span class="nm">docbook2mdoc</span> utility is a converter from <a |
The <span class="nm">docbook2mdoc</span> utility is a converter from <a |
href="http://www.oasis-open.org/docbook/">DocBook</a> into <a |
href="http://www.oasis-open.org/docbook/">DocBook</a> V4.x and v5.x XML into <a |
href="http://www.openbsd.org/cgi-bin/man.cgi?query=mdoc&sektion=7">mdoc</a>. |
href="http://man.openbsd.org/mdoc.7">mdoc</a>. |
Unlike most DocBook utilities, it's a standalone <a rel="license" |
Unlike most DocBook utilities, it's a standalone <a rel="license" |
href="https://www.isc.org/downloads/software-support-policy/isc-license/">ISC</a>-licensed ISO C utility |
href="https://www.isc.org/downloads/software-support-policy/isc-license/">ISC</a>-licensed ISO C utility |
that should compile on any modern UNIX system. |
that should compile on any modern UNIX system. |
|
|
installed by default on most systems. |
installed by default on most systems. |
</p> |
</p> |
<p> |
<p> |
<span class="nm">docbook2mdoc</span> is <em>very</em> experimental: it probably won't work with your manual |
<span class="nm">docbook2mdoc</span> is experimental: it still has many missing elements. |
without improvement. |
However, it works with the DocBook reference examples and documents found in the wild. |
However, it does work with the DocBook reference manuals (minimally rendered here with <a |
Contact <a href="http://kristaps.bsd.lv">Kristaps</a> with questions or missing nodes; or better yet, download |
href="http://mdocml.bsd.lv">mandoc</a> -Thtml): <a href="printf.html">printf</a>, <a |
the source and add new elements yourself as described in the <a href="README.txt">README</a>. |
href="ls.html">ls</a>, <a href="as.html">as</a>, <a href="iovec.html">iovec</a>. |
|
</p> |
</p> |
<p> |
|
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="docbook2mdoc.1.html">manual</a>. |
|
</p> |
|
<h2> |
<h2> |
New in version @VERSION@... |
New in version @VERSION@... |
</h2> |
</h2> |
<p> |
<p> |
Allow for more node types as found in <a href="http://www.catb.org/~esr/doclifter/">doclifter</a> output. |
Now supports most tags as found in the <a href="https://https://www.opengl.org/">OpenGL</a> DocBook corpus. |
Add rudimentary support for <code><table></code> as a list-of-lists. |
The main missing elements are <code><inlineequation></code> and <code><informalequation></code>, |
Still lots of work to be done before accepting enough DocBook to be useful... |
although a few others (<code><footnote></code> et al.) are in there too. |
|
The DocBook is also malformed in some areas—improper parenting. |
</p> |
</p> |
</article> |
</article> |
<footer> |
<footer> |