08-10-2011: version 1.12.0
This version features a new, work-in-progress mandoc output mode:
-Tman. This mode allows a system maintainer to distribute man media
for older systems that may not natively support mdoc, such as old
Solaris systems. The -Ofragment option was added to mandoc's -Thtml
and -Txhtml modes.
While adding features, an apropos utility has been merged from the
mandoc-tools sandbox. This interfaces with mandocdb for semantic
search of manual content. apropos is different from the traditional
apropos primarily in allowing keyword search (such as for functions,
utilities, etc.) and regular expressions. Note that the calling
syntax for apropos is likely to change as it settles down.
In documentation news, the mdoc and man manuals have been made
considerably more readable by adding MACRO OVERVIEW sections, by
moving the gory details of the LANGUAGE SYNTAX to the roff manual,
and by moving the very technical MACRO SYNTAX sections down to the
bottom of the page.
Furthermore, for tbl, the -Tascii mode horizontal spacing of tables
was rewritten completely. It is now compatible with groff, both
with and without frames and rulers. Nesting of indented blocks is
now supported in man, and several bugs were fixed regarding
indentation and alignment. The page headers in mdoc are now nicer
for very long titles.
02-09-2011: version 1.11.7
Added demandoc utility for stripping away macros and escapes. This
replaces the historical deroff utility. Also improved the mdoc and
man manuals.
16-08-2011: version 1.11.6
Handling of tr macro in roff implemented. This makes Perl documentation
much more readable. Hyphenation is also now enabled in man format
documents. Many other general improvements have been implemented.
Furthermore, a 64-bit Windows binary is now available at mdocml-win64.zip
and a Mac OS X universal binary is available at mdocml-macosx.zip.
24-07-2011: version 1.11.5
Significant eqn improvements. mdocml can now parse arbitrary eqn
input (although few GNU extensions are accepted, nor is mixing
low-level roff with eqn). See the eqn manual for details. For the
time being, equations are rendered as simple in-line text. The
equation parser satisfies the language specified in the Second
Edition User's Guide.
This is also the first release featuring a distributed Windows
binary, available at /binaries/mdocml-win32.zip.
12-07-2011: version 1.11.4
Bug-fixes and clean-ups across all systems, especially in makewhatis
(note: still not connected to the general build and must be compiled
with make makewhatis) and the man parser. This release was
significantly assisted by participants in OpenBSD's c2k11. Thanks!
26-05-2011: version 1.11.3
Introduce locale-encoding of output with the -Tlocale output option
and Unicode escaped-character input. See mandoc and mandoc_char,
respectively, for details. This allows for non-ASCII characters
(e.g., \[u5000]) to be rendered in the locale's encoding, if said
environment supports wide-character encoding (if it does not,
-Tascii is used instead). Locale support can be turned off at
compile time by removing -DUSE_WCHAR in the Makefile, in which case
-Tlocale is always a synonym for -Tascii.
Furthermore, multibyte-encoded documents, such as those in UTF-8,
may be on-the-fly recoded into mandoc input by using the newly-added
preconv utility. Note: in the future, this feature may be integrated
into mandoc.
12-05-2011: version 1.11.2
Corrected some installation issues in version 1.11.1. Further
migration to libmandoc. Initial public release (this utility is
very much under development) of makewhatis, initially named mandoc-db.
This utility produces keyword databases of manual content mandoc-cgi,
mandoc-tools, which features semantic querying of manual content.
The earlier libroff, libmdoc, and libman soup have been merged into
a single library, libmandoc, which manages all aspects of parsing
real manuals (from line-handling to tbl parsing).
Beyond this structural change, initial eqn functionality is in
place. For the time being, this is limited to the recognition of
equation blocks; future version of mdocml will expand upon this
framework.
As usual, many general fixes and improvements have also occured.
In particular, a great deal of redundancy and superfluous code has
been removed with the merging of the backend libraries.
Many back-end fixes have been implemented: argument handling
(quoting), man improvements, error/warning classes, and many more.
Initial tbl functionality (see the "TS", "TE", and "T&" macros in
the roff manual) has been merged from tbl.bsd.lv. Output is still
minimal, especially 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.
27-09-2010: version 1.10.6
Calling conventions for mandoc have changed: -W improved and -f
deprecated. Non-ASCII characters are also now uniformly discarded.
Lots of documentation improvements. Many incremental fixes accomodating
for groff's more interesting productions. Lastly, pod2man preambles
are now fully accepted after some considerable roff and special
character support.
27-07-2010: version 1.10.5
Primarily a bug-fix and polish release, but including -Tpdf support
in mandoc by way of Summer of Code. Highlights:
* fix "Sm" and "Bd" handling
* fix end-of-sentence handling for embedded sentences
* polish man documentation
* document all mdoc macros
* polish mandoc -Tps output
* lots of internal clean-ups in character escapes
* un-break literal contexts in man documents
* improve -Thtml output for -man
* add mandoc -Tpdf support
12-07-2010: version 1.10.4
Lots of features developed during both Summer of Code and the
OpenBSD c2k10 hackathon:
* minimal "ds" roff symbols are supported
* "Bk" mdoc support
* beautified SYNOPSIS section output
* variable font-width and paper-size support in mandoc -Tps output
* acceptance of scope-block breakage in mdoc
* clarify error message status
* many minor bug-fixes and formatting issues resolved
19-06-2010: version 1.10.2
Small release featuring text-decoration in -Tps output, a few minor
relaxations of errors, and some optimisations.
- Support multiline .Bl -column content
- cleanup SYNOPSIS macro handling
- Allow specifying the terminal width for -Tascii
- Initial PostScript output
- Basic support for the low-level roff macros
- Better support for obsolete .Xo/.Xc macros if compiled with -DUGLY
- Correct handling of opening punctuation in macros for mdoc(7)
- Discard more of the pod2man junk
- Various cleanups and improvements
- significant cleanups in mdoc_term.c
- support for XXn and XXm -offset values
- removed exposure of some libmdoc functions from mdoc.h
- fixed presentation of `Fo', `Vt'
- fixes for clarity in mdoc.7
