Return to index.xml CVS log | Up to [cvsweb.bsd.lv] / docbook2mdoc |
File: [cvsweb.bsd.lv] / docbook2mdoc / Attic / index.xml (download)
Revision 1.13, Thu Mar 28 12:21:10 2019 UTC (5 years, 1 month ago) by schwarze
The expat library aborts parsing as soon as it encounters invalid input, and the basic design of the library practically precludes fixing it. However, whether the input is well-formed XML or not is totally irrelevant, and in fact, i have seen real-world documents from X.org that expat rejects as not well-formed. Kristaps reports the same from OpenGL. We really want to parse *ANYTHING* whatsoever without ever throwing a fatal error - after all, the point is to convert legacy documents to a better format, and nitpicking about the syntax merely alienates users (including myself). Consequently, ditch expat and write a parser from scratch, optimized for robustness on invalid input. Oh, and by the way, it only requires 200 lines of code, compared to 15,000 lines in expat - an economy of 98.5% at the sime time as being much more useful in practice. |
<!DOCTYPE html> <html> <head> <meta name="viewport" content="initial-scale=1.0, user-scalable=no" /> <meta charset='utf-8' /> <title>docbook2mdoc | Convert DocBook to mdoc</title> <style> html, body { margin: 0; padding: 0; } header { margin-top: 1em; } header span.nm { font-size: 16pt; } header span.nd { font-size: 14pt; } article span.nm, article a.nm { font-style: italic; } header, article, footer { width: 80%; margin-left: auto; margin-right: auto; } body { color: #333; font-family: Times,serif; line-height: 120%; } nav { color: #666; margin-top: 0.5ex; } nav span { border-left: thin solid silver; margin-left: 0.25ex; padding-left: 0.5ex; } nav span:first-child { border: 0; padding: 0; margin: 0; } 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; } </style> </head> <body> <header> <span class="nm">docbook2mdoc</span> — <span class="nd">Convert DocBook to mdoc</span> <nav> <span>version <span>@VERSION@</span></span> <span><a href="snapshots/docbook2mdoc.tgz">Sources</a></span> <span><a href="snapshots">Archives</a></span> </nav> </header> <article> <p> The <span class="nm">docbook2mdoc</span> utility is a converter from <a href="http://www.oasis-open.org/docbook/">DocBook</a> V4.x and v5.x XML into <a href="http://man.openbsd.org/mdoc.7">mdoc</a>. 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 that should compile on any modern UNIX system. </p> <p> <span class="nm">docbook2mdoc</span> is experimental: it still has many missing elements. However, it works with the DocBook reference examples and documents found in the wild. Contact <a href="https://mandoc.bsd.lv/contact.html">the developers</a> with questions or missing nodes; or better yet, download the source and add new elements yourself as described in the <a href="README.txt">README</a>. </p> <h2> New in version @VERSION@... </h2> <p> Now supports most tags as found in the <a href="https://https://www.opengl.org/">OpenGL</a> DocBook corpus. The main missing elements are <code><inlineequation></code> and <code><informalequation></code>, although a few others (<code><footnote></code> et al.) are in there too. The DocBook is also malformed in some areas—improper parenting. </p> </article> <footer> © 2014 <a href="http://kristaps.bsd.lv">Kristaps Dzonsons</a>, $Date: 2019/03/28 12:21:10 $ </footer> </body> </html>