===================================================================
RCS file: /cvs/mandoc/Attic/index.7,v
retrieving revision 1.5
retrieving revision 1.14
diff -u -p -r1.5 -r1.14
--- mandoc/Attic/index.7	2008/12/07 21:30:49	1.5
+++ mandoc/Attic/index.7	2008/12/10 16:03:12	1.14
@@ -1,5 +1,5 @@
 .\"
-.Dd $Mdocdate: December 7 2008 $
+.Dd $Mdocdate: December 10 2008 $
 .Dt index 7 
 .Os LOCAL
 .\"
@@ -19,8 +19,23 @@ into XML or HTML documents.  Unlike other similar util
 and
 .Xr man2html 1 ,
 .Nm
-acts directly on source documents, validating its input and producing a
-variety of outputs.
+is a full macro parser operating on source documents, specifically mdoc,
+validating input and compiling to HTML and XML output types.
+.Pp
+Downloads (source and ports) are available in the
+.Sx DOWNLOADS
+section.
+.Pp
+The
+.Nm
+utility is tested specifically on
+.Ox 
+manual sources as compiled and invoked both on 
+.Ox
+and Linux.
+.Nm
+is
+.Ud 
 .\"
 .Ss Validation
 In order to operate sanely,
@@ -30,61 +45,92 @@ following checks:
 .Pp
 .Bl -enum -compact
 .It 
-special characters (such as
+valid special characters (such as
 .Sq \en
 and
 .Sq \et ) ,
 .It 
-macro scope (such as
+sane macro scope (such as
 .Sq \&.Sh
 macros clobbering a pending
 .Sq \&.Bl
 scope),
 .It 
-predefined characters (such as \\*(>= and \\*q),
+valid predefined characters (such as \\*(>= and \\*q),
 .It
-correctly-ordered document prelude,
+correctly-ordered prelude and sections,
 .It
-sane argument values (such as those for 
+sane macro argument values (such as those for 
 .Sq \&.Dt
 or
 .Sq \&.Sm ) ,
 .It
+valid manual sections and systems;
+.It
 and so on.
 .El
+.\"
 .Ss Filtering
-When a block of source has been verified, it's passed to the front-end
-fitlers, which format and display data.  The
-.Nm
-utility is invoked with a filter by the
-.Fl f
-flag.  The HTML filter has the following features:
+When a line of source has been parsed, it's passed to the output
+filters, which format and display data.  The two available filters are
+HTML and XML.
+.Pp
+The HTML filter has the following features:
+.Pp
 .Bl -enum -compact
 .It
-HTML-4.01 strict compliance.
+HTML-4.01 strict compliance;
 .It
-Proper render of values in UTF-8, such as
+proper rendering of values in UTF-8, such as
 .Dq quotes
-and \*(>= predefined values.
+and \*(>= predefined values;
 .It
-URI-appearing http://bsd.lv strings are correctly enclosed in link tags.
+URI-appearing http://bsd.lv/ strings are correctly enclosed in link tags;
 .It
-CSS-dictated style with meaningful non-CSS defaults.
+CSS-dictated style with meaningful non-CSS defaults;
+.It
+and so on.
 .El
+.Pp
+The XML filter creates a correct XML tree with 
+.Dq block ,
+.Dq head ,
+.Dq body ,
+and
+.Dq inline
+namespaces corresponding to macro categories.  Namespace identifiers
+correspond to their definitions.  A sample is available at
+http://mdocml.bsd.lv/index.xml
+.Ns .
 .\" 
-.Sh ENVIRONMENT
-The
+.Sh DOWNLOADS
+Download 
 .Nm
-utility has been tested under Linux and 
-.Ox ,
-specifically on
-.Ox 
-manual source.
+at http://mdocml.bsd.lv/mdocml.tar.gz
+.Ns . 
+.\" - UPDATE ME WITH EVERY RELEASE. ----------------------------------
+The current version is 1.0.3, dated 10/12/2008.
+.\" ------------------------------------------------------------------
+.Pp
+An OpenBSD port is available at http://mdocml.bsd.lv/mdocml-port.tar.gz
+.Ns .
+.Pp
+Previous versions are archived as mdocml-x.y.z.tar.gz, with the appropriate
+versions filled in.
 .\" 
+.Sh DOCUMENTS
+The manual for 
+.Nm
+is available at http://mdocml.bsd.lv/mdocml.html
+.Ns .
+.\" 
 .Sh EXAMPLES
 This page was produced as follows:
 .Pp
-.D1 % mdocml -fhtml -W -e -o index.html index.7
+.D1 % mdocml -fhtml -Wall -e -o index.html index.7
+.Pp
+The original mdoc source is at http://mdocml.bsd.lv/index.txt 
+.Ns .
 .\"
 .Sh SEE ALSO
 .Bl -ohang
@@ -99,6 +145,8 @@ text and produces HTML output.
 and
 .Ox 
 project CGI for producing HTML from nroff source.
+.It Xr roffit Ns : http://daniel.haxx.se/projects/roffit/
+HTML from roff manual source.  Dead project?
 .El
 .\"
 .Sh AUTHORS