=================================================================== RCS file: /cvs/mandoc/Attic/index.sgml,v retrieving revision 1.8 retrieving revision 1.10 diff -u -p -r1.8 -r1.10 --- mandoc/Attic/index.sgml 2009/02/25 12:46:27 1.8 +++ mandoc/Attic/index.sgml 2009/02/28 10:13:45 1.10 @@ -24,14 +24,19 @@
- mdocml is a suite of tools that compile “mdoc”, the roff macro - package of the BSD manual pages. The mission of mdocml is to deprecate mdocml is a suite of tools compiling “mdoc”, the roff macro + package for BSD manual pages. The mission of mdocml is to deprecate groff, 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.
+ 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). +
+ +
The core of mdocml is the libmdoc library, a validating scanner-parser producing
intermediate-form output from mdoc input. libmdoc is a simple, fast library operating on memory buffers
of mdoc input. Its intermediate output, an abstract syntax tree, is fully documented in the
- CVS sources are checkedout and snapshotted with big updates. These may be found in the /snapshots/ directory.
@@ -97,15 +102,20 @@- The source snapshot is automatically converted into an OpenBSD port (ports for other BSD systems not - yet available). These may be found in the /ports-openbsd/ directory. - You must have the ports tree installed. + The source snapshot is automatically converted into OpenBSD port and NetBSD pkgsrc forms at /ports-openbsd/ and /ports-netbsd/, + respectively. Please read the OpenBSD Ports FAQ or + NetBSD pkgsrc guide, first.
+
# pkg_delete mdocml
# cd /usr/ports/devel/
@@ -113,9 +123,22 @@
# ftp -V -o- http://mdocml.bsd.lv/ports-openbsd/mdocml.tar.gz | tar -zvxf -
# cd mdocml
# make build
- # make regress
# make install
+ # pkg_delete mdocml
+ # cd /usr/pkgsrc/devel/
+ # rm -rf mdocml
+ # ftp -V -o- http://mdocml.bsd.lv/ports-netbsd/mdocml.tar.gz | tar -zvxf -
+ # cd mdocml
+ # make build
+ # make install
+