[BACK]Return to NEWS CVS log [TXT][DIR] Up to [cvsweb.bsd.lv] / mandoc

Annotation of mandoc/NEWS, Revision 1.8

1.8     ! schwarze    1: $Id: NEWS,v 1.7 2014/12/09 12:05:44 schwarze Exp $
1.1       schwarze    2:
                      3: This file lists the most important changes in the mdocml.bsd.lv distribution.
1.7       schwarze    4:
1.8     ! schwarze    5: Changes in version 1.13.2, released on December 13, 2014
1.7       schwarze    6:
                      7:     --- MAJOR NEW FEATURES ---
                      8:  * Include an implementation of man(1), the manual page viewer.
                      9:  * Unified set of command line option, each one supported by all
                     10:    command names, including new options -a (format all), -c (no
                     11:    pager), -h (synopsis only), and -w (list filenames).
                     12:  * Support the MANPAGER and PAGER environment variables.
                     13:  * Support gzip'ed manuals by the whole toolset, even as .so targets.
                     14:  * Support UTF-8 and Latin-1 input by the whole toolset, delete preconv(1).
                     15:  * Switch the default output mode from -Tascii to -Tlocale.
                     16:  * Improve -Tascii output for Unicode escape sequences.
                     17:  * Let the -Thtml output mode produce polyglot HTML5.
                     18:  * Many improvements for eqn(7), in particular in-line equations,
                     19:    MathML output in -Thtml mode, and much improved terminal formatting.
                     20:     --- PORTABILITY IMPROVEMENTS ---
                     21:  * Change the build sequence to the usual ./configure; make; make install.
                     22:  * Support ./configure.local for build customizations.
                     23:  * Autodetect wchar, sqlite3, and manpath support.
                     24:  * Provide a fallback version of fts(3) for systems lacking it.
                     25:  * Support choosing alternative binary and manual names.
                     26:     --- MINOR NEW FEATURES ---
                     27:  * Rudimentary implementation of the e, x, and z tbl(7) layout
                     28:    modifiers to equalize, maximize, and ignore the width of columns.
                     29:  * Implement font modifiers in tbl(7) layouts.
                     30:  * Allow comma-separated options in the tbl(7) options line.
                     31:  * Parse and ignore the .pl (page length) roff(7) request.
                     32:  * Implement .An -[no]split for the mdoc(7) -Thtml output mode.
                     33:  * Support bold italic font in PostScript and PDF output.
                     34:  * Warn about commas in function arguments and parentheses in function names.
                     35:  * Warn about botched .Xr ordering and punctuation below SEE ALSO.
                     36:  * Warn about AUTHORS sections without .An macros.
                     37:  * Warn about attempts to call non-callable macros.
                     38:  * New developer documentation manual page mandoc_headers(3).
                     39:     --- BUGFIXES ---
                     40:  * Fix read buffer overrun sometimes triggered by trailing whitespace.
                     41:  * Fix read buffer overrun triggered by certain invalid \H sequences.
                     42:  * Fix NULL pointer access triggered by .Bl without any arguments.
                     43:  * Fix NULL pointer access triggered by .It Nm Fo without .Fc.
                     44:  * Fix NULL pointer access triggered by .Sh Xo .Sh without .Xc.
                     45:  * Fix NULL pointer access triggered by missing .Nm.
                     46:  * Fix an assertion triggered by .It right after .El.
                     47:  * Fix an assertion triggered by .Ec without preceding .Eo.
                     48:  * Fix an assertion triggered by .Sm or .Db with multiple arguments.
                     49:  * Fix assertion failures triggered by very large width arguments.
                     50:  * Fix a division by zero in the roff(7) parser.
                     51:  * Prevent negative arguments to .ll from causing integer underflow.
                     52:  * Correctly autodetect source format even when .Dd is preceded by .ll.
                     53:  * Multiple fixes with respect to .Bd and .Bl -offset and -width.
                     54:  * Many bugfixes with respect to scaling units.
                     55:  * Multiple fixes with respect to delimiter handling by in-line macros.
                     56:  * Multiple fixes with respect to .Pf.
                     57:  * Make \c work properly in no-fill mode.
                     58:  * Stricter syntax checking of Unicode character names.
                     59:     --- THANKS TO ---
                     60:  * Kristaps Dzonsons for rewriting the eqn(7) parser, implementing
                     61:    HTML5 and MathML output, and various other code contributions.
                     62:  * Jonathan Gray (OpenBSD) for extensive testing with afl (the
                     63:    American Fuzzy Lop security fuzzer) resulting in many bug reports.
                     64:  * Anthony Bentley (OpenBSD), Baptiste Daroussin (FreeBSD), Daniel
                     65:    Dickman, Doug Hogan, Jason McIntyre, Theo de Raadt (OpenBSD),
                     66:    and Martin Natano for source code patches.
                     67:  * Carsten Kunze (Heirloom troff), Daniel Levai (Slackware),
                     68:    Garrett D'Amore (illumos), Giovanni Becchis, Matthew Dempsky,
                     69:    Stuart Henderson, Ted Unangst, Todd Miller (OpenBSD), Thomas
                     70:    Klausner (NetBSD), Ulrich Spoerlein (FreeBSD), Justin Haynes,
                     71:    Marcus Merighi, Sebastien Marie, Steffen Nurpmeso and Theo Buehler
                     72:    for bug reports.
1.5       schwarze   73:
                     74: Changes in version 1.13.1, released on August 10, 2014
                     75:
                     76:     --- MAJOR NEW FEATURES ---
                     77:  * A complete apropos(1)/makewhatis(8)/man.cgi(8) suite
                     78:    based on SQLite3 is now included.
                     79:  * The roff(7) parser now provides an almost complete implementation
                     80:    of numerical expressions.
                     81:  * Warning and error messages have been improved in many ways.
                     82:    Almost all fatal errors were downgraded to normal errors and some
                     83:    even to warnings.  Almost all messages now mention the macro where
                     84:    the issue is detected and many indicate the workaround employed.
                     85:    The mandoc(1) manual now includes a list explaining all messages.
                     86:     --- MINOR NEW FEATURES ---
                     87:  * The roff(7) parser now supports the .ami (append to macro with
                     88:    indirectly specified name), .as (append to user-defined
                     89:    string), .dei (define macro with indirectly specified name),
                     90:    .ll (line length), and .rr (remove register) requests.
                     91:  * The roff(7) parser now supports string comparison and numerical
                     92:    conditionals in the .if and .ie requests.
                     93:  * The roff parser now fully supports the \B (validate numerical
                     94:    expression) and partially supports the \w (measure text width)
                     95:    escape sequences.
                     96:  * The terminal formatter now supports the \: (optional line break)
                     97:    escape sequence.
                     98:  * The roff parser now supports expansion of user-defined strings
                     99:    involving indirect references.
                    100:  * The roff(7) parser now handles some pre-defined read-only
                    101:    number registers that occur in the pod2man(1) preamble.
                    102:  * For backward compatibility, the mdoc(7) parser and formatters
                    103:    now support the obsolete macros .En, .Es, .Fr, and .Ot.
                    104:  * The mdoc(7) formatter non partially supports .Bd -centered.
                    105:  * tbl(7) now handles leading and trailing vertical lines.
                    106:  * The build system now provides fallback versions of strcasestr(3)
                    107:    and strsep(3) for systems lacking them.
                    108:  * The mdoc(7) manual now explains how various standards
                    109:    supported by the .St macro are related to each other.
                    110:     --- BUGFIXES ---
                    111:  * In the roff(7) parser, several bugs were fixed with respect
                    112:    to closing conditional blocks on macro lines.
                    113:  * Parsing of roff(7) identifiers and escape sequences was improved
                    114:    in multiple respects.
                    115:  * In the mdoc(7) parser, the handling of defective document
                    116:    prologues was improved in multiple ways.
                    117:  * The mdoc(7) parser no longer skips content before the first section
                    118:    header, and it no longer deletes non-.% content from .Rs blocks.
                    119:  * In the mdoc(7) parser, a crash was fixed related to weird .Sh headers.
                    120:  * In the mdoc(7) parser, handling of .Sm with missing or invalid
                    121:    arguments was corrected.
                    122:  * In the mdoc(7) parser, trailing punctuation at the end of partial
                    123:    implicit macros no longer triggers end-of-sentence spacing.
                    124:  * In the terminal formatter, two crashes were fixed: one triggered by
                    125:    excessive indentation and another by excessively long .Nm arguments.
                    126:  * In the terminal formatter, a floating point rounding bug was
                    127:    fixed that sometimes caused an off-by-one error in indentation.
                    128:  * In the UTF-8 formatter, rendering of accents, breakable hyphens,
                    129:    and non-breakable spaces was corrected.
                    130:  * In the HTML formatter, encoding of special characters was
                    131:    corrected in multiple respects.
                    132:  * In the mdoc(7) formatter, rendering of .Ex and .Rv was
                    133:    improved for various edge cases.
                    134:  * In the mdoc(7) formatter, handling of empty .Bl -inset item
                    135:    heads was improved.
                    136:  * In the man(7) formatter, some bugs were fixed with respect
                    137:    to same-line detection in the context of .TP and .nf macros,
                    138:    and the indentation of .IP and .TP blocks was improved.
                    139:  * The mandoc(3) library no longer prints to stderr.
                    140:     --- THANKS TO ---
                    141:    Abhinav Upadhyay (NetBSD), Andreas Voegele, Anthony Bentley (OpenBSD),
                    142:    Christian Weisgerber (OpenBSD), Havard Eidnes (NetBSD), Jan Stary,
                    143:    Jason McIntyre (OpenBSD), Jeremie Courreges-Anglas (OpenBSD),
                    144:    Joerg Sonnenberger (NetBSD), Juan Francisco Cantero Hurtado (OpenBSD),
                    145:    Marc Espie (OpenBSD), Matthias Scheler (NetBSD), Pascal Stumpf (OpenBSD),
                    146:    Paul Onyschuk (Alpine Linux), Sebastien Marie, Steffen Nurpmeso,
                    147:    Stuart Henderson (OpenBSD), Ted Unangst (OpenBSD), Theo de Raadt (OpenBSD),
                    148:    Thomas Klausner (NetBSD), and Ulrich Spoerlein (FreeBSD)
                    149:    for reporting bugs and missing features.
1.4       schwarze  150:
                    151: Changes in version 1.12.3, released on December 31, 2013
                    152:
                    153:  * In the mdoc(7) SYNOPSIS, line breaks and hanging indentation
                    154:    now work correctly for .Fo/.Fa/.Fc and .Fn blocks.
                    155:    Thanks to Franco Fichtner for doing part of the work.
                    156:  * The mdoc(7) .Bk macro got some addititonal bugfixes.
                    157:  * In mdoc(7) macro arguments, double quotes can now be quoted
                    158:    by doubling them, just like in man(7).
                    159:    Thanks to Tsugutomo ENAMI for the patch.
                    160:  * At the end of man(7) macro lines, end-of-sentence spacing
                    161:    now works.  Thanks to Franco Fichtner for the patch.
                    162:  * For backward compatibility, the man(7) parser now supports the
                    163:    man-ext .UR/.UE (uniform resource identifier) block macros.
                    164:  * The man(7) parser now handles closing blocks that are not open
                    165:    more gracefully.
                    166:  * The man(7) parser now ignores blank lines right after .SH and .SS.
                    167:  * In the man(7) formatter, reset indentation when leaving a block,
                    168:    not just when entering the next one.
                    169:  * The roff(7) .nr request now supports incrementing and decrementing
                    170:    number registers and stops parsing the number right before the
                    171:    first non-digit character.
                    172:  * The roff(7) parser now supports the alternative escape sequence
                    173:    syntax \C'uXXXX' for Unicode characters.
                    174:  * The roff(7) parser now parses and ignores the .fam (font family)
                    175:    and .hw (hyphenation points) requests and the \d and \u escape
                    176:    sequences.
                    177:  * The roff(7) manual got a new ESCAPE SEQUENCE REFERENCE.
1.1       schwarze  178:
1.2       schwarze  179: Changes in version 1.12.2, released on Oktober 5, 2013
1.1       schwarze  180:
                    181:  * The mdoc(7) to man(7) converter, to be called as mandoc -Tman,
                    182:    is now fully functional.
                    183:  * The mandoc(1) utility now supports the -Ios (default operating system)
                    184:    input option, and the -Tutf8 output mode now actually works.
                    185:  * The mandocdb(8) utility no longer truncates existing databases when
                    186:    starting to build new ones, but only replaces them when the build
                    187:    actually succeeds.
                    188:  * The man(7) parser now supports the PD macro (paragraph distance),
                    189:    and (for GNU man-ext compatibility only) EX (example block) and EE
                    190:    (example end).  Plus several bugfixes regarding indentation, line
                    191:    breaks, and vertical spacing, and regarding RS following TP.
                    192:  * The roff(7) parser now supports the \f(BI (bold+italic) font escape,
                    193:    the \z (zero cursor advance) escape and the cc (change control
                    194:    character) and it (input line trap) requests. Plus bugfixes regarding
                    195:    the \t (tab) escape, nested escape sequences, and conditional requests.
                    196:  * In mdoc(7), several bugs were fixed related to UTF-8 output of quoting
                    197:    enclosures, delimiter handling, list indentation and horizontal and
                    198:    vertical spacing, formatting of the Lk, %U, and %C macros, plus some
                    199:    bugfixes related to the handling of syntax errors like badly nested
                    200:    font blocks, stray Ta macros outside column lists, unterminated It Xo
                    201:    blocks, and non-text children of Nm blocks.
                    202:  * In tbl(7), the width of horizontal spans and the vertical spacing
                    203:    around tables was corrected, and in man(7) files, a crash was fixed
                    204:    that was triggered by some particular unclosed T{ macros.
                    205:  * For mandoc developers, we now provide a tbl(3) library manual and
                    206:    gmdiff, a very small, very simplistic groff-versus-mandoc output
                    207:    comparison tool.
1.2       schwarze  208:  * Provide this NEWS file.
1.1       schwarze  209:
                    210: Changes in version 1.12.1, released on March 23, 2012
                    211:
                    212:  * Significant work on apropos(1) and mandocdb(8). These tools are now
                    213:    much more robust.  A whatis(1) implementation is now handled as an
                    214:    apropos(1) mode.  These tools are also able to minimally handle
                    215:    pre-formatted pages, that is, those already formatted by another
                    216:    utility such as GNU troff.
                    217:  * The man.cgi(7) script is also now available for wider testing.
                    218:    It interfaces with mandocdb(8) manuals cached by catman(8).
                    219:    HTML output is generated on-the-fly by libmandoc or internal
                    220:    methods to convert pre-formatted pages.
                    221:  * The mailing list archive for the discuss and tech lists are being
                    222:    hosted by Gmane at gmane.comp.tools.mdocml.user and
                    223:    gmane.comp.tools.mdocml.devel, respectively.
                    224:
                    225: Changes in version 1.12.0, released on October 8, 2011
                    226:
                    227:  * This version features a new, work-in-progress mandoc(1) output mode:
                    228:    -Tman.  This mode allows a system maintainer to distribute man(7)
                    229:    media for older systems that may not natively support mdoc(7), such
                    230:    as old Solaris systems.
                    231:  * The -Ofragment option was added to mandoc(1)'s -Thtml and -Txhtml modes.
                    232:  * While adding features, an apropos(1) utility has been merged from the
                    233:    mandoc-tools sandbox.  This interfaces with mandocdb(8) for semantic
                    234:    search of manual content.  apropos(1) is different from the traditional
                    235:    apropos primarily in allowing keyword search (such as for functions,
                    236:    utilities, etc.) and regular expressions.  Note that the calling
                    237:    syntax for apropos is likely to change as it settles down.
                    238:  * In documentation news, the mdoc(7) and man(7) manuals have been
                    239:    made considerably more readable by adding MACRO OVERVIEW sections, by
                    240:    moving the gory details of the LANGUAGE SYNTAX to the roff(7) manual,
                    241:    and by moving the very technical MACRO SYNTAX sections down to the
                    242:    bottom of the page.
                    243:  * Furthermore, for tbl(7), the -Tascii mode horizontal spacing of tables
                    244:    was rewritten completely.  It is now compatible with groff(1), both
                    245:    with and without frames and rulers.
                    246:  * Nesting of indented blocks is now supported in man(7), and several
                    247:    bugs were fixed regarding indentation and alignment.
                    248:  * The page headers in mdoc(7) are now nicer for very long titles.
                    249:
                    250: Changes in version 1.11.7, released on September 2, 2011
                    251:
                    252:  * Added demandoc(1) utility for stripping away macros and escapes.
                    253:    This replaces the historical deroff(1) utility.
                    254:  * Also improved the mdoc(7) and man(7) manuals.
                    255:
                    256: Changes in version 1.11.6, released on August 16, 2011
                    257:
                    258:  * Handling of tr macro in roff(7) implemented.  This makes Perl
                    259:    documentation much more readable.  Hyphenation is also now enabled in
                    260:    man(7) format documents.  Many other general improvements have been
                    261:    implemented.
                    262:
                    263: Changes in version 1.11.5, released on July 24, 2011
                    264:
                    265:  * Significant eqn(7) improvements.  mdocml can now parse arbitrary eqn
                    266:    input (although few GNU extensions are accepted, nor is mixing
                    267:    low-level roff with eqn).  See the eqn(7) manual for details.
                    268:    For the time being, equations are rendered as simple in-line text.
                    269:    The equation parser satisfies the language specified in the
                    270:    Second Edition User's Guide:
                    271:    http://www.kohala.com/start/troff/v7man/eqn/eqn2e.ps
                    272:
                    273: Changes in version 1.11.4, released on July 12, 2011
                    274:
                    275:  * Bug-fixes and clean-ups across all systems, especially in mandocdb(8)
                    276:    and the man(7) parser.  This release was significantly assisted by
                    277:    participants in OpenBSD's c2k11.  Thanks!
                    278:
                    279: Changes in version 1.11.3, released on May 26, 2011
                    280:
                    281:  * Introduce locale-encoding of output with the -Tlocale output option and
                    282:    Unicode escaped-character input.  See mandoc(1) and mandoc_char(7),
                    283:    respectively, for details.  This allows for non-ASCII characters (e.g.,
                    284:    \[u5000]) to be rendered in the locale's encoding, if said environment
                    285:    supports wide-character encoding (if it does not, -Tascii is used
                    286:    instead).  Locale support can be turned off at compile time by removing
                    287:    -DUSE_WCHAR in the Makefile, in which case -Tlocale is always a synonym
                    288:    for -Tascii.
                    289:  * Furthermore, multibyte-encoded documents, such as those in UTF-8, may
                    290:    be on-the-fly recoded into mandoc(1) input by using the newly-added
                    291:    preconv(1) utility.  Note: in the future, this feature may be
                    292:    integrated into mandoc(1).
                    293:
                    294: Changes in version 1.11.2, released on May 12, 2011
                    295:
                    296:  * Corrected some installation issues in version 1.11.1.
                    297:  * Further migration to libmandoc.
                    298:  * Initial public release (this utility is very much under development)
                    299:    of mandocdb(8).  This utility produces keyword databases of manual
                    300:    content, which features semantic querying of manual content.
                    301:
                    302: Changes in version 1.11.1, released on April 4, 2011
                    303:
                    304:  * The earlier libroff, libmdoc, and libman soup have been merged into
                    305:    a single library, libmandoc, which manages all aspects of parsing
                    306:    real manuals, from line-handling to tbl(7) parsing.
                    307:  * As usual, many general fixes and improvements have also occurred.
                    308:    In particular, a great deal of redundancy and superfluous code has
                    309:    been removed with the merging of the backend libraries.
1.3       schwarze  310:  * see also the changes in 1.10.10
                    311:
                    312: Changes in version 1.10.10, March 20, 2011, NOT released
                    313:
                    314:  * Initial eqn(7) functionality is in place.  For the time being,
                    315:    this is limited to the recognition of equation blocks;
                    316:    future version of mdocml will expand upon this framework.
1.1       schwarze  317:
                    318: Changes in version 1.10.9, released on January 7, 2011
                    319:
                    320:  * Many back-end fixes have been implemented: argument handling (quoting),
                    321:    man(7) improvements, error/warning classes, and many more.
                    322:  * Initial tbl(7) functionality (see the "TS", "TE", and "T&" macros in
                    323:    the roff(7) manual) has been merged from tbl.bsd.lv.  Output is still
                    324:    minimal, especially for -Thtml and -Txhtml, but manages to at least
                    325:    display data.  This means that mandoc(1) now has built-in support
                    326:    for two troff preprocessors via libroff: soelim(1) and tbl(1).
                    327:
                    328: Changes in version 1.10.8, released on December 24, 2010
                    329:
1.3       schwarze  330:  * Overhauled the -Thtml and -Txhtml output modes.  They now display
1.1       schwarze  331:    readable output in arbitrary browsers, including text-based ones like
                    332:    lynx(1).  See HTML and XHTML manuals in the DOCUMENTATION section
                    333:    for examples.  Attention: available style-sheet classes have been
                    334:    considerably changed!  See the example.style.css file for details.
                    335:    Lastly, libmdoc and libman have been cleaned up and reduced in size
                    336:    and complexity.
1.3       schwarze  337:  * see also the changes in 1.10.7
                    338:
                    339: Changes in version 1.10.7, December 6, 2010, NOT released
                    340:
                    341:  Significant improvements merged from OpenBSD downstream, including:
                    342:  * many new roff(7) components,
                    343:  * in-line implementation of troff's soelim(1),
                    344:  * broken-block handling,
                    345:  * overhauled error classifications, and
                    346:  * cleaned up handling of error conditions.
1.1       schwarze  347:
                    348: Changes in version 1.10.6, released on September 27, 2010
                    349:
                    350:  * Calling conventions for mandoc(1) have changed: -W improved and -f
                    351:    deprecated.
                    352:  * Non-ASCII characters are also now uniformly discarded.
                    353:  * Lots of documentation improvements.
                    354:  * Many incremental fixes accomodating for groff's more interesting
                    355:    productions.
                    356:  * Lastly, pod2man(1) preambles are now fully accepted after some
                    357:    considerable roff(7) and special character support.
                    358:
                    359: Changes in version 1.10.5, released on July 27, 2010
                    360:
                    361:  * Primarily a bug-fix and polish release, but including -Tpdf support
                    362:    in mandoc(1) by way of "Summer of Code".  Highlights:
                    363:  * fix "Sm" and "Bd" handling
                    364:  * fix end-of-sentence handling for embedded sentences
                    365:  * polish man(7) documentation
                    366:  * document all mdoc(7) macros
                    367:  * polish mandoc(1) -Tps output
                    368:  * lots of internal clean-ups in character escapes
                    369:  * un-break literal contexts in man(7) documents
                    370:  * improve -Thtml output for -man
                    371:  * add mandoc(1) -Tpdf support
                    372:
                    373: Changes in version 1.10.4, released on July 12, 2010
                    374:
                    375:  * Lots of features developed during both "Summer of Code" and the
                    376:    OpenBSD c2k10 hackathon:
                    377:  * minimal "ds" roff(7) symbols are supported
                    378:  * beautified SYNOPSIS section output
                    379:  * acceptance of scope-block breakage in mdoc(7)
                    380:  * clarify error message status
                    381:  * many minor bug-fixes and formatting issues resolved
1.3       schwarze  382:  * see also changes in 1.10.3
                    383:
                    384: Changes in version 1.10.3, June 29, 2010, NOT released
                    385:
                    386:  * variable font-width and paper-size support in mandoc(1) -Tps output
                    387:  * "Bk" mdoc(7) support
1.1       schwarze  388:
                    389: Changes in version 1.10.2, released on June 19, 2010
                    390:
                    391:  * Small release featuring text-decoration in -Tps output,
                    392:    a few minor relaxations of errors, and some optimisations.
                    393:
                    394: Changes in version 1.10.1, released on June 7, 2010
                    395:
                    396:  * This primarily focusses on the "Bl" and "It" macros described in
                    397:    mdoc(7).  Multi-line column support is now fully compatible with groff,
                    398:    as are implicit list entries for columns.
                    399:  * Removed manuals(7) in favour of http://manpages.bsd.lv.
                    400:  * The way we handle the SYNOPSIS section (see the SYNOPSIS documentation
                    401:    in MANUAL STRUCTURE) has also been considerably simplified compared
                    402:    to groff's method.
                    403:  * Furthermore, the -Owidth=width output option has been added to -Tascii,
                    404:    see mandoc(1).
                    405:  * Lastly, initial PostScript output has been added with the -Tps option
                    406:    to mandoc(1).  It's brutally simple at the moment: fixed-font, with no
                    407:    font decorations.
                    408:
                    409: Changes in version 1.10.0, released on May 29, 2010
                    410:
                    411:  * Release consisting of the results from the m2k10 hackathon and up-merge
                    412:    from OpenBSD.  This requires a significant note of thanks to Ingo
                    413:    Schwarze (OpenBSD) and Joerg Sonnenberger (NetBSD) for their hard work,
                    414:    and again to Joerg for hosting m2k10.  Highlights (mostly cribbed from
                    415:    Ingo's m2k10 report) follow in no particular order:
                    416:  * a libroff preprocessor in front of libmdoc and libman stripping out
                    417:    roff(7) instructions;
                    418:  * end-of-sentence (EOS) detection in free-form and macro lines;
                    419:  * correct handling of tab-separated columnar lists in mdoc(7);
                    420:  * improved main calling routines to optionally use mmap(3) for better
                    421:    performance;
                    422:  * cleaned up exiting when invoked as -Tlint or over multiple files
                    423:    with -fign-errors;
                    424:  * error and warning message handling re-written to be unified for
                    425:    libroff, libmdoc, and libman;
                    426:  * handling of badly-nested explicit-scoped macros;
                    427:  * improved free-form text parsing in libman and libmdoc;
                    428:  * significant GNU troff compatibility improvements in -Tascii,
                    429:    largely in terms of spacing;
                    430:  * a regression framework for making sure the many fragilities of GNU
                    431:    troff aren't trampled in subsequent work;
                    432:  * support for -Tascii breaking at hyphens encountered in free-form text;
                    433:  * and many more minor fixes and improvements
                    434:
                    435: Changes in version 1.9.25, released on May 13, 2010
                    436:
                    437:  * Fixed handling of "\*(Ba" escape.
                    438:  * Backed out -fno-ign-chars (pointless complexity).
                    439:  * Fixed erroneous breaking of literal lines.
                    440:  * Fixed SYNOPSIS breaking lines before non-initial macros.
                    441:  * Changed default section ordering.
                    442:  * Most importantly, the framework for end-of-sentence double-spacing is
                    443:    in place, now implemented for the "end-of-sentence, end-of-line" rule.
                    444:  * This is a stable roll-back point before the mandoc hackathon in Rostock!
                    445:
                    446: Changes in version 1.9.24, released on May 9, 2010
                    447:
                    448:  * Rolled back break-at-hyphen.
                    449:  * -DUGLY is now the default (no feature splits!).
                    450:  * Free-form text is not de-chunked any more: lines are passed
                    451:    whole-sale into the front-end, including whitespace.
                    452:  * Added mailing lists.
                    453:
                    454: Changes in version 1.9.23, released on April 7, 2010
                    455:
                    456:  * mdocml has been linked to the OpenBSD build.
                    457:  * This version incorporates many small changes, mostly from patches
                    458:    by OpenBSD, allowing crufty manuals to slip by with warnings instead
                    459:    of erroring-out.
                    460:  * Some subtle semantic issues, such as punctuation scope, have also
                    461:    been fixed.
                    462:  * Lastly, some issues with -Thtml have been fixed, which prompted an
                    463:    update to the online manual pages style layout.
                    464:
                    465: Changes in version 1.9.22, released on March 31, 2010
                    466:
                    467:  * Adjusted merge of the significant work by Ingo Schwarze
                    468:    in getting "Xo" blocks (block full implicit, e.g., "It"
                    469:    for non-columnar lists) to work properly.  This isn't
                    470:    enabled by default: you must specify -DUGLY as a compiler
                    471:    flag (see the Makefile for details).
                    472:
                    473: Changes in version 1.9.20, released on March 30, 2010
                    474:
                    475:  * More efforts to get roff instructions in man(7) documents under
                    476:    control.  Note that roff instructions embedded in line-scoped,
                    477:    next-line macros (e.g. "B") are not supported.
                    478:  * Leading punctuation for mdoc(7) macros, such as "Fl ( ( a",
                    479:    are now correctly handled.
                    480:
                    481: Changes in version 1.9.18, released on March 27, 2010
                    482:
                    483:  * Many fixes (largely pertaining to scope)
                    484:    and improvements (e.g., handling of apostrophe-control macros,
                    485:    which fixes the strange "BR" seen in some macro output)
                    486:    to handling roff instructions in man(7) documents.
                    487:
                    488: Changes in version 1.9.17, released on March 25, 2010
                    489:
                    490:  * Accept perlpod(1) standard preamble.
                    491:  * Also accept (and discard) "de", "dei", "am", "ami", and "ig"
                    492:    roff macro blocks.
                    493:
                    494: Changes in version 1.9.16, released on March 22, 2010
                    495:
                    496:  * Inspired by patches and bug reports by Ingo Schwarze,
                    497:    allowed man(7) to accept non-printing elements to be nested
                    498:    within next-line scopes, such as "br" within "B" or "TH",
                    499:    which is valid roff.
                    500:  * Longsoon architecture also noted and Makefile cleaned up.
                    501:
                    502: Changes in version 1.9.15, released on February 18, 2010
                    503:
                    504:  * Moved to our new BSD.lv home.
                    505:  * XHTML is now an acceptable output mode for mandoc(1);
                    506:  * "Xr" made more compatible with groff;
                    507:  * "Vt" fixed when invoked in SYNOPSIS;
                    508:  * "\\" escape removed;
                    509:  * end-of-line white-space detected for all lines;
                    510:  * subtle bug fixed in list display for some modes;
                    511:  * compatibility layer checked in for compilation in diverse
                    512:    UNIX systems;
                    513:  * and column lengths handled correctly.
                    514:
                    515: For older releases, see the ChangeLog files
                    516: in http://mdocml.bsd.lv/snapshots/ .

CVSweb