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

Annotation of mandoc/NEWS, Revision 1.32

1.32    ! schwarze    1: $Id: NEWS,v 1.31 2018/08/01 15:40:17 schwarze Exp $
1.1       schwarze    2:
1.22      schwarze    3: This file lists the most important changes in the mandoc.bsd.lv distribution.
1.28      schwarze    4:
1.32    ! schwarze    5: Changes in version 1.14.4, released on August 8, 2018
1.28      schwarze    6:
                      7:     --- MAJOR NEW FEATURES ---
                      8:  * In ASCII output, render mathematical symbols and greek letters
                      9:    as transliterations conveying the characters' meanings rather
                     10:    than trying to imitate their shape.  Consequently, such characters
                     11:    can now be used in portable manual pages.  All the same, please
                     12:    limit their use to contexts where they really matter, for example
                     13:    when showing complicated mathematical formulae.
                     14:  * First steps towards better support for small screens in HTML
                     15:    output (responsive design): avoid most style= attributes, in
                     16:    particular all hard-coded indentations and column widths, and
                     17:    provide a better mandoc.css style sheet with a @media query,
                     18:    using em units throughout, and avoiding redundancy in selectors.
                     19:  * Better HTML output with some more fitting HTML elements, eliminating
                     20:    needless class= attributes, and avoiding various HTML syntax errors
                     21:    (element nesting, URL-fragment syntax, duplicate id= attributes).
                     22:     --- MINOR NEW FEATURES ---
                     23:  * When a man(1) argument contains a slash, imply -l like in man-db.
                     24:  * Use TIOCGWINSZ to reduce the default -Owidth and -Oindent during
                     25:    interactive use on terminals narrower than 79 columns.
                     26:  * Generated PostScript files are now more than 50% smaller.
                     27:  * Terminal rendering of eqn(7) is improved in several respects.
                     28:  * Simplified and nicer output from the mdoc(7) .Lk macro, formatting
                     29:    all links in-line, even long ones.
                     30:  * roff(7) \n+ and \n- numerical register auto-increment and -decrement
                     31:  * roff(7) .nr optional third argument (auto-increment step size)
1.29      schwarze   32:  * Autodetect in ./configure whether the compiler can use -W and -static,
                     33:    allowing to build on Solaris 10 and 11 without any configure.local.
1.28      schwarze   34:     --- RELIABILITY BUGFIXES ---
                     35:  * Only activate UTF-8 output when the user really selected UTF-8,
                     36:    not some other multibyte character encoding.
                     37:  * Prevent excessive .ll arguments from generating infinite output.
1.31      schwarze   38:  * Fix out of bounds accesses to parse buffers that could happen when
                     39:    using renamed or user defined macros after roff(7) conditionals.
1.28      schwarze   40:  * Avoid an assertion failure in certain .Bl -column lists.
                     41:  * Avoid a NULL pointer access on deroff() failure after '.SS ""'.
                     42:  * Fix a segfault that could be triggered by two invalid .Dt macros.
                     43:  * Fix two syntax errors in generated PDF files.
                     44:  * Properly state the page size in generated PostScript files.
                     45:  * Close a memory leak caused by missing gzclose(3).
                     46:  * Fix misformatting of man(7) documents lacking .SH macros
                     47:    in PostScript and PDF output.
                     48:  * And many minor bugfixes.
                     49:     --- THANKS TO ---
                     50:  * Marc Espie (OpenBSD) for implementing the size reduction of
                     51:    PostScript files, one additional patch for code simplification,
                     52:    and two bug reports.
                     53:  * Theo Buehler (OpenBSD) for a bugfix patch,
                     54:    and Theo de Raadt (OpenBSD) for checking it.
                     55:  * John Gardner for more than a dozen suggestions regarding HTML output.
                     56:  * Mike Williams for teaching me how to use %%DocumentMedia and
                     57:    setpagedevice in PostScript files.
                     58:  * Werner Lemberg (groff) for feedback on mdoc(7) language changes.
                     59:  * Colin Watson (man-db) for feedback on man-db semantics.
                     60:  * Jason McIntyre (OpenBSD) for lots of feedback and suggestions
                     61:    on diagnostic messages and on the documentation.
1.32    ! schwarze   62:  * Thomas Klausner (NetBSD) for suggesting two new style messages
        !            63:    and one new feature, for two bug reports, and for release testing.
1.30      schwarze   64:  * Leah Neukirchen (Void Linux) for suggesting a new style message,
1.31      schwarze   65:    five bug reports, and release testing.
1.28      schwarze   66:  * Anthony Bentley (OpenBSD) for reporting multiple bugs and missing
                     67:    features.
                     68:  * Paul Irofti (OpenBSD) and Nate Bargmann for suggesting new features.
1.32    ! schwarze   69:  * Michael Stapelberg (Debian) for bug reports and release testing.
        !            70:  * Christian Weisgerber, Jonathan Gray, Stuart Henderson,
        !            71:    Ted Unangst (OpenBSD), Takeshi Nakayama (NetBSD),
1.28      schwarze   72:    Anton Lazarov, Jakub Klinkovsky, Jan Stary, Jesper Wallin,
                     73:    Will Backmam, and Wolfgang Mueller for bug reports.
                     74:  * Sevan Janiyan (NetBSD) for additions to lib.in.
                     75:  * George Brown for suggesting code simplifications.
                     76:  * David Coppa, Igor Sobrado (OpenBSD), and Alexander Kuleshov
                     77:    for documentation improvements.
                     78:  * Laura Morales and Raf Czlonka for questions resulting in better
                     79:    documentation.
1.32    ! schwarze   80:  * Yuri Pankov (illumos) for release testing.
1.27      schwarze   81:
                     82: Changes in version 1.14.3, released on August 5, 2017
                     84:     --- BUG FIXES ---
                     85:  * man(7): Do not crash with out-of-bounds read access to a constant
                     86:    array if .sp or a blank line immediately precedes .SS or .SH.
                     87:  * mdoc(7): Do not crash with out-of-bounds read access to a constant
                     88:    array if .sp or a blank line precede the first .Sh macro.
                     89:  * tbl(7): Ignore explicitly specified negative column widths rather than
                     90:    wrapping around to huge numbers and risking memory exhaustion.
                     91:  * man(1): No longer use names that only occur in the SYNOPSIS section.
                     92:    Gets rid of some surprising behaviour and bogus warnings.
                     93:     --- THANKS TO ---
                     94:    Leah Neukirchen (Void Linux), Markus Waldeck (Debian),
                     95:    Peter Bui (nd.edu), and Yuri Pankov (illumos) for bug reports.
1.23      schwarze   96:
1.26      schwarze   97: Changes in version 1.14.2, released on July 28, 2017
1.23      schwarze   98:
                     99:     --- MAJOR NEW FEATURES ---
                    100:  * New mdoc(7) -Tmarkdown output mode.
                    101:  * For -Thtml, implement internal hyperlinks pointing to authoritative
                    102:    definitions of various syntax elements, similar to the ctags(1)-like
                    103:    less(1) :t internal searching in terminal mode.
                    104:  * Provide a superset of the functionality of the former mdoclint(1)
                    105:    utility and a new -Wstyle message level with several new messages,
                    106:    including validity checking of .Xr cross references.
                    107:  * tbl(7): Implement automatic line breaking inside individual table
                    108:    cells, and several other formatting improvements.
                    109:  * eqn(7): Complete rewrite of the lexer, resulting in several bugfixes.
                    110:  * Continue parser unification, in particular allowing generation
                    111:    of syntax tree nodes on the roff(7) level, allowing implementation
                    112:    of many additional roff requests.
                    113:     --- REMOVED FUNCTIONALITY ---
                    114:  * Delete the manpage(1) utility.  It was never enabled in any release.
                    115:  * Delete the -Txhtml command line option.  It has been an obsolete
                    116:    alias for the -Thtml output mode for more than two years.
                    117:     --- MINOR NEW FEATURES ---
1.25      schwarze  118:  * -Tlint now puts parser messages on stdout instead of stderr,
                    119:    making commands like "man -l -Tlint *.1" useful.
1.23      schwarze  120:  * mdoc(7): Various .Lk formatting improvements.
1.24      schwarze  121:  * mdoc(7) -Thtml: Better CSS for .Bl lists.
1.23      schwarze  122:  * man(7): Implement the .MT/.ME block macro (mailto hyperlink).
                    123:  * man(7): Implement the .DT macro (restore default tab positions).
                    124:  * man(7): Improved support for manuals generated with reStructuredText
                    125:    by partial support for the \n[an-margin] number register.
                    126:  * man(7) -Thtml: Support deep linking to .SH and .SS headers.
                    127:  * tbl(7): Implement the "allbox" table option.
                    128:  * tbl(7): Implement the column spacing and the 'w' (minimum column
                    129:    width) layout modifiers.
                    130:  * tbl(7): Significant improvements of the manual page.
                    131:  * eqn(7): Much improved font selection, including recognition of
                    132:    well-known function names, and a few other formatting improvements.
                    133:  * eqn(7) -Thtml: Use <mn> and <mo> in addition to <mi>.
                    134:  * roff(7): Implement the .ce (centering), .mc (margin character),
                    135:    .rj (right justify), .ta (define tab stops), .ti (temporary indent),
                    136:    .als (macro alias), .ec and .eo (escape character control),
                    137:    .po (page offset), and .rn (macro rename) requests.
                    138:  * roff(7) .am: Implement appending to mdoc(7) and man(7) macros.
                    139:  * roff(7): implement the \h (horizontol motion), \l (horizontal
                    140:    line drawing), and \p (break output line) escape sequences,
                    141:    and also several additional character escape sequences.
                    142:  * roff(7): Implement the 'd' conditional (macro or string defined).
                    143:  * man.cgi(8) now uses pledge(2), too.
1.24      schwarze  144:  * regress.pl(1): simpler user interface, better summary output,
                    145:    simpler code, and no more recursion.
1.23      schwarze  146:     --- THANKS TO ---
                    147:  * Anthony Bentley (OpenBSD) for the implementation of .MT/.ME,
                    148:    reports of many bugs and missing features, and suggestions
                    149:    for a number of feature and documentation improvements.
                    150:  * Sebastien Marie (OpenBSD) for two source code patches and
                    151:    for some useful discussions.
1.26      schwarze  152:  * Florian Obser (OpenBSD) for a bugfix patch and a bug report.
1.23      schwarze  153:  * Jonathan Gray (OpenBSD) for several bug reports from afl(1)
                    154:    and several more from static analysis tools.
                    155:  * Theo Buehler (OpenBSD) for several bug reports, most from afl(1).
                    156:  * Jason McIntyre (OpenBSD) for many useful discussions about a
                    157:    wide variety of topics, lots of continuous testing, a number of
                    158:    bug reports, and some suggestions for messages and documentation.
                    159:  * Thomas Klausner (NetBSD) for lots of help while migrating
1.26      schwarze  160:    mdoclint(1) functionality to mandoc -Tlint, for suggesting
                    161:    several useful new messages, and for release testing.
1.23      schwarze  162:  * Reyk Floeter (OpenBSD) and Vsevolod Stakhov (FreeBSD) for
                    163:    suggesting a markdown output mode.
                    164:  * Thomas Guettler for suggesting -Thtml internal hyperlinks.
1.26      schwarze  165:  * Yuri Pankov (Illumos) for inspiring new warning messages and
                    166:    for extensive release testing.
1.24      schwarze  167:  * Anton Lindqvist and TJ Townsend (both OpenBSD) and Jan Stary
                    168:    for multiple bug reports.
1.26      schwarze  169:  * Leah Neukirchen (Void Linux) for bug reports and release testing.
                    170:  * Michael Stapelberg (Debian) for suggesting feature improvements
                    171:    and for release testing.
                    172:  * Martin Natano and Theo de Raadt (both OpenBSD), Andreas Voegele,
                    173:    Gabriel Guzman, Gonzalo Tornaria, Markus Waldeck, and Raf Czlonka
                    174:    for bug reports.
                    175:  * Antoine Jacoutot (OpenBSD) and Steffen Nurpmeso for suggesting
                    176:    feature improvements.
                    177:  * Dag-Erling Smoergrav (FreeBSD) for inspiring new warning messages.
1.24      schwarze  178:  * Ted Unangst and Marc Espie (OpenBSD) for providing useful ideas.
1.26      schwarze  179:  * Svyatoslav Mishyn (Crux Linux) for release testing.
1.23      schwarze  180:  * Carsten Kunze (Heirloom roff) for help keeping mandoc and groff
                    181:    compatible and for committing some of my patches to groff.
1.13      schwarze  182:
1.21      schwarze  183: Changes in version 1.14.1, released on February 21, 2017
1.13      schwarze  184:
                    185:     --- MAJOR NEW FEATURES ---
                    186:  * apropos(1): Reimplement complete semantic search functionality
                    187:    without the dependency on SQLite3, using only POSIX APIs.
                    188:    This comes with a completely new mandoc.db(5) file format.
                    189:  * man(1): Support more than one tag entry for the same search term,
                    190:    plus some minor improvements to the less(1) :t support.
                    191:  * -Thtml: Use real macro names for CSS classes.
                    192:    Systematic cleanup of and many improvements to mandoc.css.
                    193:  * -Thtml: Produce human readable HTML code by using indentation
                    194:    and better line breaks.  Improve various HTML elements,
                    195:    and trim several useless ones.
                    196:  * New catman(8) utility, still somewhat experimental.
1.14      schwarze  197:  * Now includes a portable version of the OpenBSD mandoc regression
                    198:    suite, see regress/regress.pl.1 for details.
1.13      schwarze  199:     --- REMOVED FUNCTIONALITY ---
                    200:  * Operating systems that don't provide mmap(3) are no longer supported.
                    201:  * Drop support for manpath(1).  Even if your system has manpath(1),
                    202:    it is simpler to use MANPATH_DEFAULT in configure.local for
                    203:    operating system defaults, man.conf(5) for machine-specific
                    204:    modifications, and ${MANPATH}, -m, and -M for user preferences
                    205:    than to bother with the complexity of manpath(1).
                    206:  * makewhatis(8) -p: No longer warn about missing MLINKS since these
                    207:    are no longer needed for anything.
                    208:     --- MINOR NEW FEATURES ---
                    209:  * mdoc(7): Warn about invalid punctuation and content below NAME.
                    210:  * mdoc(7): Warn about .Xr lacking the second argument (section).
                    211:  * mdoc(7): Warn about violations of the rule "new sentence, new line".
                    212:  * roff(7): Warn about trailing whitespace at the end of comments.
1.21      schwarze  213:  * mdoc(7): Improve rendering of double quotes.
1.13      schwarze  214:  * mdoc(7): Always do text production in the validator, never in the
                    215:    formatters.  Cleaner, simpler, shorter, helps NetBSD apropos(1)
                    216:    and also makes -Ttree output more useful.
1.15      schwarze  217:  * -Ttree: Show metadata and some additional node flags.
                    218:    New -Onoval output option to show the unvalidated tree.
1.13      schwarze  219:     --- RELIABILITY BUGFIXES ---
                    220:  * man(1): Make "man -l" work with standard input from a pipe or file,
                    221:    as long as standard output is a terminal.
1.21      schwarze  222:  * man(7): Fix out of bounds read access if a text node immediately
                    223:    preceded the first .SH header.
1.13      schwarze  224:  * mdoc(7): Fix out of bounds read access for .Bl without a type
                    225:    but with a width.
                    226:  * mdoc(7): Fix out of bounds read access for .Bl -column starting
                    227:    with a tab character instead of a child .It macro.
                    228:  * mdoc(7): Fix syntax tree corruption leading to segfaults caused
                    229:    by stray block end macros in nested blocks of mismatching type.
                    230:  * man(1): Fix NULL dereference when the first of multiple pages
                    231:    shown was preformatted.
1.18      schwarze  232:  * mdoc(7): Fix syntax tree corruption leading to NULL dereference
                    233:    caused by partial implicit macros inside .Bl -column table cells.
1.13      schwarze  234:  * mdoc(7): Fix syntax tree corruption leading to NULL dereference
                    235:    for macro sequences like .Bl .Bl .It Bo .El .It.
1.15      schwarze  236:  * mdoc(7): Fix syntax tree corruption leading to NULL dereference
1.13      schwarze  237:    caused by .Ta following a nested .Bl -column breaking another block.
1.16      schwarze  238:  * mdoc(7): Fix syntax tree corruption sometimes leading to NULL
1.17      schwarze  239:    dereference caused by indirectly broken .Nd or .Nm blocks.
1.13      schwarze  240:  * mdoc(7) -Thtml: Fix a NULL dereference for .Bl -column with 0 columns.
1.17      schwarze  241:  * mdoc(7): Fix NULL dereference in some specific cases of a
                    242:    block-end macro calling another block-end macro.
1.13      schwarze  243:  * mdoc(7): Fix NULL dereference if the only child of the head
                    244:    of the first .Sh was an empty in-line macro.
1.19      schwarze  245:  * eqn(7): Fix NULL dereference in the terminal formatter
                    246:    for empty matrices and empty square roots.
1.13      schwarze  247:  * mdoc(7): Fix an assertion failure for a .Bd without a type that
                    248:    breaks another block.
1.20      schwarze  249:  * mdoc(7): Fix an assertion failure that happened for some .Bl -column
                    250:    lists containing a column width of "-4n", "-3n", or "-2n".
1.13      schwarze  251:  * mdoc(7): Fix an assertion failure caused by .Bl -column without .It
                    252:    but containing eqn(7) or tbl(7) code.
                    253:  * roff(7): Fix an assertion failure caused by \z\[u00FF] with -Tps/-Tpdf.
                    254:  * roff(7): Fix an assertion failures caused by whitespace inside \o''
                    255:    (overstrike) sequences.
                    256:  * -Thtml: Fix an assertion failure caused by -Oman or -Oincludes of
                    257:    excessive length.
                    258:     --- PORTABILITY IMPROVEMENTS ---
                    259:  * man(1): Do not mix stdio narrow and wide stream orientation
                    260:    on stdout, which could cause output corruption on glibc.
                    261:  * mandoc(1): Autodetect a suitable locale for -Tutf8 mode.
1.21      schwarze  262:  * ./configure: Autodetect whether PATH_MAX and O_DIRECTORY are defined.
                    263:  * ./configure: Autodetect if nanosleep(3) needs -lrt.
                    264:  * ./configure: Provide an ${LN} configuration variable.
                    265:  * ./configure: Put compiler arguments that may contain -l at the end.
1.13      schwarze  266:     --- MINOR BUGFIXES ---
                    267:  * mdoc(7): Fix SYNOPSIS output if the first child of .Nm is a macro.
                    268:  * mdoc(7) -Thtml: Improve formatting of .Bl -tag with short tags.
                    269:  * man(7) -Thtml: Preserve whitespace in .nf (nofill) mode.
                    270:  * mandoc(1): Error out on invalid output options on the command line.
                    271:     --- STRUCTURAL CHANGES, no functional change ---
                    272:  * Redesign part of the mandoc_html(3) interfaces, making them much
                    273:    easier to use and reducing the amount of code by a few hundred lines.
                    274:     --- THANKS TO ---
                    275:  * Michael Stapelberg (Debian) for designing the new mandocd(8)
1.21      schwarze  276:    and parts of the new catman(8), for release testing, and for a
                    277:    number of patches and bug reports.
1.13      schwarze  278:  * Baptiste Daroussin (FreeBSD) for profiling the new makewhatis(8)
                    279:    implementation and suggesting an algorithmic improvement which
                    280:    more than doubled performance, and for a few bug reports.
                    281:  * Ed Maste (FreeBSD) for an important patch improving reproducibility
                    282:    of builds in makewhatis(8), and for a few bug reports.
1.21      schwarze  283:  * Theo Buehler (OpenBSD) for almost twenty important bug reports,
1.13      schwarze  284:    most of them found by systematic afl(1) fuzzing.
                    285:  * Benny Lofgren, David Dahlberg, and in particular Vadim Zhukov
                    286:    for crucial help in getting .Bl -tag CSS formatting fixed.
                    287:  * Svyatoslav Mishyn (Crux Linux) for an initial version of the
1.21      schwarze  288:    patch to autodetect a suitable locale for -Tutf8 mode
                    289:    and for release testing.
1.13      schwarze  290:  * Jason McIntyre (OpenBSD) for multiple useful discussions
                    291:    and a number of bug reports.
1.21      schwarze  292:  * Sevan Janiyan (NetBSD) for extensive release testing and multiple
                    293:    bug reports.
                    294:  * Thomas Klausner and Christos Zoulas (NetBSD), Yuri Pankov (illumos),
                    295:    and Leah Neukirchen (Void Linux) for release testing and bug reports.
                    296:  * Ulrich Spoerlein (FreeBSD) for release testing.
1.13      schwarze  297:  * Alexander Bluhm, Andrew Fresh, Antoine Jacoutot, Antony Bentley,
                    298:    Christian Weisgerber, Jonathan Gray, Marc Espie, Martijn van Duren,
                    299:    Stuart Henderson, Ted Unangst, Theo de Raadt (OpenBSD), Abhinav
1.21      schwarze  300:    Upadhyay, Kamil Rytarowski (NetBSD), Aaron M. Ucko, Bdale Garbee,
                    301:    Reiner Herrmann, Shane Kerr (Debian), Daniel Sabogal (Alpine Linux),
1.13      schwarze  302:    Carsten Kunze (Heirloom roff), Kristaps Dzonsons (bsd.lv),
                    303:    Anton Lindqvist, Jan Stary, Jeremy A. Mates, Mark Patruck,
                    304:    Pavan Maddamsetti, Sean Levy <attila@stalphonsos.com>, and
                    305:    Tiago Silva for bug reports.
                    306:  * Brent Cook, Marc Espie, Philip Guenther, Todd Miller (OpenBSD)
                    307:    and Markus Waldeck for useful discussions.
                    308:  * And as usual, OpenCSW for providing me with a Solaris 9/10/11
                    309:    testing environment.
1.11      schwarze  310:
1.12      schwarze  311: Changes in version 1.13.4, released on July 14, 2016
1.11      schwarze  312:
                    313:     --- MAJOR NEW FEATURES ---
                    314:  * man.conf(5): Design and implement a simpler configuration file format.
                    315:  * man(1): Leverage less(1) -T and :t in a way resembling ctags(1)
                    316:    to jump to the definitions of various terms inside manual pages.
                    317:  * soelim(1): New implementation by Baptiste Daroussin.
1.12      schwarze  318:  * privilege limitation: Use OpenBSD pledge(2) or OS X sandbox_init(3)
                    319:    when available.
                    320:  * man.cgi(8): Support short URIs like http://man.openbsd.org/mdoc .
1.11      schwarze  321:  * mandoc.css: Use one unified stylesheet rather than three different ones.
                    322:     --- MAJOR FUNCTIONALLY RELEVANT BUGFIXES ---
                    323:  * mdoc(7): Fix multiple aspects of SYNOPSIS .Nm formatting.
                    324:  * man(1): Fix process group handling, avoiding unclean shutdowns.
                    325:     --- PORTABILITY IMPROVEMENTS ---
                    326:  * Correctly use the ohash(3) compatibility implementation
                    327:    even when building without SQLite support.
                    328:  * Add compat glue for building on Solaris 9 and 10.
                    329:  * Let ./configure select a supported RE syntax for word boundaries.
1.12      schwarze  330:  * Support LDFLAGS, to be used for example for hardening options.
                    331:  * Avoid mixing putchar(3) and putwchar(3) on the same file descriptor,
                    332:    it resulted in output corruption on some platforms.
1.11      schwarze  333:  * Avoid reusing va_lists, use va_copy(3) for better portability.
                    334:  * Do not hardcode the path to the more(1) program.
                    335:     --- MINOR NEW FEATURES ---
                    336:  * roff(7): Implement \n(.$ (number of macro arguments).
                    337:  * roff(7): Fully implement \z (do not advance cursor).
                    338:  * roff(7): Implement the `r'  conditional (register exists).
                    339:  * roff(7): Implement \\$* (interpolate all arguments).
                    340:  * roff(7): Parse and ignore \, and \/ (italic corrections).
                    341:  * When there is no -m, no -M, no MANPATH and no /etc/man.conf,
                    342:    fall back to /usr/share/man:/usr/X11R6/man:/usr/local/man.
                    343:  * man(1): Give manuals in purely numerical sections priority over
                    344:    manuals of the same name in sections with an alphabetical suffix.
                    345:  * man.cgi(8): Support "header.html" and "footer.html".
                    346:  * man.cgi(8): Set the "autofocus" attribute on the query text box.
                    347:  * man.cgi(8): Simplify the search form, drop two useless buttons.
1.12      schwarze  348:  * man.cgi(8): Delete the pseudo-manpath "mandoc", assume that
                    349:    apropos(1) and man.cgi(8) are installed in the default manpath.
1.11      schwarze  350:     --- RELIABILITY BUGFIXES ---
                    351:  * mdoc(7): Avoid a use after free and an assertion failure when nodes
                    352:    are deleted during validation.
                    353:  * mdoc(7): Avoid a NULL pointer access when .Bd has no arguments.
                    354:  * mdoc(7): Avoid a NULL pointer access triggered by mismatching end macros.
                    355:  * mdoc(7): Avoid an assertion when .Fo has no argument.
                    356:  * mdoc(7): Avoid an assertion when .Ta<tab> occurs in .Bl -column.
                    357:  * mdoc(7): Avoid an assertion when a body gets broken and has a tail.
                    358:  * roff(7): Avoid an assertion caused by blanks inside \o.
1.12      schwarze  359:  * roff(7): Make .so links to gziped manuals work without mandoc.db(5).
1.11      schwarze  360:  * tbl(7): Avoid a use after free when the last line of a layout is empty.
                    361:  * eqn(7): Avoid an infinite loop caused by recursive "define".
                    362:  * makewhatis(8): Avoid a segfault caused by unusual directory structures.
                    363:  * Fix handling of leading, trailing, and double colons in MANPATH and -m.
                    364:     --- MINOR BUGFIXES ---
                    365:  * mdoc(7): Put arguments to end macros of broken partial explicit blocks
                    366:    inside the breaking block.
                    367:  * mdoc(7): Let .Dv force normal font.
                    368:  * mdoc(7): Make trailing whitespace significant in .Bl -tag widths.
                    369:  * mdoc(7): Fix macro interpretation around tabs in .Bl -column.
                    370:  * man(7): Use the default width for .RS without arguments.
                    371:  * man(7): On a new RS nesting level, the saved width starts from
                    372:    the default width, not from the saved width of the previous level.
                    373:  * man(7): Allow .PD in next-line scope.
                    374:  * man(7): Improve handling of empty .HP.
                    375:  * man(7): Improve formatting of .br and .sp inside .HP.
                    376:  * man(7): Do not mistreat empty arguments to font alternating
                    377:    macros as vertical spacing requests.
                    378:  * man(7): Allow fill mode changes in tagged paragraph next-line scope.
                    379:  * man(7): Fix minor bugs in block rewinding and simplify the related code.
                    380:  * man(7): Add missing line breaks before subsection headers.
                    381:  * man(7): Give section and subsection headers hanging indentation.
                    382:  * man(7): Make trailing whitespace significant in .TP widths.
                    383:  * roff(7): Don't allow breaking the output line after hyphens
                    384:    that immediately follow escape sequences.
                    385:  * roff(7): Ignore blank characters at the beginning of conditional blocks.
                    386:  * roff(7): Escape breakable hyphens only after handling input line traps.
                    387:  * roff(7): Reject \[uD800] to \[uDFFF] (surrogates) in the parser.
                    388:  * tbl(7): Allow more than one data field after T} on the same input line.
                    389:  * terminal output: Apply bold and italic to non-ASCII Unicode codepoints.
                    390:  * terminal output: Improve rounding rules for horizontal scaling widths.
                    391:  * HTML output: Render ASCII_NBRSP as "&nbsp;", not "-".
                    392:  * man(1): Do not match the first part of a name if it continues with a dot.
                    393:  * man(1): Keep working even if the current directory is unusable.
                    394:  * man(1): Better error message when $PAGER is invalid.
                    395:  * makewhatis(8): Improve handling of .Va and .Vt macros.
                    396:  * apropos(1): Print "nothing appropriate" to stderr when appropriate.
                    397:  * apropos(1): Abort with a useful error message when elementary
                    398:    database operations like preparing queries or binding variables fail.
                    399:     --- STRUCTURAL CHANGES, no functional change ---
                    400:  * mdoc(7) and man(7): Unified data structures struct roff_node etc.
                    401:  * mdoc(7) and man(7): Unified node handling library in roff.c.
                    402:  * mdoc(7) and man(7): Seperate validation phase from parsing.
1.12      schwarze  403:  * roff(7): Major character table cleanup.
1.11      schwarze  404:  * Link with libz rather than forking gunzip(1).
                    405:     --- THANKS TO ---
1.12      schwarze  406:  * Baptiste Daroussin (FreeBSD) for the new soelim(1)
                    407:    and for release testing.
1.11      schwarze  408:  * Anthony Bentley (OpenBSD) for unifying mandoc.css, two nice
                    409:    patches for man.cgi(8), some documentation patches, some bug
                    410:    reports, and various useful discussions.
                    411:  * Todd Miller (OpenBSD) for lots of help with process group and
                    412:    signal handling, a few patches, some bug reports and some useful
                    413:    discussions.
                    414:  * Jonathan Gray (OpenBSD) for yet more testing with afl(1)
                    415:    again resulting in more than half a dozen important bug reports.
1.12      schwarze  416:  * Svyatoslav Mishyn (Crux Linux) for some patches, several bug
                    417:    reports, and extensive release testing.
1.15      schwarze  418:  * Leah Neukirchen (Void Linux) for a number of compatibility
1.12      schwarze  419:    patches and suggestions and several bug reports.
1.11      schwarze  420:  * Christos Zoulas (NetBSD) for a bug fix patch and some useful
                    421:    suggestions for cleanup.
                    422:  * Florian Obser (OpenBSD) for a bugfix patch and some bug reports.
1.12      schwarze  423:  * Sevan Janiyan for help with Solaris compatibility and release
                    424:    testing on many platforms.
                    425:  * Jan Holzhueter and OpenCSW in general for help with Solaris
                    426:    compatibility, and for providing me with a Solaris 9/10/11 testing
                    427:    environment.
1.11      schwarze  428:  * Michael McConville (OpenBSD) for some simple cleanup patches.
1.12      schwarze  429:  * Thomas Klausner (NetBSD) for some bug reports and release testing.
1.11      schwarze  430:  * Christian Weisgerber, Dmitrij Czarkoff, Igor Sobrado,
1.12      schwarze  431:    Ken Westerback, Marc Espie, Mike Belopuhov, Rafael Neves,
                    432:    Ted Unangst, Tim van der Molen, Theo Buehler, Theo de Raadt
                    433:    (OpenBSD), Kurt Jaeger, Dag Erling Smoergrav (FreeBSD),
                    434:    Joerg Sonnenberger (NetBSD), Carsten Kunze (Heirloom troff),
                    435:    Daniel Levai, Fabian Raetz, Jan Stary, Jean-Yves Migeon,
1.11      schwarze  436:    Lorenzo Beretta, Markus Waldeck, Maxim Belooussov, Michael Reed,
                    437:    Peter Bray, and Serguey Parkhomovsky for bug reports and feature
                    438:    suggestions.
                    439:  * Alexander Hall, Andrew Fresh, Antoine Jacoutot, Doug Hogan,
                    440:    Jason McIntyre, Jasper Lievisse Adriaanse, Kent Spillner,
                    441:    Nicholas Marriott, Peter Hessler, Sebastien Marie, Stefan Sperling,
                    442:    and Theo de Raadt (OpenBSD) for helpful discussions and feedback.
1.9       schwarze  443:
                    444: Changes in version 1.13.3, released on March 13, 2015
                    446:     --- MAJOR NEW FEATURES ---
                    447:  * When a manual is missing from an outdated database, let man(1)
                    448:    show it anyway, using a KISS file system lookup as a fallback.
                    449:  * Use this to always provide man(1), even without database support.
                    450:  * Fatal errors no longer exist.  If a file can be opened, mandoc
                    451:    will produce some output; at worst, the output may be almost empty.
                    452:  * New -Wunsupp message level.
                    453:     --- POTENTIONALLY SECURITY RELEVANT BUGFIXES ---
                    454:  * Fix a potential write buffer overrun on incomplete string conditionals.
1.22      schwarze  455:    http://mandoc.bsd.lv/cgi-bin/cvsweb/roff.c#rev1.241
1.9       schwarze  456:  * Fix a potential write buffer overrun on backslash at EOF in a conditional.
1.22      schwarze  457:    http://mandoc.bsd.lv/cgi-bin/cvsweb/roff.c#rev1.247
1.9       schwarze  458:  * Fix a use after free sometimes hit when validation deletes a block.
1.22      schwarze  459:    http://mandoc.bsd.lv/cgi-bin/cvsweb/mdoc_macro.c#rev1.180
1.9       schwarze  460:     --- MAJOR FUNCTIONALLY RELEVANT BUGFIXES ---
                    461:  * Let man(1) show manuals for the current architecture by default,
                    462:    and support the MACHINE environment variable.
                    463:  * Fix the man(1) and apropos(1) -m option, it didn't work at all.
                    464:  * Do not spawn a pager when there is no output.
                    465:  * In makewhatis(8), fix detection of hardlinked manuals on platforms
                    466:    having padding in struct inodev (typically 64bit platforms).
                    467:     --- PORTABILITY IMPROVEMENTS ---
                    468:  * Ignore O_CLOEXEC when the operating system doesn't provide it.
                    469:  * Avoid forward reference to enum type which violates ISO C99.
                    470:  * Support homebrew-style linking on Mac OS X.
                    471:     --- MINOR NEW FEATURES ---
                    472:  * lookup: Accept digit+letter and "n" as section names in man(1),
                    473:    and consistently handle digit+letter in file name extensions.
                    474:  * lookup: Speed up -s/-S by using the "mlinks" rather than the "keys" table.
                    475:  * output: Insert horizontal lines between formatted manual pages.
                    476:  * input: New stricter and more resilient UTF-8 parser.
                    477:  * mdoc(7): Refactor block rewinding for simpler and more robust parsing.
                    478:  * man(7): Use the -Ios option when .TH has less than four arguments.
                    479:  * tbl(7): Implement the "center" option.
                    480:  * tbl(7): New option and format parsers, improved in many respects.
                    481:  * roff(7): Basic implementation of the \o escape sequence (overstrike),
                    482:    and improved rendering of overstrikes in PostScript and PDF output.
                    483:  * Message improvements, in particular for, but not restricted to,
                    484:    eqn(7), tbl(7), and wrong numbers of arguments in mdoc(7) and man(7),
                    485:    in various cases also improving output generated by invalid input.
                    486:  * Delete the -V option.  It serves no purpose but keeps confusing people.
                    487:  * gmdiff: Minimal support for Heirloom roff.
                    488:     --- RELIABILITY BUGFIXES ---
                    489:  * tbl(7): Fix a read buffer overrun on 'f' at EOL in a layout.
                    490:  * roff(7): Fix a read buffer overrun on incomplete numerical conditions.
                    491:  * mdoc(7): Fix a NULL pointer access on .Nd followed by an explicit block.
                    492:  * mdoc(7): Fix a NULL pointer access on .It Xo without .Xc.
                    493:  * mdoc(7): Fix a NULL pointer access on .Eo without a tail.
                    494:  * mdoc(7): Fix a NULL pointer access in the validation of empty .St macros.
                    495:  * man(7)/tbl(7): Fix a NULL pointer access on .TS right after .TP.
                    496:  * tbl(7): Fix a NULL pointer access on layout lines without any cells.
                    497:  * eqn(7): Fix NULL pointer accesses in the terminal formatter.
                    498:  * roff(7): Fix a NULL pointer access on trailing \s-/\s+ without an argument.
                    499:  * gz: Fix a potential NULL pointer access after waitpid() failure.
                    500:  * roff(7): Don't let the modulo operator divide by zero.
                    501:  * input: Fix an assertion failure on certain invalid UTF-8 input.
                    502:  * terminal output: Allow arbitrary depth of the font stack (assertion fix).
                    503:  * mdoc(7): Fix assertion failures and endless loops on invalid block closing.
                    504:  * mdoc(7): Fix an assertion failure on .Bl .Sm not followed by .It.
                    505:  * mdoc(7): Fix an assertion failure on .Bl -column ... .El .Ta.
                    506:  * tbl(7): Fix assertion failures by macros inside table data,
                    507:    but do not throw away the macro arguments.
                    508:  * Prevent certain kinds of unreasonable input from producing excessive
                    509:    output, in one case caused by unsigned integer underflow.
                    510:  * Fix a potential memory leak in makewhatis(8) on very long filenames.
                    511:     --- MINOR BUGFIXES ---
                    512:  * mdoc(7): Fix parsing of badly nested blocks with multiple identical blocks.
                    513:  * mdoc(7): Support negative indentations for displays and lists.
                    514:  * mdoc(7): Don't mistreat negative .sp arguments as large positive ones.
                    515:  * mdoc(7): Some spacing fixes for .Eo/.Ec.
                    516:  * man(7): Support negative horizontal widths.
                    517:  * man(7): Do not print out invalid .IP arguments.
                    518:  * man(7): Correctly handle scaling units after .PD.
                    519:  * man(7): Support .RE with an argument.
                    520:  * man(7): Fix restoring indentation after .RS with large negative arguments.
                    521:  * tbl(7): Prevent tables from breaking the filling of preceding text.
                    522:  * tbl(7): Fix vertical spacing at the beginning of tables.
                    523:  * tbl(7): Parser and formatter fixes for line drawing and font modifiers.
                    524:  * tbl(7): Correct handling of blank data lines.
                    525:  * eqn(7): Add sometimes missing whitespace before equation output.
                    526:  * roff(7): Fix vertical scaling, most of it was wrong.
                    527:  * roff(7): Slightly improve \w width measurements.
                    528:  * roff(7): Accept the historic aliases \s10 to \s39 for \s(10 to \s(39.
                    529:  * roff(7): Correctly escape quotes when expanding macro arguments.
                    530:  * roff(7): Correctly handle scaling units in numerical expressions,
                    531:    and some other improvements to the parsing of numerical expressions.
                    532:  * roff(7): Three minor fixes with respect to evaluation of conditionals.
                    533:  * roff(7): Let .it accept numerical expressions, not just constants.
                    534:  * mandoc_char(7): Correct some character names and renderings.
1.10      schwarze  535:  * If earlier files set a non-zero exit status, never reset it to zero.
1.9       schwarze  536:     --- THANKS TO ---
                    537:  * Jonathan Gray (OpenBSD) for yet more testing with afl (the American
                    538:    Fuzzy Lop security fuzzer), again resulting in many bug reports.
                    539:  * Theo de Raadt (OpenBSD) for suggesting the main new feature (man(1) file
                    540:    system lookup) and for reporting an important bug (pager without output).
                    541:  * Theo Buehler for an important bug report (-s/-S slowness)
                    542:    and for proposing a nice new feature (lines between pages).
                    543:  * Jason McIntyre for an important bug report (hardlink detection)
                    544:    and multiple documentation patches.
                    545:  * Pascal Stumpf (OpenBSD) and Alessandro de Laurenzis for
                    546:    important bug reports (architecture and man -m, respectively).
                    547:  * Thomas Klausner (NetBSD) for proposing a new feature (man(7) -Ios),
                    548:    a bug report, and release testing.
                    549:  * Anthony Bentley, Daniel Dickman, Ted Unangst (OpenBSD) and
                    550:    Kristaps Dzonsons (bsd.lv) for source code patches and bug reports.
                    551:  * Christian Weisgerber (OpenBSD) for more than half a dozen bug reports.
                    552:  * Carsten Kunze (Heirloom troff) for bug reports and release testing.
                    553:  * Antoine Jacoutot (OpenBSD) for release testing.
                    554:  * Alexis Hildebrandt (Homebrew), Baptiste Daroussin (FreeBSD),
                    555:    Jonathan Perkin (SmartOS), Pedro Giffuni (FreeBSD), Svyatoslav
                    556:    Mishyn (Crux Linux), Ulrich Spoerlein (FreeBSD), Jan Stary, Patrick
                    557:    Keshishian, Sebastien Marie, and Steffen Nurpmeso for bug reports.
1.7       schwarze  558:
1.8       schwarze  559: Changes in version 1.13.2, released on December 13, 2014
1.7       schwarze  560:
                    561:     --- MAJOR NEW FEATURES ---
                    562:  * Include an implementation of man(1), the manual page viewer.
                    563:  * Unified set of command line option, each one supported by all
                    564:    command names, including new options -a (format all), -c (no
                    565:    pager), -h (synopsis only), and -w (list filenames).
                    566:  * Support the MANPAGER and PAGER environment variables.
                    567:  * Support gzip'ed manuals by the whole toolset, even as .so targets.
                    568:  * Support UTF-8 and Latin-1 input by the whole toolset, delete preconv(1).
                    569:  * Switch the default output mode from -Tascii to -Tlocale.
                    570:  * Improve -Tascii output for Unicode escape sequences.
                    571:  * Let the -Thtml output mode produce polyglot HTML5.
                    572:  * Many improvements for eqn(7), in particular in-line equations,
                    573:    MathML output in -Thtml mode, and much improved terminal formatting.
                    574:     --- PORTABILITY IMPROVEMENTS ---
                    575:  * Change the build sequence to the usual ./configure; make; make install.
                    576:  * Support ./configure.local for build customizations.
                    577:  * Autodetect wchar, sqlite3, and manpath support.
                    578:  * Provide a fallback version of fts(3) for systems lacking it.
                    579:  * Support choosing alternative binary and manual names.
                    580:     --- MINOR NEW FEATURES ---
                    581:  * Rudimentary implementation of the e, x, and z tbl(7) layout
                    582:    modifiers to equalize, maximize, and ignore the width of columns.
                    583:  * Implement font modifiers in tbl(7) layouts.
                    584:  * Allow comma-separated options in the tbl(7) options line.
                    585:  * Parse and ignore the .pl (page length) roff(7) request.
                    586:  * Implement .An -[no]split for the mdoc(7) -Thtml output mode.
                    587:  * Support bold italic font in PostScript and PDF output.
                    588:  * Warn about commas in function arguments and parentheses in function names.
                    589:  * Warn about botched .Xr ordering and punctuation below SEE ALSO.
                    590:  * Warn about AUTHORS sections without .An macros.
                    591:  * Warn about attempts to call non-callable macros.
                    592:  * New developer documentation manual page mandoc_headers(3).
                    593:     --- BUGFIXES ---
                    594:  * Fix read buffer overrun sometimes triggered by trailing whitespace.
                    595:  * Fix read buffer overrun triggered by certain invalid \H sequences.
                    596:  * Fix NULL pointer access triggered by .Bl without any arguments.
                    597:  * Fix NULL pointer access triggered by .It Nm Fo without .Fc.
                    598:  * Fix NULL pointer access triggered by .Sh Xo .Sh without .Xc.
                    599:  * Fix NULL pointer access triggered by missing .Nm.
                    600:  * Fix an assertion triggered by .It right after .El.
                    601:  * Fix an assertion triggered by .Ec without preceding .Eo.
                    602:  * Fix an assertion triggered by .Sm or .Db with multiple arguments.
                    603:  * Fix assertion failures triggered by very large width arguments.
                    604:  * Fix a division by zero in the roff(7) parser.
                    605:  * Prevent negative arguments to .ll from causing integer underflow.
                    606:  * Correctly autodetect source format even when .Dd is preceded by .ll.
                    607:  * Multiple fixes with respect to .Bd and .Bl -offset and -width.
                    608:  * Many bugfixes with respect to scaling units.
                    609:  * Multiple fixes with respect to delimiter handling by in-line macros.
                    610:  * Multiple fixes with respect to .Pf.
                    611:  * Make \c work properly in no-fill mode.
                    612:  * Stricter syntax checking of Unicode character names.
                    613:     --- THANKS TO ---
                    614:  * Kristaps Dzonsons for rewriting the eqn(7) parser, implementing
                    615:    HTML5 and MathML output, and various other code contributions.
                    616:  * Jonathan Gray (OpenBSD) for extensive testing with afl (the
                    617:    American Fuzzy Lop security fuzzer) resulting in many bug reports.
                    618:  * Anthony Bentley (OpenBSD), Baptiste Daroussin (FreeBSD), Daniel
                    619:    Dickman, Doug Hogan, Jason McIntyre, Theo de Raadt (OpenBSD),
                    620:    and Martin Natano for source code patches.
                    621:  * Carsten Kunze (Heirloom troff), Daniel Levai (Slackware),
                    622:    Garrett D'Amore (illumos), Giovanni Becchis, Matthew Dempsky,
                    623:    Stuart Henderson, Ted Unangst, Todd Miller (OpenBSD), Thomas
                    624:    Klausner (NetBSD), Ulrich Spoerlein (FreeBSD), Justin Haynes,
                    625:    Marcus Merighi, Sebastien Marie, Steffen Nurpmeso and Theo Buehler
                    626:    for bug reports.
1.5       schwarze  627:
                    628: Changes in version 1.13.1, released on August 10, 2014
                    630:     --- MAJOR NEW FEATURES ---
                    631:  * A complete apropos(1)/makewhatis(8)/man.cgi(8) suite
                    632:    based on SQLite3 is now included.
                    633:  * The roff(7) parser now provides an almost complete implementation
                    634:    of numerical expressions.
                    635:  * Warning and error messages have been improved in many ways.
                    636:    Almost all fatal errors were downgraded to normal errors and some
                    637:    even to warnings.  Almost all messages now mention the macro where
                    638:    the issue is detected and many indicate the workaround employed.
                    639:    The mandoc(1) manual now includes a list explaining all messages.
                    640:     --- MINOR NEW FEATURES ---
                    641:  * The roff(7) parser now supports the .ami (append to macro with
                    642:    indirectly specified name), .as (append to user-defined
                    643:    string), .dei (define macro with indirectly specified name),
                    644:    .ll (line length), and .rr (remove register) requests.
                    645:  * The roff(7) parser now supports string comparison and numerical
                    646:    conditionals in the .if and .ie requests.
                    647:  * The roff parser now fully supports the \B (validate numerical
                    648:    expression) and partially supports the \w (measure text width)
                    649:    escape sequences.
                    650:  * The terminal formatter now supports the \: (optional line break)
                    651:    escape sequence.
                    652:  * The roff parser now supports expansion of user-defined strings
                    653:    involving indirect references.
                    654:  * The roff(7) parser now handles some pre-defined read-only
                    655:    number registers that occur in the pod2man(1) preamble.
                    656:  * For backward compatibility, the mdoc(7) parser and formatters
                    657:    now support the obsolete macros .En, .Es, .Fr, and .Ot.
                    658:  * The mdoc(7) formatter non partially supports .Bd -centered.
                    659:  * tbl(7) now handles leading and trailing vertical lines.
                    660:  * The build system now provides fallback versions of strcasestr(3)
                    661:    and strsep(3) for systems lacking them.
                    662:  * The mdoc(7) manual now explains how various standards
                    663:    supported by the .St macro are related to each other.
                    664:     --- BUGFIXES ---
                    665:  * In the roff(7) parser, several bugs were fixed with respect
                    666:    to closing conditional blocks on macro lines.
                    667:  * Parsing of roff(7) identifiers and escape sequences was improved
                    668:    in multiple respects.
                    669:  * In the mdoc(7) parser, the handling of defective document
                    670:    prologues was improved in multiple ways.
                    671:  * The mdoc(7) parser no longer skips content before the first section
                    672:    header, and it no longer deletes non-.% content from .Rs blocks.
                    673:  * In the mdoc(7) parser, a crash was fixed related to weird .Sh headers.
                    674:  * In the mdoc(7) parser, handling of .Sm with missing or invalid
                    675:    arguments was corrected.
                    676:  * In the mdoc(7) parser, trailing punctuation at the end of partial
                    677:    implicit macros no longer triggers end-of-sentence spacing.
                    678:  * In the terminal formatter, two crashes were fixed: one triggered by
                    679:    excessive indentation and another by excessively long .Nm arguments.
                    680:  * In the terminal formatter, a floating point rounding bug was
                    681:    fixed that sometimes caused an off-by-one error in indentation.
                    682:  * In the UTF-8 formatter, rendering of accents, breakable hyphens,
                    683:    and non-breakable spaces was corrected.
                    684:  * In the HTML formatter, encoding of special characters was
                    685:    corrected in multiple respects.
                    686:  * In the mdoc(7) formatter, rendering of .Ex and .Rv was
                    687:    improved for various edge cases.
                    688:  * In the mdoc(7) formatter, handling of empty .Bl -inset item
                    689:    heads was improved.
                    690:  * In the man(7) formatter, some bugs were fixed with respect
                    691:    to same-line detection in the context of .TP and .nf macros,
                    692:    and the indentation of .IP and .TP blocks was improved.
                    693:  * The mandoc(3) library no longer prints to stderr.
                    694:     --- THANKS TO ---
                    695:    Abhinav Upadhyay (NetBSD), Andreas Voegele, Anthony Bentley (OpenBSD),
                    696:    Christian Weisgerber (OpenBSD), Havard Eidnes (NetBSD), Jan Stary,
                    697:    Jason McIntyre (OpenBSD), Jeremie Courreges-Anglas (OpenBSD),
                    698:    Joerg Sonnenberger (NetBSD), Juan Francisco Cantero Hurtado (OpenBSD),
                    699:    Marc Espie (OpenBSD), Matthias Scheler (NetBSD), Pascal Stumpf (OpenBSD),
                    700:    Paul Onyschuk (Alpine Linux), Sebastien Marie, Steffen Nurpmeso,
                    701:    Stuart Henderson (OpenBSD), Ted Unangst (OpenBSD), Theo de Raadt (OpenBSD),
                    702:    Thomas Klausner (NetBSD), and Ulrich Spoerlein (FreeBSD)
                    703:    for reporting bugs and missing features.
1.4       schwarze  704:
                    705: Changes in version 1.12.3, released on December 31, 2013
                    707:  * In the mdoc(7) SYNOPSIS, line breaks and hanging indentation
                    708:    now work correctly for .Fo/.Fa/.Fc and .Fn blocks.
                    709:    Thanks to Franco Fichtner for doing part of the work.
                    710:  * The mdoc(7) .Bk macro got some addititonal bugfixes.
                    711:  * In mdoc(7) macro arguments, double quotes can now be quoted
                    712:    by doubling them, just like in man(7).
                    713:    Thanks to Tsugutomo ENAMI for the patch.
                    714:  * At the end of man(7) macro lines, end-of-sentence spacing
                    715:    now works.  Thanks to Franco Fichtner for the patch.
                    716:  * For backward compatibility, the man(7) parser now supports the
                    717:    man-ext .UR/.UE (uniform resource identifier) block macros.
                    718:  * The man(7) parser now handles closing blocks that are not open
                    719:    more gracefully.
                    720:  * The man(7) parser now ignores blank lines right after .SH and .SS.
                    721:  * In the man(7) formatter, reset indentation when leaving a block,
                    722:    not just when entering the next one.
                    723:  * The roff(7) .nr request now supports incrementing and decrementing
                    724:    number registers and stops parsing the number right before the
                    725:    first non-digit character.
                    726:  * The roff(7) parser now supports the alternative escape sequence
                    727:    syntax \C'uXXXX' for Unicode characters.
                    728:  * The roff(7) parser now parses and ignores the .fam (font family)
                    729:    and .hw (hyphenation points) requests and the \d and \u escape
                    730:    sequences.
                    731:  * The roff(7) manual got a new ESCAPE SEQUENCE REFERENCE.
1.1       schwarze  732:
1.2       schwarze  733: Changes in version 1.12.2, released on Oktober 5, 2013
1.1       schwarze  734:
                    735:  * The mdoc(7) to man(7) converter, to be called as mandoc -Tman,
                    736:    is now fully functional.
                    737:  * The mandoc(1) utility now supports the -Ios (default operating system)
                    738:    input option, and the -Tutf8 output mode now actually works.
                    739:  * The mandocdb(8) utility no longer truncates existing databases when
                    740:    starting to build new ones, but only replaces them when the build
                    741:    actually succeeds.
                    742:  * The man(7) parser now supports the PD macro (paragraph distance),
                    743:    and (for GNU man-ext compatibility only) EX (example block) and EE
                    744:    (example end).  Plus several bugfixes regarding indentation, line
                    745:    breaks, and vertical spacing, and regarding RS following TP.
                    746:  * The roff(7) parser now supports the \f(BI (bold+italic) font escape,
                    747:    the \z (zero cursor advance) escape and the cc (change control
                    748:    character) and it (input line trap) requests. Plus bugfixes regarding
                    749:    the \t (tab) escape, nested escape sequences, and conditional requests.
                    750:  * In mdoc(7), several bugs were fixed related to UTF-8 output of quoting
                    751:    enclosures, delimiter handling, list indentation and horizontal and
                    752:    vertical spacing, formatting of the Lk, %U, and %C macros, plus some
                    753:    bugfixes related to the handling of syntax errors like badly nested
                    754:    font blocks, stray Ta macros outside column lists, unterminated It Xo
                    755:    blocks, and non-text children of Nm blocks.
                    756:  * In tbl(7), the width of horizontal spans and the vertical spacing
                    757:    around tables was corrected, and in man(7) files, a crash was fixed
                    758:    that was triggered by some particular unclosed T{ macros.
                    759:  * For mandoc developers, we now provide a tbl(3) library manual and
                    760:    gmdiff, a very small, very simplistic groff-versus-mandoc output
                    761:    comparison tool.
1.2       schwarze  762:  * Provide this NEWS file.
1.1       schwarze  763:
                    764: Changes in version 1.12.1, released on March 23, 2012
                    766:  * Significant work on apropos(1) and mandocdb(8). These tools are now
                    767:    much more robust.  A whatis(1) implementation is now handled as an
                    768:    apropos(1) mode.  These tools are also able to minimally handle
                    769:    pre-formatted pages, that is, those already formatted by another
                    770:    utility such as GNU troff.
                    771:  * The man.cgi(7) script is also now available for wider testing.
                    772:    It interfaces with mandocdb(8) manuals cached by catman(8).
                    773:    HTML output is generated on-the-fly by libmandoc or internal
                    774:    methods to convert pre-formatted pages.
                    775:  * The mailing list archive for the discuss and tech lists are being
                    776:    hosted by Gmane at gmane.comp.tools.mdocml.user and
                    777:    gmane.comp.tools.mdocml.devel, respectively.
                    779: Changes in version 1.12.0, released on October 8, 2011
                    781:  * This version features a new, work-in-progress mandoc(1) output mode:
                    782:    -Tman.  This mode allows a system maintainer to distribute man(7)
                    783:    media for older systems that may not natively support mdoc(7), such
                    784:    as old Solaris systems.
                    785:  * The -Ofragment option was added to mandoc(1)'s -Thtml and -Txhtml modes.
                    786:  * While adding features, an apropos(1) utility has been merged from the
                    787:    mandoc-tools sandbox.  This interfaces with mandocdb(8) for semantic
                    788:    search of manual content.  apropos(1) is different from the traditional
                    789:    apropos primarily in allowing keyword search (such as for functions,
                    790:    utilities, etc.) and regular expressions.  Note that the calling
                    791:    syntax for apropos is likely to change as it settles down.
                    792:  * In documentation news, the mdoc(7) and man(7) manuals have been
                    793:    made considerably more readable by adding MACRO OVERVIEW sections, by
                    794:    moving the gory details of the LANGUAGE SYNTAX to the roff(7) manual,
                    795:    and by moving the very technical MACRO SYNTAX sections down to the
                    796:    bottom of the page.
                    797:  * Furthermore, for tbl(7), the -Tascii mode horizontal spacing of tables
                    798:    was rewritten completely.  It is now compatible with groff(1), both
                    799:    with and without frames and rulers.
                    800:  * Nesting of indented blocks is now supported in man(7), and several
                    801:    bugs were fixed regarding indentation and alignment.
                    802:  * The page headers in mdoc(7) are now nicer for very long titles.
                    804: Changes in version 1.11.7, released on September 2, 2011
                    806:  * Added demandoc(1) utility for stripping away macros and escapes.
                    807:    This replaces the historical deroff(1) utility.
                    808:  * Also improved the mdoc(7) and man(7) manuals.
                    810: Changes in version 1.11.6, released on August 16, 2011
                    812:  * Handling of tr macro in roff(7) implemented.  This makes Perl
                    813:    documentation much more readable.  Hyphenation is also now enabled in
                    814:    man(7) format documents.  Many other general improvements have been
                    815:    implemented.
                    817: Changes in version 1.11.5, released on July 24, 2011
                    819:  * Significant eqn(7) improvements.  mdocml can now parse arbitrary eqn
                    820:    input (although few GNU extensions are accepted, nor is mixing
                    821:    low-level roff with eqn).  See the eqn(7) manual for details.
                    822:    For the time being, equations are rendered as simple in-line text.
                    823:    The equation parser satisfies the language specified in the
                    824:    Second Edition User's Guide:
                    825:    http://www.kohala.com/start/troff/v7man/eqn/eqn2e.ps
                    827: Changes in version 1.11.4, released on July 12, 2011
                    829:  * Bug-fixes and clean-ups across all systems, especially in mandocdb(8)
                    830:    and the man(7) parser.  This release was significantly assisted by
                    831:    participants in OpenBSD's c2k11.  Thanks!
                    833: Changes in version 1.11.3, released on May 26, 2011
                    835:  * Introduce locale-encoding of output with the -Tlocale output option and
                    836:    Unicode escaped-character input.  See mandoc(1) and mandoc_char(7),
                    837:    respectively, for details.  This allows for non-ASCII characters (e.g.,
                    838:    \[u5000]) to be rendered in the locale's encoding, if said environment
                    839:    supports wide-character encoding (if it does not, -Tascii is used
                    840:    instead).  Locale support can be turned off at compile time by removing
                    841:    -DUSE_WCHAR in the Makefile, in which case -Tlocale is always a synonym
                    842:    for -Tascii.
                    843:  * Furthermore, multibyte-encoded documents, such as those in UTF-8, may
                    844:    be on-the-fly recoded into mandoc(1) input by using the newly-added
                    845:    preconv(1) utility.  Note: in the future, this feature may be
                    846:    integrated into mandoc(1).
                    848: Changes in version 1.11.2, released on May 12, 2011
                    850:  * Corrected some installation issues in version 1.11.1.
                    851:  * Further migration to libmandoc.
                    852:  * Initial public release (this utility is very much under development)
                    853:    of mandocdb(8).  This utility produces keyword databases of manual
                    854:    content, which features semantic querying of manual content.
                    856: Changes in version 1.11.1, released on April 4, 2011
                    858:  * The earlier libroff, libmdoc, and libman soup have been merged into
                    859:    a single library, libmandoc, which manages all aspects of parsing
                    860:    real manuals, from line-handling to tbl(7) parsing.
                    861:  * As usual, many general fixes and improvements have also occurred.
                    862:    In particular, a great deal of redundancy and superfluous code has
                    863:    been removed with the merging of the backend libraries.
1.3       schwarze  864:  * see also the changes in 1.10.10
                    866: Changes in version 1.10.10, March 20, 2011, NOT released
                    868:  * Initial eqn(7) functionality is in place.  For the time being,
                    869:    this is limited to the recognition of equation blocks;
                    870:    future version of mdocml will expand upon this framework.
1.1       schwarze  871:
                    872: Changes in version 1.10.9, released on January 7, 2011
                    874:  * Many back-end fixes have been implemented: argument handling (quoting),
                    875:    man(7) improvements, error/warning classes, and many more.
                    876:  * Initial tbl(7) functionality (see the "TS", "TE", and "T&" macros in
                    877:    the roff(7) manual) has been merged from tbl.bsd.lv.  Output is still
                    878:    minimal, especially for -Thtml and -Txhtml, but manages to at least
                    879:    display data.  This means that mandoc(1) now has built-in support
                    880:    for two troff preprocessors via libroff: soelim(1) and tbl(1).
                    882: Changes in version 1.10.8, released on December 24, 2010
1.3       schwarze  884:  * Overhauled the -Thtml and -Txhtml output modes.  They now display
1.1       schwarze  885:    readable output in arbitrary browsers, including text-based ones like
                    886:    lynx(1).  See HTML and XHTML manuals in the DOCUMENTATION section
                    887:    for examples.  Attention: available style-sheet classes have been
                    888:    considerably changed!  See the example.style.css file for details.
                    889:    Lastly, libmdoc and libman have been cleaned up and reduced in size
                    890:    and complexity.
1.3       schwarze  891:  * see also the changes in 1.10.7
                    893: Changes in version 1.10.7, December 6, 2010, NOT released
                    895:  Significant improvements merged from OpenBSD downstream, including:
                    896:  * many new roff(7) components,
                    897:  * in-line implementation of troff's soelim(1),
                    898:  * broken-block handling,
                    899:  * overhauled error classifications, and
                    900:  * cleaned up handling of error conditions.
1.1       schwarze  901:
                    902: Changes in version 1.10.6, released on September 27, 2010
                    904:  * Calling conventions for mandoc(1) have changed: -W improved and -f
                    905:    deprecated.
                    906:  * Non-ASCII characters are also now uniformly discarded.
                    907:  * Lots of documentation improvements.
                    908:  * Many incremental fixes accomodating for groff's more interesting
                    909:    productions.
                    910:  * Lastly, pod2man(1) preambles are now fully accepted after some
                    911:    considerable roff(7) and special character support.
                    913: Changes in version 1.10.5, released on July 27, 2010
                    915:  * Primarily a bug-fix and polish release, but including -Tpdf support
                    916:    in mandoc(1) by way of "Summer of Code".  Highlights:
                    917:  * fix "Sm" and "Bd" handling
                    918:  * fix end-of-sentence handling for embedded sentences
                    919:  * polish man(7) documentation
                    920:  * document all mdoc(7) macros
                    921:  * polish mandoc(1) -Tps output
                    922:  * lots of internal clean-ups in character escapes
                    923:  * un-break literal contexts in man(7) documents
                    924:  * improve -Thtml output for -man
                    925:  * add mandoc(1) -Tpdf support
                    927: Changes in version 1.10.4, released on July 12, 2010
                    929:  * Lots of features developed during both "Summer of Code" and the
                    930:    OpenBSD c2k10 hackathon:
                    931:  * minimal "ds" roff(7) symbols are supported
                    932:  * beautified SYNOPSIS section output
                    933:  * acceptance of scope-block breakage in mdoc(7)
                    934:  * clarify error message status
                    935:  * many minor bug-fixes and formatting issues resolved
1.3       schwarze  936:  * see also changes in 1.10.3
                    938: Changes in version 1.10.3, June 29, 2010, NOT released
                    940:  * variable font-width and paper-size support in mandoc(1) -Tps output
                    941:  * "Bk" mdoc(7) support
1.1       schwarze  942:
                    943: Changes in version 1.10.2, released on June 19, 2010
                    945:  * Small release featuring text-decoration in -Tps output,
                    946:    a few minor relaxations of errors, and some optimisations.
                    948: Changes in version 1.10.1, released on June 7, 2010
                    950:  * This primarily focusses on the "Bl" and "It" macros described in
                    951:    mdoc(7).  Multi-line column support is now fully compatible with groff,
                    952:    as are implicit list entries for columns.
                    953:  * Removed manuals(7) in favour of http://manpages.bsd.lv.
                    954:  * The way we handle the SYNOPSIS section (see the SYNOPSIS documentation
                    955:    in MANUAL STRUCTURE) has also been considerably simplified compared
                    956:    to groff's method.
                    957:  * Furthermore, the -Owidth=width output option has been added to -Tascii,
                    958:    see mandoc(1).
                    959:  * Lastly, initial PostScript output has been added with the -Tps option
                    960:    to mandoc(1).  It's brutally simple at the moment: fixed-font, with no
                    961:    font decorations.
                    963: Changes in version 1.10.0, released on May 29, 2010
                    965:  * Release consisting of the results from the m2k10 hackathon and up-merge
                    966:    from OpenBSD.  This requires a significant note of thanks to Ingo
                    967:    Schwarze (OpenBSD) and Joerg Sonnenberger (NetBSD) for their hard work,
                    968:    and again to Joerg for hosting m2k10.  Highlights (mostly cribbed from
                    969:    Ingo's m2k10 report) follow in no particular order:
                    970:  * a libroff preprocessor in front of libmdoc and libman stripping out
                    971:    roff(7) instructions;
                    972:  * end-of-sentence (EOS) detection in free-form and macro lines;
                    973:  * correct handling of tab-separated columnar lists in mdoc(7);
                    974:  * improved main calling routines to optionally use mmap(3) for better
                    975:    performance;
                    976:  * cleaned up exiting when invoked as -Tlint or over multiple files
                    977:    with -fign-errors;
                    978:  * error and warning message handling re-written to be unified for
                    979:    libroff, libmdoc, and libman;
                    980:  * handling of badly-nested explicit-scoped macros;
                    981:  * improved free-form text parsing in libman and libmdoc;
                    982:  * significant GNU troff compatibility improvements in -Tascii,
                    983:    largely in terms of spacing;
                    984:  * a regression framework for making sure the many fragilities of GNU
                    985:    troff aren't trampled in subsequent work;
                    986:  * support for -Tascii breaking at hyphens encountered in free-form text;
                    987:  * and many more minor fixes and improvements
                    989: Changes in version 1.9.25, released on May 13, 2010
                    991:  * Fixed handling of "\*(Ba" escape.
                    992:  * Backed out -fno-ign-chars (pointless complexity).
                    993:  * Fixed erroneous breaking of literal lines.
                    994:  * Fixed SYNOPSIS breaking lines before non-initial macros.
                    995:  * Changed default section ordering.
                    996:  * Most importantly, the framework for end-of-sentence double-spacing is
                    997:    in place, now implemented for the "end-of-sentence, end-of-line" rule.
                    998:  * This is a stable roll-back point before the mandoc hackathon in Rostock!
                   1000: Changes in version 1.9.24, released on May 9, 2010
                   1002:  * Rolled back break-at-hyphen.
                   1003:  * -DUGLY is now the default (no feature splits!).
                   1004:  * Free-form text is not de-chunked any more: lines are passed
                   1005:    whole-sale into the front-end, including whitespace.
                   1006:  * Added mailing lists.
                   1008: Changes in version 1.9.23, released on April 7, 2010
                   1010:  * mdocml has been linked to the OpenBSD build.
                   1011:  * This version incorporates many small changes, mostly from patches
                   1012:    by OpenBSD, allowing crufty manuals to slip by with warnings instead
                   1013:    of erroring-out.
                   1014:  * Some subtle semantic issues, such as punctuation scope, have also
                   1015:    been fixed.
                   1016:  * Lastly, some issues with -Thtml have been fixed, which prompted an
                   1017:    update to the online manual pages style layout.
                   1019: Changes in version 1.9.22, released on March 31, 2010
                   1021:  * Adjusted merge of the significant work by Ingo Schwarze
                   1022:    in getting "Xo" blocks (block full implicit, e.g., "It"
                   1023:    for non-columnar lists) to work properly.  This isn't
                   1024:    enabled by default: you must specify -DUGLY as a compiler
                   1025:    flag (see the Makefile for details).
                   1027: Changes in version 1.9.20, released on March 30, 2010
                   1029:  * More efforts to get roff instructions in man(7) documents under
                   1030:    control.  Note that roff instructions embedded in line-scoped,
                   1031:    next-line macros (e.g. "B") are not supported.
                   1032:  * Leading punctuation for mdoc(7) macros, such as "Fl ( ( a",
                   1033:    are now correctly handled.
                   1035: Changes in version 1.9.18, released on March 27, 2010
                   1037:  * Many fixes (largely pertaining to scope)
                   1038:    and improvements (e.g., handling of apostrophe-control macros,
                   1039:    which fixes the strange "BR" seen in some macro output)
                   1040:    to handling roff instructions in man(7) documents.
                   1042: Changes in version 1.9.17, released on March 25, 2010
                   1044:  * Accept perlpod(1) standard preamble.
                   1045:  * Also accept (and discard) "de", "dei", "am", "ami", and "ig"
                   1046:    roff macro blocks.
                   1048: Changes in version 1.9.16, released on March 22, 2010
                   1050:  * Inspired by patches and bug reports by Ingo Schwarze,
                   1051:    allowed man(7) to accept non-printing elements to be nested
                   1052:    within next-line scopes, such as "br" within "B" or "TH",
                   1053:    which is valid roff.
                   1054:  * Longsoon architecture also noted and Makefile cleaned up.
                   1056: Changes in version 1.9.15, released on February 18, 2010
                   1058:  * Moved to our new BSD.lv home.
                   1059:  * XHTML is now an acceptable output mode for mandoc(1);
                   1060:  * "Xr" made more compatible with groff;
                   1061:  * "Vt" fixed when invoked in SYNOPSIS;
                   1062:  * "\\" escape removed;
                   1063:  * end-of-line white-space detected for all lines;
                   1064:  * subtle bug fixed in list display for some modes;
                   1065:  * compatibility layer checked in for compilation in diverse
                   1066:    UNIX systems;
                   1067:  * and column lengths handled correctly.
                   1069: For older releases, see the ChangeLog files
1.22      schwarze 1070: in http://mandoc.bsd.lv/snapshots/ .