LogoopenSUSE Build Service > Projects
Sign Up | Log In

Suite of tools for compiling mdoc and man manual pages

mdocml is a suite of tools compiling mdoc, the roff macro package of choice for BSD manual pages, and man, the predominant historical package for UNIX manuals. The mission of mdocml is to deprecate groff, the GNU troff implementation, for displaying mdoc pages whilst providing token support for man.

Why? groff amounts to over 5 MB of source code, most 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).

mdocml consists of the libmandoc validating compiler and mandoc, which interfaces with the compiler library to format output for UNIX terminals (with support for wide-character locales), XHTML, HTML, PostScript, and PDF. It also includes preconv, for recoding multibyte manuals; demandoc, for emitting only text parts of manuals; mandocdb, for indexing manuals; and apropos, whatis, and man.cgi (via catman) for semantic search of manual content. It is a BSD.lv project.

Disambiguation: mdocml is often referred to by its installed binary, "mandoc".

Note: mdocml provides binaries for preconv, apropos and whatis. These binary names are conflicting with existing names. preconv has been renamed to mdpreconv. The other commands creating or using the database (mdocdb, apropos, whatis and man.cgi) are not installed.

Source Files

Filename Size Changed Actions
COPYING 805 Bytes Download File
mdocml-rpmlintrc 127 Bytes Download File
mdocml.Makefile.patch 3.02 KB Download File
mdocml.apropos.man.patch 1.25 KB Download File
mdocml.apropos.patch 334 Bytes Download File
mdocml.changes 342 Bytes Download File
mdocml.preconv.man.patch 895 Bytes Download File
mdocml.spec 3.88 KB Download File
mdocml.tar.bz2 207 KB Download File

Comments for home:vodoo (0)

Login required, please login or signup in order to comment