X-Git-Url: https://git.cameronkatri.com/mandoc.git/blobdiff_plain/e774c5024bd719f12d01a11a9d1fd6cae5a0e899..8e37e41aceb3299a93379ef910ac09f41fb2f59b:/index.sgml

diff --git a/index.sgml b/index.sgml
index 544283f2..76bc7a3c 100644
--- a/index.sgml
+++ b/index.sgml
@@ -24,11 +24,16 @@
 					</h1>
 
 					<p>
-					<span class="nm">mdocml</span> is a suite of tools that compile &#8220;mdoc&#8221;, the roff macro
-					package of the BSD manual pages.  The mission of <span class="nm">mdocml</span> is to deprecate <a
+					<span class="nm">mdocml</span> is a suite of tools compiling &#8220;mdoc&#8221;, the roff macro
+					package for BSD manual pages.  The mission of <span class="nm">mdocml</span> is to deprecate <a
 					href="http://www.gnu.org/software/groff/" class="external">groff</a>, the GNU roff implementation, for
-					displaying BSD mdoc pages.  groff amounts to over 60 000 lines of GPL C++ source, which is a
-					considerable encumbrance to BSD operating systems.
+					displaying BSD mdoc pages.
+					</p>
+
+					<p>
+					Why?  groff amounts to roughly 5,2 MB of source code (OpenBSD 4.2), some of which is C++ and all of
+					which is GPL.  It runs slowly, produces uncertain output, and varies in operation from system
+					to system.  mdocml strives to fix this (respectively small, C, ISC-licensed, fast and regular).
 					</p>
 
 					<p>
@@ -44,7 +49,7 @@
 
 					<ul>
 					<li><span class="man">mdocterm(1)</span> &#8211; formats mdoc input for display on the terminal
-					<li><span class="man">mdochtml(1)</span> &#8211; formats mdoc input as strict HTML (nascent)
+					<li><span class="man">mdochtml(1)</span> &#8211; formats mdoc input as HTML/CSS (nascent)
 					<li><span class="man">mdoclint(1)</span> &#8211; validates mdoc input
 					<li><span class="man">mdoctree(1)</span> &#8211; prints input abstract syntax tree
 					</ul>
@@ -74,15 +79,16 @@
 					</p>
 
 					<p>
-					The most current version is <b>@VERSION@</b>, dated <b>@VDATE@</b>.
+					The most current version is <span class="attn">@VERSION@</span>, dated 
+					<span class="attn">@VDATE@</span>.
 					</p>
 
 					<h2>
-					snapshotted source
+					Snapshot source
 					</h2>
 
 					<p>
-					CVS sources are checkedout and snapshotted with big updates.  These may be found in the <a
+					CVS sources are checkedout and snapshotted with version updates.  These may be found in the <a
 					href="/snapshots/">/snapshots/</a> directory.
 					</p>
 
@@ -96,15 +102,20 @@
 					</p>
 
 					<h2>
-					nightly port
+					Snapshot port/pkgsrc
 					</h2>
 
 					<p>
-					The source snapshot is automatically converted into an OpenBSD port (ports for other BSD systems not
-					yet available).  These may be found in the <a href="/ports-openbsd/">/ports-openbsd/</a> directory.
-					You <span class="emph">must</span> have the ports tree installed.
+					The source snapshot is automatically converted into OpenBSD port and NetBSD pkgsrc forms at <a
+					href="/ports-openbsd/">/ports-openbsd/</a> and <a href="/ports-netbsd/">/ports-netbsd/</a>,
+					respectively.  Please read the <a href="http://www.openbsd.org/faq/faq15.html">OpenBSD Ports FAQ</a> or
+					<a href="http://www.netbsd.org/docs/software/packages.html">NetBSD pkgsrc guide</a>, first.
 					</p>
 
+					<h3>
+					OpenBSD port
+					</h3>
+
 					<p class="boxed">
 					# pkg_delete mdocml<br>
 					# cd /usr/ports/devel/<br>
@@ -112,7 +123,20 @@
 					# ftp -V -o- http://mdocml.bsd.lv/ports-openbsd/mdocml.tar.gz | tar -zvxf -<br>
 					# cd mdocml<br>
 					# make build<br>
-					# make regress<br>
+					# make install
+					</p>
+
+					<h3>
+					NetBSD pkgsrc
+					</h3>
+
+					<p class="boxed">
+					# pkg_delete mdocml<br>
+					# cd /usr/pkgsrc/devel/<br>
+					# rm -rf mdocml<br>
+					# ftp -V -o- http://mdocml.bsd.lv/ports-netbsd/mdocml.tar.gz | tar -zvxf -<br>
+					# cd mdocml<br>
+					# make build<br>
 					# make install
 					</p>
 				</td>
@@ -140,7 +164,7 @@
 			<tr>
 				<td>
 					<div class="foot">
-						Copyright &#169; 2009 Kristaps D&#382;onsons, $Date: 2009/02/25 12:37:18 $
+						Copyright &#169; 2009 Kristaps D&#382;onsons, $Date: 2009/02/28 10:13:45 $
 					</div>
 				</td>
 			</tr>