summaryrefslogtreecommitdiffstats
path: root/index.7
diff options
context:
space:
mode:
authorKristaps Dzonsons <kristaps@bsd.lv>2008-12-04 16:19:52 +0000
committerKristaps Dzonsons <kristaps@bsd.lv>2008-12-04 16:19:52 +0000
commit7ea64ffd96cef95695a6c74dbf90f76d73fa961d (patch)
tree361049b7cd2f7f22d1b50a1dbfd403c7c0cf1182 /index.7
parentbbaed73e9a14101e88d84225a902613116c536e9 (diff)
downloadmandoc-7ea64ffd96cef95695a6c74dbf90f76d73fa961d.tar.gz
Character-encoding tests.
Diffstat (limited to 'index.7')
-rw-r--r--index.765
1 files changed, 65 insertions, 0 deletions
diff --git a/index.7 b/index.7
new file mode 100644
index 00000000..ff3f0d59
--- /dev/null
+++ b/index.7
@@ -0,0 +1,65 @@
+.\"
+.Dd $Mdocdate$
+.Dt index 7
+.Os LOCAL
+.\"
+.Sh NAME
+.Nm mdocml
+.Nd compile manpage source into mark-up language
+.\"
+.Sh DESCRIPTION
+The
+.Nm
+utility compiles
+.Xr mdoc 7
+macros, such as those inheriting from
+.Xr mdoc.samples 7 ,
+into XML or HTML documents. Unlike other similar utilities such as
+.Xr rman 1
+and
+.Xr man2html 1 ,
+.Nm
+acts directly on source documents, validating its input and producing a
+variety of outputs.
+.Ss Features
+In order to operate properly,
+.Nm
+fully validates its input. This includes, but is not limited to, the
+following checks:
+.Pp
+.Bl -enum -compact
+.It
+special characters (such as
+.Sq \en
+and
+.Sq \et ) ,
+.It
+macro scope (such as
+.Sq \&.Sh
+macros clobbering a pending
+.Sq \&.Bl
+scope),
+.It
+predefined characters (such as \\*(>= and \\*q),
+.It
+correctly-ordered document prelude,
+.El
+.\"
+.Sh ENVIRONMENT
+The
+.Nm
+utility has been tested under Linux and OpenBSD.
+.\"
+.Sh EXAMPLES
+This page was produced as follows:
+.Pp
+.D1 % mdocml -fhtml -o index.html index.7
+.\"
+.Sh SEE ALSO
+TODO.
+.\"
+.Sh AUTHORS
+The
+.Nm
+utility was written by
+.An Em Kristaps Dzonsons Aq kristaps@kth.se .