- DESCRIPTION -
+
+ 
+ mdocml – UNIX manpage compiler, current version @VERSION@ (@VDATE@)
+
+ Sources: current, + cvsweb + (archives) +
++ Description +
++ 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. + It is small, ISO C, ISC-licensed, and quite fast. +
++ The tool set features mandoc, + based on the libmandoc validating compiler, + 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. +
++ mdocml has predominantly been developed on OpenBSD + and is both an OpenBSD + and a BSD.lv project. + We strive to support all interested free operating systems, in particular + DragonFly, + NetBSD, + FreeBSD, + Minix 3, + and GNU/Linux, + as well as all systems running the pkgsrc portable package build system. + All of these projects have helped to make mdocml better, by providing feedback and advice, + bug reports, and patches. +
+
+ Disambiguation: mdocml is often referred to by its installed binary, mandoc
.
+
+ Sources +
+
+ mdocml is in ISO C99 and should build and run on any modern system; however, you'll need sqlite3 to build apropos (links to whatis),
+ man.cgi, and mandocdb.
+ To build and install into /usr/local/, just run make install.
+ Be careful: the preconv, apropos, and whatis binary names are usually taken by existing utilities.
+
+ Downstream +
+
+ Several systems come bundled with mdocml utilities.
+ If your system does not appear below, the maintainers have not contacted me and it should not be considered
+ official
, so please contact us if you plan on maintaining a downstream version!
+
| DragonFly BSD | ++ contrib/mdocml (1.12.3 sources) + lib/libmandoc + usr.bin/mandoc (build system) + | +
| FreeBSD 10.0, -CURRENT | ++ contrib/mdocml (1.12.1 sources) + usr.bin/mandoc (build system) + | +
| FreeBSD 9.x, 8.x | ++ ports/textproc/mdocml (1.12.2 port) + | +
| NetBSD | ++ src/external/bsd/mdocml (1.12.1 sources plus patches and build system) + | +
| OpenBSD | ++ src/usr.bin/mandoc (1.12.3 sources under active development and build system) + | +
| pkgsrc | ++ textproc/mdocml (1.12.3 port) + | +
| Minix3 | ++ external/bsd/mdocml (1.10.9 sources and build system) + | +
| Alpine Linux | ++ aports/main/mdocml (1.12.2 port) + | +
+ Documentation +
++ These manuals are generated automatically and refer to the current release. + They are the authoritative documentation for the mdocml system. +
-
- 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 libmdoc, libman, and libroff validating compilers; and mandoc, which interfaces with the compiler libraries to format output for UNIX - terminals, XHTML, HTML, PostScript, and PDF. It is a BSD.lv project. -
- -
- Disambiguation: mdocml is often referred to by its installed binary,
- mandoc
.
-
- SOURCES -
- -- mdocml is architecture- and system-neutral, written in plain-old C. The most - current version is @VERSION@, dated @VDATE@. A full - ChangeLog (txt) is written with each release. -
- -- Current -
- -| Source archive | -- /snapshots/mdocml.tar.gz - (md5) - | -
| Online source | -- cvsweb - | -
- Downstream -
- -| DragonFly BSD | -- usr.bin/mandoc - | -
| FreeBSD | -- ports/textproc/mdocml - | -
| NetBSD | -- src/external/bsd/mdocml - | -
| OpenBSD | -- src/usr.bin/mandoc - | -
- Historical -
- -| Source archive | -- /snapshots/ - | -
- DOCUMENTATION -
- -- These manuals are generated automatically and refer to the current snapshot. -
- -| man(3) | -- man macro compiler library - - (text | - xhtml | - pdf | - postscript) - - | -
| man(7) | -- man language reference - - (text | - xhtml | - pdf | - postscript) - - | -
| mandoc(1) | -- format and display UNIX manuals - - (text | - xhtml | - pdf | - postscript) - - | -
| mandoc_char(7) | -- mandoc special characters - - (text | - xhtml | - pdf | - postscript) - - | -
| mdoc(3) | -- mdoc macro compiler library - - (text | - xhtml | - pdf | - postscript) - - | -
| mdoc(7) | -- mdoc language reference - - (text | - xhtml | - pdf | - postscript) - - | -
| roff(3) | -- roff macro compiler library - - (text | - xhtml | - pdf | - postscript) - - | -
| roff(7) | -- roff-mandoc language reference - - (text | - xhtml | - pdf | - postscript) - - | -
| tbl(7) | -- tbl-mandoc language reference - - (text | - xhtml | - pdf | - postscript) - - | -
- See Writing UNIX Manual Pages
for a general
- introduction to manpages and mdoc.
-
- CONTACT -
- -- Please use the mailing lists for bug-reports, patches, questions, etc. (these require - subscription). Beyond that, contact Kristaps at kris...@bsd.lv. -
- -| - disc...@mdocml.bsd.lv - | -- bug-reports, general questions, and announcements - (archive) - | -
| - tec...@mdocml.bsd.lv - | -- patches and system discussions - (archive) - | -
| - sou...@mdocml.bsd.lv - | -- source commit messages - (archive) - | -
- NEWS -
-- 03-01-2011: - version 1.10.9 -
-- Many back-end fixes have been implemented: argument handling (quoting), man improvements, error/warning classes, and many more. -
-
- tbl functionality (see the TS
, TE
, and
- T&
macros in the roff manual) has been
- merged from tbl.bsd.lv. Output is
- still minimal for -Thtml and -Txhtml, but manages to at least display data. This means that mandoc now has built-in support for two troff preprocessors via
- libroff: soelim and tbl.
-
- 24-12-2010: - version 1.10.8 -
-- Significant improvements merged from OpenBSD downstream, including -
--
-
- many new roff components, -
- in-line implementation of troff's soelim, -
- broken-block handling, -
- overhauled error classifications, and -
- cleaned up handling of error conditions. -
- Also overhauled the -Thtml and -Txhtml output modes. They now display readable output in arbitrary - browsers, including text-based ones like lynx. See HTML and XHTML manuals in the DOCUMENTATION section for examples. Attention: available style-sheet classes have been considerably - changed! See the example.style.css file for details. - Lastly, libmdoc and libman have been - cleaned up and reduced in size and complexity. -
-- See cvsweb for - historical notes. -
-