=================================================================== RCS file: /cvs/mandoc/Attic/index.sgml,v retrieving revision 1.6 retrieving revision 1.12 diff -u -p -r1.6 -r1.12 --- mandoc/Attic/index.sgml 2009/02/25 12:32:50 1.6 +++ mandoc/Attic/index.sgml 2009/03/23 21:46:04 1.12 @@ -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
+ The most current version is @VERSION@, dated + @VDATE@. +
+- CVS sources are checkedout and snapshotted with big updates. These may be found in the /snapshots/ directory.
@@ -92,25 +102,59 @@- 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, NetBSD and FreeBSD ports at /ports-openbsd/, /ports-netbsd/ and /ports-freebsd/, respectively. Please read the OpenBSD Ports FAQ, NetBSD pkgsrc guide or FreeBSD Ports Guide first.
+
# pkg_delete mdocml
- # cd /usr/ports/devel/
+ # cd /usr/ports/textproc/
# rm -rf mdocml
# 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/textproc/
+ # rm -rf mdocml
+ # ftp -V -o- http://mdocml.bsd.lv/ports-netbsd/mdocml.tar.gz | tar -zvxf -
+ # cd mdocml
+ # make build
+ # make install
+
+ # pkg_delete mdocml
+ # cd /usr/ports/textproc/
+ # rm -rf mdocml
+ # ftp -V -o- http://mdocml.bsd.lv/ports-freebsd/mdocml.tar.gz | tar -zvxf -
+ # cd mdocml
+ # make build
+ # make install
+