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

diff --git a/index.sgml b/index.sgml
index 3e79cd84..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 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>
@@ -68,50 +73,71 @@
 					INSTALLING SOURCES
 					</h1>
 
+					<p>
+					Sources correctly build and install on OpenBSD, NetBSD and Linux operating systems, tested variously on
+					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/pkgsrc
 					</h2>
 
 					<p>
-					The nightly 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.
+					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>
 
-					<p>
-					If installing for the first time:
-					</p>
+					<h3>
+					OpenBSD port
+					</h3>
 
 					<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
+					# 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 install
 					</p>
 
-					<p>
-					Subsequent installations:
-					</p>
+					<h3>
+					NetBSD pkgsrc
+					</h3>
 
 					<p class="boxed">
-					% sudo pkg_add -r mdocml
+					# 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>
 			</tr>
@@ -138,7 +164,7 @@
 			<tr>
 				<td>
 					<div class="foot">
-						Copyright &#169; 2009 Kristaps D&#382;onsons, $Date: 2009/02/23 15:19:47 $
+						Copyright &#169; 2009 Kristaps D&#382;onsons, $Date: 2009/02/28 10:13:45 $
 					</div>
 				</td>
 			</tr>