X-Git-Url: https://git.cameronkatri.com/mandoc.git/blobdiff_plain/4a7f9ae0762610908152945fffb1c567aac87557..1b1e02d4acd11f96e061ac04ae243ab0589d2f8a:/index.sgml

diff --git a/index.sgml b/index.sgml
index a3462a08..1d576e14 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 system.
+					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>
@@ -73,50 +78,48 @@
 					i386, AMD64 and Alpha.
 					</p>
 
+					<p>
+					The most current version is <span class="attn">@VERSION@</span>, dated 
+					<span class="attn">@VDATE@</span>.
+					</p>
+
 					<h2>
-					nightly source
+					Snapshot source
 					</h2>
 
 					<p>
-					CVS sources are checkedout and snapshotted nightly.  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>
 
 					<p class="boxed">
 					% cd /tmp<br>
-					% ftp -V -o- http://mdocml.bsd.lv/snapshots/mdocml.tgz | tar -zxf -<br>
+					% ftp -V -o- http://mdocml.bsd.lv/snapshots/mdocml.tar.gz | tar -zvxf -<br>
 					% cd mdocml<br>
-					% make<br>
+					% make all<br>
 					% make regress<br>
-					% make install
+					# make install
 					</p>
 
 					<h2>
-					nightly port
+					Snapshot port
 					</h2>
 
 					<p>
-					The nightly snapshot is automatically converted into an OpenBSD port (ports for other BSD systems not
+					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.
-					</p>
-
-					<p>
-					If installing for the first time:
-					</p>
-
-					<p class="boxed">
-					% ftp -V -o- http://mdocml.bsd.lv/ports-openbsd/mdocml.tgz | tar -zxf -<br>
-					% cd mdocml<br>
-					% sudo make<br>
-					% sudo make install
-					</p>
-
-					<p>
-					Subsequent installations:
+					You <span class="emph">must</span> have the ports tree installed.
 					</p>
 
 					<p class="boxed">
-					% sudo pkg_add -r mdocml
+					# pkg_delete mdocml<br>
+					# cd /usr/ports/devel/<br>
+					# rm -rf mdocml<br>
+					# 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>
 				</td>
 			</tr>
@@ -143,7 +146,7 @@
 			<tr>
 				<td>
 					<div class="foot">
-						Copyright &#169; 2009 Kristaps D&#382;onsons, $Date: 2009/02/23 15:38:20 $
+						Copyright &#169; 2009 Kristaps D&#382;onsons, $Date: 2009/02/27 10:55:16 $
 					</div>
 				</td>
 			</tr>