===================================================================
RCS file: /cvs/pod2mdoc/index.xml,v
retrieving revision 1.2
retrieving revision 1.9
diff -u -p -r1.2 -r1.9
--- pod2mdoc/index.xml	2014/04/02 08:14:27	1.2
+++ pod2mdoc/index.xml	2015/05/19 20:42:48	1.9
@@ -2,7 +2,7 @@
 <html>
 	<head>
 		<meta name="viewport" content="initial-scale=1.0, user-scalable=no" />
-		<meta charset='utf-8' /> 
+		<meta charset='utf-8' />
 		<title>pod2mdoc | Convert POD data to mdoc input </title>
 		<style>
 			html, body { margin: 0; padding: 0; }
@@ -36,7 +36,7 @@
 			<p>
 				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://www.openbsd.org/cgi-bin/man.cgi?query=mdoc&sektion=7">mdoc</a>.
+					href="http://www.openbsd.org/cgi-bin/man.cgi?query=mdoc&amp;sec=7">mdoc</a>.
 				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
 				standalone <a rel="license"
@@ -49,22 +49,86 @@
 			<blockquote>
 				By way of being a presentational language, POD is not well-represented
 				by mdoc(7).
-				Semantic content will be necessarily lost.
+				Semantic content must be inferred and may be wrong.
 			</blockquote>
 			<p>
-				Contact <a href="http://kristaps.bsd.lv">Kristaps</a> with questions, but please make sure any formatting issue
+				The <span class="nm">pod2mdoc</span> utility is still in an early stage of development and far from complete.
+				However, when translating the <a href="http://www.libressl.org/">LibreSSL</a> <code>-lssl</code> manuals,
+				it has been shown that with some manual postprocessing, it is already usable for real-world tasks.
+			</p>
+			<p>
+				Contact the <a href="http://mdocml.bsd.lv/contact.html">mandoc developers</a> with questions,
+				but please make sure any formatting issue
 				hasn't already been covered in the <a href="pod2mdoc.1.html">manual</a>.
 			</p>
+			<p>
+				In addition to the release notes given below, a full <a href="ChangeLog">ChangeLog</a> is available.
+			</p>
 			<h2>
-				New in version @VERSION@...
+				New in version 0.2 (May 19, 2015)
 			</h2>
 			<p>
-				More smarts in converting SYNOPSIS sections into useful mdoc(7).
+				SYNOPSIS preprocessor lines use <code>Fd</code>.
+				Names found in the SYNOPSIS are remembered
+				using Marc Espie's ohash library (bundled
+				for compatibility with operating systems
+				lacking it); that information is used
+				subsequently to mark up
+				function names with <code>Fn</code>,
+				function arguments with <code>Fa</code>,
+				type names with <code>Vt</code>,
+				preprocessor macros with <code>Dv</code>.
+				Foreign function names are marked up
+				with <code>Xr</code>.
+				Whitespace handling has been improved
+				in many respects (blank lines in literal
+				displays; re-wrap text lines; new sentence,
+				new line; better horizontal spacing;
+				no more whitespace at the end of lines).
+				Improved handling of closing punctuation.
+				Escaping of quotes at the beginning of
+				macro arguments.
 			</p>
+			<h2>
+				New in version 0.1 (November 17, 2014)
+			</h2>
+			<p>
+				Simple <code>Ft/Fo/Fa/Fc</code> parser and formatter for the SYNOPSIS.
+			</p>
+			<h2>
+				New in version 0.0.13 (July 19, 2014)
+			</h2>
+			<p>
+				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>
+			<h2>
+				New in version 0.0.12 (July 11, 2014)
+			</h2>
+			<p>
+				Render <code>B&lt;NULL&gt;</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&lt;&gt;</code> links (and ignore them).
+				Properly consume whitespace following <code>X&lt;&gt;</code> and <code>N&lt;&gt;</code>.
+			</p>
 		</article>
 		<footer>
-			&#169; 2014 <a href="http://kristaps.bsd.lv">Kristaps Dzonsons</a>,
-			$Date: 2014/04/02 08:14:27 $
+			&#169; 2014 <a href="http://kristaps.bsd.lv">Kristaps Dzonsons</a> and Ingo Schwarze,
+			$Date: 2015/05/19 20:42:48 $
 		</footer>
 	</body>
 </html>
