1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
4 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
5 <meta name="resource-type" content="document">
6 <link rel="stylesheet" href="style.css" type="text/css" media="all">
7 <title>mdocml.bsd.lv</title>
16 <b>mdocml</b> – mdoc macro compiler
27 <span class="nm">mdocml</span> is a suite of tools compiling “-mdoc”, the roff macro
28 package of choice for BSD manual pages. The mission of <span class="nm">mdocml</span> is to deprecate
29 <a href="http://www.gnu.org/software/groff/" class="external">groff</a>, the GNU roff implementation,
30 for displaying -mdoc pages.
34 Why? groff amounts to over 5 MB of source code, most of which is C++ and all of which is GPL. It runs
35 slowly, produces uncertain output, and varies in operation from system to system. mdocml strives to fix
36 this (respectively small, C, ISC-licensed, fast and regular).
40 The core of <span class="nm">mdocml</span> is the libmdoc library, a validating scanner-parser producing
41 intermediate-form output from -mdoc input. libmdoc is a simple, fast library operating on memory
42 buffers, so it can be used for a variety of front-ends (terminal-based, CGI and so on).
46 The primary front-end is <span class="man">mandoc(1)</span>, which formats -mdoc manuals for display on
47 the terminal. The <span class="man">mandoc(1)</span> utility is intended to deprecate usage of <a
48 href="http://www.gnu.org/software/groff/" class="external">groff</a> for displaying mdoc manuals on the
53 <span class="attn">Please submit patches, bug reports and suggestions!</span> Although a significant
54 implementation exists, work remains for the backend library and especially the front-end utilities. See
55 the <a href="#contact">contact</a> information below for submissions.
66 Sources correctly build and install on FreeBSD, OpenBSD, NetBSD and Linux operating systems, tested
67 variously on i386, AMD64, alpha and others.
71 The most current version is <span class="attn">@VERSION@</span>, dated
72 <span class="attn">@VDATE@</span>.
80 CVS sources are checkedout and snapshotted with version updates. These may be found in the <a
81 href="/snapshots/">/snapshots/</a> directory.
86 % ftp -V -o- http://mdocml.bsd.lv/snapshots/mdocml.tar.gz | tar -zvxf -<br>
98 The source snapshot is automatically converted into OpenBSD, NetBSD and FreeBSD ports at <a
99 href="/ports-openbsd/">/ports-openbsd/</a>, <a href="/ports-netbsd/">/ports-netbsd/</a> and <a
100 href="/ports-freebsd/">/ports-freebsd/</a>, respectively. Please read the <a class="external"
101 href="http://www.openbsd.org/faq/faq15.html">OpenBSD Ports FAQ</a>, the <a class="external"
102 href="http://www.netbsd.org/docs/software/packages.html">NetBSD pkgsrc guide</a> or the <a
104 href="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/ports-using.html">FreeBSD ports
113 # pkg_delete mdocml<br>
114 # cd /usr/ports/textproc/<br>
116 # ftp -V -o- http://mdocml.bsd.lv/ports-openbsd/mdocml.tar.gz | tar -zvxf -<br>
127 # pkg_delete mdocml<br>
128 # cd /usr/pkgsrc/textproc/<br>
130 # ftp -V -o- http://mdocml.bsd.lv/ports-netbsd/mdocml.tar.gz | tar -zvxf -<br>
141 # pkg_delete mdocml<br>
142 # cd /usr/ports/textproc/<br>
144 # ftp -V -o- http://mdocml.bsd.lv/ports-freebsd/mdocml.tar.gz | tar -zvxf -<br>
158 Please contact Kristaps, kris<a class="external"
159 href="http://mailhide.recaptcha.net/d?k=01jt88xIsFONwVjHZmGpc4AQ==&c=sb5E6ulipc-eTnpTVqI-BQ=="
160 onclick="window.open('http://mailhide.recaptcha.net/d?k=01jt88xIsFONwVjHZmGpc4AQ==&c=sb5E6ulipc-eTnpTVqI-BQ==',
161 '', 'toolbar=0,scrollbars=0,location=0,statusbar=0,menubar=0,resizable=0,width=500,height=300'); return
162 false;" title="Reveal this e-mail address">...</a>@kth.se, with questions, bug reports, patches, and so on.
166 If you'd like to submit patches, please contact us beforehand in case larger changes are pending but not
167 checked in. If making a bug report, please make sure it's repeatable on the most current snapshot.
174 Copyright © 2008, 2009 Kristaps Džonsons, $Date: 2009/03/24 10:59:50 $