</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 system.
+ 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>
i386, AMD64 and Alpha.
</p>
+ <p>
+ The most current version is <span class="attn">@VERSION@</span>, dated
+ <span class="attn">@VDATE@</span>.
+ </p>
+
<h2>
- nightly source
+ Snapshot source
</h2>
<p>
- CVS sources are checkedout and snapshotted
nightly. 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 class="boxed">
% cd /tmp<br>
- % ftp -V -o- http://mdocml.bsd.lv/snapshots/mdocml.tgz | tar -zxf -<br>
+ % ftp -V -o- http://mdocml.bsd.lv/snapshots/mdocml.tar.gz | tar -zvxf -<br>
% cd mdocml<br>
- % make<br>
+ % make all<br>
% make regress<br>
- % make install
+ # make install
</p>
<h2>
- nightly port
+ Snapshot port
</h2>
<p>
- The nightly snapshot is automatically converted into an OpenBSD port (ports for other BSD systems not
+ 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.
- </p>
-
- <p>
- If installing for the first time (you must have the ports tree installed):
- </p>
-
- <p class="boxed">
- % cd /usr/ports/devel/<br>
- % ftp -V -o- http://mdocml.bsd.lv/ports-openbsd/mdocml.tgz | tar -zxf -<br>
- % cd mdocml<br>
- % sudo make<br>
- % sudo make install
- </p>
-
- <p>
- Subsequent installations:
+ You <span class="emph">must</span> have the ports tree installed.
</p>
<p class="boxed">
- % sudo pkg_add -r mdocml
+ # pkg_delete mdocml<br>
+ # cd /usr/ports/devel/<br>
+ # rm -rf mdocml<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>
</td>
</tr>
<tr>
<td>
<div class="foot">
- Copyright © 2009 Kristaps Džonsons, $Date: 2009/02/23 16:01:33 $
+ Copyright © 2009 Kristaps Džonsons, $Date: 2009/02/27 10:55:16 $
</div>
</td>
</tr>
git.ckatri.com / mandoc.git / blobdiff