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

Diff for /mandoc/NEWS between version 1.1 and 1.10

version 1.1, 2013/10/01 00:24:00 version 1.10, 2015/11/05 16:58:20
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.12.2, released on Oktober 1, 2013  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
   
       --- MAJOR NEW FEATURES ---
    * A complete apropos(1)/makewhatis(8)/man.cgi(8) suite
      based on SQLite3 is now included.
    * The roff(7) parser now provides an almost complete implementation
      of numerical expressions.
    * Warning and error messages have been improved in many ways.
      Almost all fatal errors were downgraded to normal errors and some
      even to warnings.  Almost all messages now mention the macro where
      the issue is detected and many indicate the workaround employed.
      The mandoc(1) manual now includes a list explaining all messages.
       --- MINOR NEW FEATURES ---
    * The roff(7) parser now supports the .ami (append to macro with
      indirectly specified name), .as (append to user-defined
      string), .dei (define macro with indirectly specified name),
      .ll (line length), and .rr (remove register) requests.
    * The roff(7) parser now supports string comparison and numerical
      conditionals in the .if and .ie requests.
    * The roff parser now fully supports the \B (validate numerical
      expression) and partially supports the \w (measure text width)
      escape sequences.
    * The terminal formatter now supports the \: (optional line break)
      escape sequence.
    * The roff parser now supports expansion of user-defined strings
      involving indirect references.
    * The roff(7) parser now handles some pre-defined read-only
      number registers that occur in the pod2man(1) preamble.
    * For backward compatibility, the mdoc(7) parser and formatters
      now support the obsolete macros .En, .Es, .Fr, and .Ot.
    * The mdoc(7) formatter non partially supports .Bd -centered.
    * tbl(7) now handles leading and trailing vertical lines.
    * The build system now provides fallback versions of strcasestr(3)
      and strsep(3) for systems lacking them.
    * The mdoc(7) manual now explains how various standards
      supported by the .St macro are related to each other.
       --- BUGFIXES ---
    * In the roff(7) parser, several bugs were fixed with respect
      to closing conditional blocks on macro lines.
    * Parsing of roff(7) identifiers and escape sequences was improved
      in multiple respects.
    * In the mdoc(7) parser, the handling of defective document
      prologues was improved in multiple ways.
    * The mdoc(7) parser no longer skips content before the first section
      header, and it no longer deletes non-.% content from .Rs blocks.
    * In the mdoc(7) parser, a crash was fixed related to weird .Sh headers.
    * In the mdoc(7) parser, handling of .Sm with missing or invalid
      arguments was corrected.
    * In the mdoc(7) parser, trailing punctuation at the end of partial
      implicit macros no longer triggers end-of-sentence spacing.
    * In the terminal formatter, two crashes were fixed: one triggered by
      excessive indentation and another by excessively long .Nm arguments.
    * In the terminal formatter, a floating point rounding bug was
      fixed that sometimes caused an off-by-one error in indentation.
    * In the UTF-8 formatter, rendering of accents, breakable hyphens,
      and non-breakable spaces was corrected.
    * In the HTML formatter, encoding of special characters was
      corrected in multiple respects.
    * In the mdoc(7) formatter, rendering of .Ex and .Rv was
      improved for various edge cases.
    * In the mdoc(7) formatter, handling of empty .Bl -inset item
      heads was improved.
    * In the man(7) formatter, some bugs were fixed with respect
      to same-line detection in the context of .TP and .nf macros,
      and the indentation of .IP and .TP blocks was improved.
    * The mandoc(3) library no longer prints to stderr.
       --- THANKS TO ---
      Abhinav Upadhyay (NetBSD), Andreas Voegele, Anthony Bentley (OpenBSD),
      Christian Weisgerber (OpenBSD), Havard Eidnes (NetBSD), Jan Stary,
      Jason McIntyre (OpenBSD), Jeremie Courreges-Anglas (OpenBSD),
      Joerg Sonnenberger (NetBSD), Juan Francisco Cantero Hurtado (OpenBSD),
      Marc Espie (OpenBSD), Matthias Scheler (NetBSD), Pascal Stumpf (OpenBSD),
      Paul Onyschuk (Alpine Linux), Sebastien Marie, Steffen Nurpmeso,
      Stuart Henderson (OpenBSD), Ted Unangst (OpenBSD), Theo de Raadt (OpenBSD),
      Thomas Klausner (NetBSD), and Ulrich Spoerlein (FreeBSD)
      for reporting bugs and missing features.
   
   Changes in version 1.12.3, released on December 31, 2013
   
    * In the mdoc(7) SYNOPSIS, line breaks and hanging indentation
      now work correctly for .Fo/.Fa/.Fc and .Fn blocks.
      Thanks to Franco Fichtner for doing part of the work.
    * The mdoc(7) .Bk macro got some addititonal bugfixes.
    * In mdoc(7) macro arguments, double quotes can now be quoted
      by doubling them, just like in man(7).
      Thanks to Tsugutomo ENAMI for the patch.
    * At the end of man(7) macro lines, end-of-sentence spacing
      now works.  Thanks to Franco Fichtner for the patch.
    * For backward compatibility, the man(7) parser now supports the
      man-ext .UR/.UE (uniform resource identifier) block macros.
    * The man(7) parser now handles closing blocks that are not open
      more gracefully.
    * The man(7) parser now ignores blank lines right after .SH and .SS.
    * In the man(7) formatter, reset indentation when leaving a block,
      not just when entering the next one.
    * The roff(7) .nr request now supports incrementing and decrementing
      number registers and stops parsing the number right before the
      first non-digit character.
    * The roff(7) parser now supports the alternative escape sequence
      syntax \C'uXXXX' for Unicode characters.
    * The roff(7) parser now parses and ignores the .fam (font family)
      and .hw (hyphenation points) requests and the \d and \u escape
      sequences.
    * The roff(7) manual got a new ESCAPE SEQUENCE REFERENCE.
   
   Changes in version 1.12.2, released on Oktober 5, 2013
   
  * The mdoc(7) to man(7) converter, to be called as mandoc -Tman,   * The mdoc(7) to man(7) converter, to be called as mandoc -Tman,
    is now fully functional.     is now fully functional.
  * The mandoc(1) utility now supports the -Ios (default operating system)   * The mandoc(1) utility now supports the -Ios (default operating system)
Line 31  Changes in version 1.12.2, released on Oktober 1, 2013
Line 320  Changes in version 1.12.2, released on Oktober 1, 2013
  * For mandoc developers, we now provide a tbl(3) library manual and   * For mandoc developers, we now provide a tbl(3) library manual and
    gmdiff, a very small, very simplistic groff-versus-mandoc output     gmdiff, a very small, very simplistic groff-versus-mandoc output
    comparison tool.     comparison tool.
    * Provide this NEWS file.
   
 Changes in version 1.12.1, released on March 23, 2012  Changes in version 1.12.1, released on March 23, 2012
   
Line 129  Changes in version 1.11.1, released on April 4, 2011
Line 419  Changes in version 1.11.1, released on April 4, 2011
  * The earlier libroff, libmdoc, and libman soup have been merged into   * The earlier libroff, libmdoc, and libman soup have been merged into
    a single library, libmandoc, which manages all aspects of parsing     a single library, libmandoc, which manages all aspects of parsing
    real manuals, from line-handling to tbl(7) parsing.     real manuals, from line-handling to tbl(7) parsing.
  * Beyond this structural change, initial eqn(7) functionality is in  
    place.  For the time being, this is limited to the recognition of  
    equation blocks; future version of mdocml will expand upon this  
    framework.  
  * As usual, many general fixes and improvements have also occurred.   * As usual, many general fixes and improvements have also occurred.
    In particular, a great deal of redundancy and superfluous code has     In particular, a great deal of redundancy and superfluous code has
    been removed with the merging of the backend libraries.     been removed with the merging of the backend libraries.
    * see also the changes in 1.10.10
   
   Changes in version 1.10.10, March 20, 2011, NOT released
   
    * Initial eqn(7) functionality is in place.  For the time being,
      this is limited to the recognition of equation blocks;
      future version of mdocml will expand upon this framework.
   
 Changes in version 1.10.9, released on January 7, 2011  Changes in version 1.10.9, released on January 7, 2011
   
  * Many back-end fixes have been implemented: argument handling (quoting),   * Many back-end fixes have been implemented: argument handling (quoting),
Line 149  Changes in version 1.10.9, released on January 7, 2011
Line 442  Changes in version 1.10.9, released on January 7, 2011
   
 Changes in version 1.10.8, released on December 24, 2010  Changes in version 1.10.8, released on December 24, 2010
   
  * Significant improvements merged from OpenBSD downstream, including   * Overhauled the -Thtml and -Txhtml output modes.  They now display
     - many new roff(7) components,  
     - in-line implementation of troff's soelim(1),  
     - broken-block handling,  
     - overhauled error classifications, and  
     - cleaned up handling of error conditions.  
  * Also overhauled the -Thtml and -Txhtml output modes.  They now display  
    readable output in arbitrary browsers, including text-based ones like     readable output in arbitrary browsers, including text-based ones like
    lynx(1).  See HTML and XHTML manuals in the DOCUMENTATION section     lynx(1).  See HTML and XHTML manuals in the DOCUMENTATION section
    for examples.  Attention: available style-sheet classes have been     for examples.  Attention: available style-sheet classes have been
    considerably changed!  See the example.style.css file for details.     considerably changed!  See the example.style.css file for details.
    Lastly, libmdoc and libman have been cleaned up and reduced in size     Lastly, libmdoc and libman have been cleaned up and reduced in size
    and complexity.     and complexity.
    * see also the changes in 1.10.7
   
   Changes in version 1.10.7, December 6, 2010, NOT released
   
    Significant improvements merged from OpenBSD downstream, including:
    * many new roff(7) components,
    * in-line implementation of troff's soelim(1),
    * broken-block handling,
    * overhauled error classifications, and
    * cleaned up handling of error conditions.
   
 Changes in version 1.10.6, released on September 27, 2010  Changes in version 1.10.6, released on September 27, 2010
   
  * Calling conventions for mandoc(1) have changed: -W improved and -f   * Calling conventions for mandoc(1) have changed: -W improved and -f
Line 193  Changes in version 1.10.4, released on July 12, 2010
Line 490  Changes in version 1.10.4, released on July 12, 2010
  * Lots of features developed during both "Summer of Code" and the   * Lots of features developed during both "Summer of Code" and the
    OpenBSD c2k10 hackathon:     OpenBSD c2k10 hackathon:
  * minimal "ds" roff(7) symbols are supported   * minimal "ds" roff(7) symbols are supported
  * "Bk" mdoc(7) support  
  * beautified SYNOPSIS section output   * beautified SYNOPSIS section output
  * variable font-width and paper-size support in mandoc(1) -Tps output  
  * acceptance of scope-block breakage in mdoc(7)   * acceptance of scope-block breakage in mdoc(7)
  * clarify error message status   * clarify error message status
  * many minor bug-fixes and formatting issues resolved   * many minor bug-fixes and formatting issues resolved
    * see also changes in 1.10.3
   
   Changes in version 1.10.3, June 29, 2010, NOT released
   
    * variable font-width and paper-size support in mandoc(1) -Tps output
    * "Bk" mdoc(7) support
   
 Changes in version 1.10.2, released on June 19, 2010  Changes in version 1.10.2, released on June 19, 2010
   

Legend:
Removed from v.1.1  
changed lines
  Added in v.1.10

CVSweb