mandoc (formerly mdocml) — UNIX manpage compiler — current version 1.14.3 (Aug 5, 2017)

The mandoc UNIX manpage compiler toolset

mandoc is a suite of tools compiling mdoc, the roff macro language of choice for BSD manual pages, and man, the predominant historical language for UNIX manuals. It is small, ISO C, ISC-licensed, and quite fast. The main component of the toolset is the mandoc utility program, based on the libmandoc validating compiler, to format output for UTF-8 and ASCII UNIX terminals, HTML 5, PostScript, and PDF.

mandoc 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 FreeBSD, NetBSD, DragonFly, illumos, Minix 3, and both GNU- and musl-based Linux distributions, as well as all systems running the pkgsrc portable package build system. To support mandoc development, consider donating to the OpenBSD foundation.

News

• June 8, 2018: Ingo Schwarze gave a talk about mandoc during BSDCan.
• August 5, 2017: Version 1.14.3 was released, fixing a small number of bugs that escaped testing in 1.14.2. For details, see the release notes.
• July 28, 2017: Version 1.14.2 was released, introducing the new -Tmarkdown output mode, -Thtml anchors, mdoclint(1) integration, tbl(7) line breaking, a new eqn(7) lexer, and many new roff(7) features.
• February 21, 2017: Version 1.14.1 was released, removing the dependency on SQLite without loss of functionality, improving less(1) -T and :t support, much improving -Thtml output, and including a new catman(8) utility and a portable regression suite.
• January 18, 2017: manpages.debian.org was redeployed by Michael Stapelberg using mandoc as the HTML generation engine.
• October 1 to 4, 2015: Ingo Schwarze gave a regular talk about mandoc and a tutorial about mdoc(7) during EuroBSDcon.

Documentation and help

• For users: mandoc(1) — man(1) — apropos(1) — man.conf(5) — makewhatis(8) — man.cgi(8) — mandocd(8) — catman(8) — soelim(1) — demandoc(1)
• For authors: mdoc(7) & extended documentation — man(7) — roff(7) — mandoc_char(7) — tbl(7) — eqn(7) — Practical UNIX manuals
• For programmers: mandoc(3) — mandoc_escape(3) — mandoc_malloc(3) — mchars_alloc(3) — mandoc.db(5) — OpenBSD porting guide — mandoc_headers(3) — mandoc_html(3) — mansearch(3) — man.cgi(3) — tbl(3) — man.options(1) — TODO list
• Commented documentation index — Online manual page portals: OpenBSD — Debian – Arch – Void Linux
• Contact the mandoc developers, for example for bug reports or for questions.

Availability and installation

• Systems already including mandoc: No manual installation is required on these systems.
• Newest release tarball — archive of release tarballs — copyright and license
• CVS web interface — Anonymous CVS access

Related information

• release notes — development history — porting history — ChangeLog — commented history index
• Publications and media coverage concerning mandoc
• History of UNIX manpages
• pod2mdoc — a utility to convert perlpod(1) documents to mdoc(7)
• texi2mdoc — a utility to convert GNU Texinfo documents to mdoc(7)
• docbook2mdoc — an experimental utility to convert documents from the commercial OASIS DocBook format to mdoc(7)
• debiman — static website generator for manual page web servers, using mandoc as the HTML generation engine
• Additional web links

Copyright © 2008, 2009, 2010, 2011 Kristaps Dzonsons, © 2013, 2014, 2015, 2016, 2017 Ingo Schwarze, $Date: 2018/06/11 16:38:26 $
This server is running httpd on OpenBSD in the NYC*BUG rack sponsored and hosted by New York Internet. Thanks for all that!