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

Diff for /mandoc/NEWS between version 1.5 and 1.11

version 1.5, 2014/08/10 16:32:57 version 1.11, 2016/07/07 23:46:36
Line 2  $Id$
Line 2  $Id$
   
 This file lists the most important changes in the mdocml.bsd.lv distribution.  This file lists the most important changes in the mdocml.bsd.lv distribution.
   
   Changes in version 1.13.4, to be released on July XXX, 2016
   
       --- MAJOR NEW FEATURES ---
    * man.conf(5): Design and implement a simpler configuration file format.
    * man(1): Leverage less(1) -T and :t in a way resembling ctags(1)
      to jump to the definitions of various terms inside manual pages.
    * soelim(1): New implementation by Baptiste Daroussin.
    * pledge(2): Use the OpenBSD privilege limitation syscall when available.
    * man.cgi(8): Support short URIs.
    * mandoc.css: Use one unified stylesheet rather than three different ones.
       --- MAJOR FUNCTIONALLY RELEVANT BUGFIXES ---
    * mdoc(7): Fix multiple aspects of SYNOPSIS .Nm formatting.
    * man(1): Fix process group handling, avoiding unclean shutdowns.
       --- PORTABILITY IMPROVEMENTS ---
    * Correctly use the ohash(3) compatibility implementation
      even when building without SQLite support.
    * Add compat glue for building on Solaris 9 and 10.
    * Let ./configure select a supported RE syntax for word boundaries.
    * Avoid reusing va_lists, use va_copy(3) for better portability.
    * Do not hardcode the path to the more(1) program.
       --- MINOR NEW FEATURES ---
    * roff(7): Implement \n(.$ (number of macro arguments).
    * roff(7): Fully implement \z (do not advance cursor).
    * roff(7): Implement the `r'  conditional (register exists).
    * roff(7): Implement \\$* (interpolate all arguments).
    * roff(7): Parse and ignore \, and \/ (italic corrections).
    * When there is no -m, no -M, no MANPATH and no /etc/man.conf,
      fall back to /usr/share/man:/usr/X11R6/man:/usr/local/man.
    * man(1): Give manuals in purely numerical sections priority over
      manuals of the same name in sections with an alphabetical suffix.
    * man.cgi(8): Support "header.html" and "footer.html".
    * man.cgi(8): Set the "autofocus" attribute on the query text box.
    * man.cgi(8): Simplify the search form, drop two useless buttons.
       --- RELIABILITY BUGFIXES ---
    * mdoc(7): Avoid a use after free and an assertion failure when nodes
      are deleted during validation.
    * mdoc(7): Avoid a NULL pointer access when .Bd has no arguments.
    * mdoc(7): Avoid a NULL pointer access triggered by mismatching end macros.
    * mdoc(7): Avoid an assertion when .Fo has no argument.
    * mdoc(7): Avoid an assertion when .Ta<tab> occurs in .Bl -column.
    * mdoc(7): Avoid an assertion when a body gets broken and has a tail.
    * roff(7): Avoid an assertion caused by blanks inside \o.
    * tbl(7): Avoid a use after free when the last line of a layout is empty.
    * eqn(7): Avoid an infinite loop caused by recursive "define".
    * makewhatis(8): Avoid a segfault caused by unusual directory structures.
    * Fix handling of leading, trailing, and double colons in MANPATH and -m.
       --- MINOR BUGFIXES ---
    * mdoc(7): Put arguments to end macros of broken partial explicit blocks
      inside the breaking block.
    * mdoc(7): Let .Dv force normal font.
    * mdoc(7): Make trailing whitespace significant in .Bl -tag widths.
    * mdoc(7): Fix macro interpretation around tabs in .Bl -column.
    * man(7): Use the default width for .RS without arguments.
    * man(7): On a new RS nesting level, the saved width starts from
      the default width, not from the saved width of the previous level.
    * man(7): Allow .PD in next-line scope.
    * man(7): Improve handling of empty .HP.
    * man(7): Improve formatting of .br and .sp inside .HP.
    * man(7): Do not mistreat empty arguments to font alternating
      macros as vertical spacing requests.
    * man(7): Allow fill mode changes in tagged paragraph next-line scope.
    * man(7): Fix minor bugs in block rewinding and simplify the related code.
    * man(7): Add missing line breaks before subsection headers.
    * man(7): Give section and subsection headers hanging indentation.
    * man(7): Make trailing whitespace significant in .TP widths.
    * roff(7): Don't allow breaking the output line after hyphens
      that immediately follow escape sequences.
    * roff(7): Ignore blank characters at the beginning of conditional blocks.
    * roff(7): Escape breakable hyphens only after handling input line traps.
    * roff(7): Reject \[uD800] to \[uDFFF] (surrogates) in the parser.
    * tbl(7): Allow more than one data field after T} on the same input line.
    * terminal output: Apply bold and italic to non-ASCII Unicode codepoints.
    * terminal output: Improve rounding rules for horizontal scaling widths.
    * HTML output: Render ASCII_NBRSP as "&nbsp;", not "-".
    * man(1): Do not match the first part of a name if it continues with a dot.
    * man(1): Keep working even if the current directory is unusable.
    * man(1): Handle SIGPIPE to avoid ugly "Broken pipe" messages.
    * man(1): Better error message when $PAGER is invalid.
    * makewhatis(8): Improve handling of .Va and .Vt macros.
    * apropos(1): Print "nothing appropriate" to stderr when appropriate.
    * apropos(1): Abort with a useful error message when elementary
      database operations like preparing queries or binding variables fail.
       --- STRUCTURAL CHANGES, no functional change ---
    * mdoc(7) and man(7): Unified data structures struct roff_node etc.
    * mdoc(7) and man(7): Unified node handling library in roff.c.
    * mdoc(7) and man(7): Seperate validation phase from parsing.
    * Replace all hand-rolled hash tables with ohash(3).
    * Link with libz rather than forking gunzip(1).
       --- THANKS TO ---
    * Baptiste Daroussin (FreeBSD) for the new soelim(1).
    * Anthony Bentley (OpenBSD) for unifying mandoc.css, two nice
      patches for man.cgi(8), some documentation patches, some bug
      reports, and various useful discussions.
    * Todd Miller (OpenBSD) for lots of help with process group and
      signal handling, a few patches, some bug reports and some useful
      discussions.
    * Jonathan Gray (OpenBSD) for yet more testing with afl(1)
      again resulting in more than half a dozen important bug reports.
    * Christos Zoulas (NetBSD) for a bug fix patch and some useful
      suggestions for cleanup.
    * Florian Obser (OpenBSD) for a bugfix patch and some bug reports.
    * Sevan Janiyan and Jan Holzhueter for help with Solaris compatibility,
      and to OpenCSW in general for providing me with a Solaris 9/10/11
      testing environment.
    * Christian Neukirchen for a number of compatibility patches and
      several bug reports.
    * Svyatoslav Mishyn (Crux Linux) for a compatibility patch
      and a number of bug reports.
    * Michael McConville (OpenBSD) for some simple cleanup patches.
    * Christian Weisgerber, Dmitrij Czarkoff, Igor Sobrado,
      Ken Westerback, Marc Espie, Mike Belopuhov, Ted Unangst,
      Tim van der Molen, Theo Buehler, Theo de Raadt (OpenBSD),
      Thomas Klausner (NetBSD), Kurt Jaeger, Dag Erling Smoergrav
      (FreeBSD), Carsten Kunze (Heirloom troff), Daniel Levai,
      Fabian Raetz, Jan Stary, Jean-Yves Migeon, Joerg Sonnenberger,
      Lorenzo Beretta, Markus Waldeck, Maxim Belooussov, Michael Reed,
      Peter Bray, and Serguey Parkhomovsky for bug reports and feature
      suggestions.
    * Alexander Hall, Andrew Fresh, Antoine Jacoutot, Doug Hogan,
      Jason McIntyre, Jasper Lievisse Adriaanse, Kent Spillner,
      Nicholas Marriott, Peter Hessler, Sebastien Marie, Stefan Sperling,
      and Theo de Raadt (OpenBSD) for helpful discussions and feedback.
   
   Changes in version 1.13.3, released on March 13, 2015
   
       --- MAJOR NEW FEATURES ---
    * When a manual is missing from an outdated database, let man(1)
      show it anyway, using a KISS file system lookup as a fallback.
    * Use this to always provide man(1), even without database support.
    * Fatal errors no longer exist.  If a file can be opened, mandoc
      will produce some output; at worst, the output may be almost empty.
    * New -Wunsupp message level.
       --- POTENTIONALLY SECURITY RELEVANT BUGFIXES ---
    * Fix a potential write buffer overrun on incomplete string conditionals.
      http://mdocml.bsd.lv/cgi-bin/cvsweb/roff.c#rev1.241
    * Fix a potential write buffer overrun on backslash at EOF in a conditional.
      http://mdocml.bsd.lv/cgi-bin/cvsweb/roff.c#rev1.247
    * Fix a use after free sometimes hit when validation deletes a block.
      http://mdocml.bsd.lv/cgi-bin/cvsweb/mdoc_macro.c#rev1.180
       --- MAJOR FUNCTIONALLY RELEVANT BUGFIXES ---
    * Let man(1) show manuals for the current architecture by default,
      and support the MACHINE environment variable.
    * Fix the man(1) and apropos(1) -m option, it didn't work at all.
    * Do not spawn a pager when there is no output.
    * In makewhatis(8), fix detection of hardlinked manuals on platforms
      having padding in struct inodev (typically 64bit platforms).
       --- PORTABILITY IMPROVEMENTS ---
    * Ignore O_CLOEXEC when the operating system doesn't provide it.
    * Avoid forward reference to enum type which violates ISO C99.
    * Support homebrew-style linking on Mac OS X.
       --- MINOR NEW FEATURES ---
    * lookup: Accept digit+letter and "n" as section names in man(1),
      and consistently handle digit+letter in file name extensions.
    * lookup: Speed up -s/-S by using the "mlinks" rather than the "keys" table.
    * output: Insert horizontal lines between formatted manual pages.
    * input: New stricter and more resilient UTF-8 parser.
    * mdoc(7): Refactor block rewinding for simpler and more robust parsing.
    * man(7): Use the -Ios option when .TH has less than four arguments.
    * tbl(7): Implement the "center" option.
    * tbl(7): New option and format parsers, improved in many respects.
    * roff(7): Basic implementation of the \o escape sequence (overstrike),
      and improved rendering of overstrikes in PostScript and PDF output.
    * Message improvements, in particular for, but not restricted to,
      eqn(7), tbl(7), and wrong numbers of arguments in mdoc(7) and man(7),
      in various cases also improving output generated by invalid input.
    * Delete the -V option.  It serves no purpose but keeps confusing people.
    * gmdiff: Minimal support for Heirloom roff.
       --- RELIABILITY BUGFIXES ---
    * tbl(7): Fix a read buffer overrun on 'f' at EOL in a layout.
    * roff(7): Fix a read buffer overrun on incomplete numerical conditions.
    * mdoc(7): Fix a NULL pointer access on .Nd followed by an explicit block.
    * mdoc(7): Fix a NULL pointer access on .It Xo without .Xc.
    * mdoc(7): Fix a NULL pointer access on .Eo without a tail.
    * mdoc(7): Fix a NULL pointer access in the validation of empty .St macros.
    * man(7)/tbl(7): Fix a NULL pointer access on .TS right after .TP.
    * tbl(7): Fix a NULL pointer access on layout lines without any cells.
    * eqn(7): Fix NULL pointer accesses in the terminal formatter.
    * roff(7): Fix a NULL pointer access on trailing \s-/\s+ without an argument.
    * gz: Fix a potential NULL pointer access after waitpid() failure.
    * roff(7): Don't let the modulo operator divide by zero.
    * input: Fix an assertion failure on certain invalid UTF-8 input.
    * terminal output: Allow arbitrary depth of the font stack (assertion fix).
    * mdoc(7): Fix assertion failures and endless loops on invalid block closing.
    * mdoc(7): Fix an assertion failure on .Bl .Sm not followed by .It.
    * mdoc(7): Fix an assertion failure on .Bl -column ... .El .Ta.
    * tbl(7): Fix assertion failures by macros inside table data,
      but do not throw away the macro arguments.
    * Prevent certain kinds of unreasonable input from producing excessive
      output, in one case caused by unsigned integer underflow.
    * Fix a potential memory leak in makewhatis(8) on very long filenames.
       --- MINOR BUGFIXES ---
    * mdoc(7): Fix parsing of badly nested blocks with multiple identical blocks.
    * mdoc(7): Support negative indentations for displays and lists.
    * mdoc(7): Don't mistreat negative .sp arguments as large positive ones.
    * mdoc(7): Some spacing fixes for .Eo/.Ec.
    * man(7): Support negative horizontal widths.
    * man(7): Do not print out invalid .IP arguments.
    * man(7): Correctly handle scaling units after .PD.
    * man(7): Support .RE with an argument.
    * man(7): Fix restoring indentation after .RS with large negative arguments.
    * tbl(7): Prevent tables from breaking the filling of preceding text.
    * tbl(7): Fix vertical spacing at the beginning of tables.
    * tbl(7): Parser and formatter fixes for line drawing and font modifiers.
    * tbl(7): Correct handling of blank data lines.
    * eqn(7): Add sometimes missing whitespace before equation output.
    * roff(7): Fix vertical scaling, most of it was wrong.
    * roff(7): Slightly improve \w width measurements.
    * roff(7): Accept the historic aliases \s10 to \s39 for \s(10 to \s(39.
    * roff(7): Correctly escape quotes when expanding macro arguments.
    * roff(7): Correctly handle scaling units in numerical expressions,
      and some other improvements to the parsing of numerical expressions.
    * roff(7): Three minor fixes with respect to evaluation of conditionals.
    * roff(7): Let .it accept numerical expressions, not just constants.
    * mandoc_char(7): Correct some character names and renderings.
    * If earlier files set a non-zero exit status, never reset it to zero.
       --- THANKS TO ---
    * Jonathan Gray (OpenBSD) for yet more testing with afl (the American
      Fuzzy Lop security fuzzer), again resulting in many bug reports.
    * Theo de Raadt (OpenBSD) for suggesting the main new feature (man(1) file
      system lookup) and for reporting an important bug (pager without output).
    * Theo Buehler for an important bug report (-s/-S slowness)
      and for proposing a nice new feature (lines between pages).
    * Jason McIntyre for an important bug report (hardlink detection)
      and multiple documentation patches.
    * Pascal Stumpf (OpenBSD) and Alessandro de Laurenzis for
      important bug reports (architecture and man -m, respectively).
    * Thomas Klausner (NetBSD) for proposing a new feature (man(7) -Ios),
      a bug report, and release testing.
    * Anthony Bentley, Daniel Dickman, Ted Unangst (OpenBSD) and
      Kristaps Dzonsons (bsd.lv) for source code patches and bug reports.
    * Christian Weisgerber (OpenBSD) for more than half a dozen bug reports.
    * Carsten Kunze (Heirloom troff) for bug reports and release testing.
    * Antoine Jacoutot (OpenBSD) for release testing.
    * Alexis Hildebrandt (Homebrew), Baptiste Daroussin (FreeBSD),
      Jonathan Perkin (SmartOS), Pedro Giffuni (FreeBSD), Svyatoslav
      Mishyn (Crux Linux), Ulrich Spoerlein (FreeBSD), Jan Stary, Patrick
      Keshishian, Sebastien Marie, and Steffen Nurpmeso for bug reports.
   
   Changes in version 1.13.2, released on December 13, 2014
   
       --- MAJOR NEW FEATURES ---
    * Include an implementation of man(1), the manual page viewer.
    * Unified set of command line option, each one supported by all
      command names, including new options -a (format all), -c (no
      pager), -h (synopsis only), and -w (list filenames).
    * Support the MANPAGER and PAGER environment variables.
    * Support gzip'ed manuals by the whole toolset, even as .so targets.
    * Support UTF-8 and Latin-1 input by the whole toolset, delete preconv(1).
    * Switch the default output mode from -Tascii to -Tlocale.
    * Improve -Tascii output for Unicode escape sequences.
    * Let the -Thtml output mode produce polyglot HTML5.
    * Many improvements for eqn(7), in particular in-line equations,
      MathML output in -Thtml mode, and much improved terminal formatting.
       --- PORTABILITY IMPROVEMENTS ---
    * Change the build sequence to the usual ./configure; make; make install.
    * Support ./configure.local for build customizations.
    * Autodetect wchar, sqlite3, and manpath support.
    * Provide a fallback version of fts(3) for systems lacking it.
    * Support choosing alternative binary and manual names.
       --- MINOR NEW FEATURES ---
    * Rudimentary implementation of the e, x, and z tbl(7) layout
      modifiers to equalize, maximize, and ignore the width of columns.
    * Implement font modifiers in tbl(7) layouts.
    * Allow comma-separated options in the tbl(7) options line.
    * Parse and ignore the .pl (page length) roff(7) request.
    * Implement .An -[no]split for the mdoc(7) -Thtml output mode.
    * Support bold italic font in PostScript and PDF output.
    * Warn about commas in function arguments and parentheses in function names.
    * Warn about botched .Xr ordering and punctuation below SEE ALSO.
    * Warn about AUTHORS sections without .An macros.
    * Warn about attempts to call non-callable macros.
    * New developer documentation manual page mandoc_headers(3).
       --- BUGFIXES ---
    * Fix read buffer overrun sometimes triggered by trailing whitespace.
    * Fix read buffer overrun triggered by certain invalid \H sequences.
    * Fix NULL pointer access triggered by .Bl without any arguments.
    * Fix NULL pointer access triggered by .It Nm Fo without .Fc.
    * Fix NULL pointer access triggered by .Sh Xo .Sh without .Xc.
    * Fix NULL pointer access triggered by missing .Nm.
    * Fix an assertion triggered by .It right after .El.
    * Fix an assertion triggered by .Ec without preceding .Eo.
    * Fix an assertion triggered by .Sm or .Db with multiple arguments.
    * Fix assertion failures triggered by very large width arguments.
    * Fix a division by zero in the roff(7) parser.
    * Prevent negative arguments to .ll from causing integer underflow.
    * Correctly autodetect source format even when .Dd is preceded by .ll.
    * Multiple fixes with respect to .Bd and .Bl -offset and -width.
    * Many bugfixes with respect to scaling units.
    * Multiple fixes with respect to delimiter handling by in-line macros.
    * Multiple fixes with respect to .Pf.
    * Make \c work properly in no-fill mode.
    * Stricter syntax checking of Unicode character names.
       --- THANKS TO ---
    * Kristaps Dzonsons for rewriting the eqn(7) parser, implementing
      HTML5 and MathML output, and various other code contributions.
    * Jonathan Gray (OpenBSD) for extensive testing with afl (the
      American Fuzzy Lop security fuzzer) resulting in many bug reports.
    * Anthony Bentley (OpenBSD), Baptiste Daroussin (FreeBSD), Daniel
      Dickman, Doug Hogan, Jason McIntyre, Theo de Raadt (OpenBSD),
      and Martin Natano for source code patches.
    * Carsten Kunze (Heirloom troff), Daniel Levai (Slackware),
      Garrett D'Amore (illumos), Giovanni Becchis, Matthew Dempsky,
      Stuart Henderson, Ted Unangst, Todd Miller (OpenBSD), Thomas
      Klausner (NetBSD), Ulrich Spoerlein (FreeBSD), Justin Haynes,
      Marcus Merighi, Sebastien Marie, Steffen Nurpmeso and Theo Buehler
      for bug reports.
   
 Changes in version 1.13.1, released on August 10, 2014  Changes in version 1.13.1, released on August 10, 2014
   
     --- MAJOR NEW FEATURES ---      --- MAJOR NEW FEATURES ---
  * A complete apropos(1)/makewhatis(8)/man.cgi(8) suite   * A complete apropos(1)/makewhatis(8)/man.cgi(8) suite
    based on SQLite3 is now included.     based on SQLite3 is now included.
    CAVEAT: This also requires a working fts(3) implementation.  
    If your system lacks that *and* you want apropos(1)/makewhatis(8),  
    stay with 1.12.3 for now, then go to 1.12.4 and 1.13.2.  
  * The roff(7) parser now provides an almost complete implementation   * The roff(7) parser now provides an almost complete implementation
    of numerical expressions.     of numerical expressions.
  * Warning and error messages have been improved in many ways.   * Warning and error messages have been improved in many ways.

Legend:
Removed from v.1.5  
changed lines
  Added in v.1.11

CVSweb