</h1>
<p>
- <span class="nm">mdocml</span> is a suite of tools that compile “mdoc”, the roff macro
- package
of the BSD manual pages. The mission of <span class="nm">mdocml</span> is to deprecate <a
+ <span class="nm">mdocml</span> is a suite of tools compiling “mdoc”, the roff macro
+ package
for BSD manual pages. The mission of <span class="nm">mdocml</span> is to deprecate <a
href="http://www.gnu.org/software/groff/" class="external">groff</a>, 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.
+ </p>
+
+ <p>
+ 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).
</p>
<p>
<ul>
<li><span class="man">mdocterm(1)</span> – formats mdoc input for display on the terminal
- <li><span class="man">mdochtml(1)</span> – formats mdoc input as strict HTML (nascent)
+ <li><span class="man">mdochtml(1)</span> – formats mdoc input as HTML/CSS (nascent)
<li><span class="man">mdoclint(1)</span> – validates mdoc input
<li><span class="man">mdoctree(1)</span> – prints input abstract syntax tree
</ul>
</p>
<p>
- The most current version is <b>@VERSION@</b>, dated <b>@VDATE@</b>.
+ The most current version is <span class="attn">@VERSION@</span>, dated
+ <span class="attn">@VDATE@</span>.
</p>
<h2>
- snapshotted source
+ Snapshot source
</h2>
<p>
- CVS sources are checkedout and snapshotted with
big updates. These may be found in the <a
+ CVS sources are checkedout and snapshotted with
version updates. These may be found in the <a
href="/snapshots/">/snapshots/</a> directory.
</p>
</p>
<h2>
- nightly port
+ Snapshot port/pkgsrc
</h2>
<p>
- The source snapshot is automatically converted into an OpenBSD port (ports for other BSD systems not
- yet available). These may be found in the <a href="/ports-openbsd/">/ports-openbsd/</a> directory.
- You <span class="emph">must</span> have the ports tree installed.
+ The source snapshot is automatically converted into OpenBSD port and NetBSD pkgsrc forms at <a
+ href="/ports-openbsd/">/ports-openbsd/</a> and <a href="/ports-netbsd/">/ports-netbsd/</a>,
+ respectively. Please read the <a href="http://www.openbsd.org/faq/faq15.html">OpenBSD Ports FAQ</a> or
+ <a href="http://www.netbsd.org/docs/software/packages.html">NetBSD pkgsrc guide</a>, first.
</p>
+ <h3>
+ OpenBSD port
+ </h3>
+
<p class="boxed">
# pkg_delete mdocml<br>
# cd /usr/ports/devel/<br>
# ftp -V -o- http://mdocml.bsd.lv/ports-openbsd/mdocml.tar.gz | tar -zvxf -<br>
# cd mdocml<br>
# make build<br>
- # make regress<br>
+ # make install
+ </p>
+
+ <h3>
+ NetBSD pkgsrc
+ </h3>
+
+ <p class="boxed">
+ # pkg_delete mdocml<br>
+ # cd /usr/pkgsrc/devel/<br>
+ # rm -rf mdocml<br>
+ # ftp -V -o- http://mdocml.bsd.lv/ports-netbsd/mdocml.tar.gz | tar -zvxf -<br>
+ # cd mdocml<br>
+ # make build<br>
# make install
</p>
</td>
<tr>
<td>
<div class="foot">
- Copyright © 2009 Kristaps Džonsons, $Date: 2009/02/25 12:37:18 $
+ Copyright © 2009 Kristaps Džonsons, $Date: 2009/02/28 10:13:45 $
</div>
</td>
</tr>
git.ckatri.com / mandoc.git / blobdiff