Document that -T markdown produces ASCII output, and the implied

[mandoc.git] / NEWS

diff --git a/NEWS b/NEWS
index d2084a215f7860ceebd8af61e268309c1ea461f4..0a71d6e27cf1cc864664254938056f0f6a87518a 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -1,8 +1,8 @@
-$Id: NEWS,v 1.16 2017/02/10 16:20:34 schwarze Exp $
+$Id: NEWS,v 1.21 2017/02/21 00:37:03 schwarze Exp $

 
 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.14.1, released on February XXX, 2017
+Changes in version 1.14.1, released on February 21, 2017

 
     --- MAJOR NEW FEATURES ---
  * apropos(1): Reimplement complete semantic search functionality
 
     --- MAJOR NEW FEATURES ---
  * apropos(1): Reimplement complete semantic search functionality


@@ -32,6 +32,7 @@ Changes in version 1.14.1, released on February XXX, 2017
  * mdoc(7): Warn about .Xr lacking the second argument (section).
  * mdoc(7): Warn about violations of the rule "new sentence, new line".
  * roff(7): Warn about trailing whitespace at the end of comments.
  * mdoc(7): Warn about .Xr lacking the second argument (section).
  * mdoc(7): Warn about violations of the rule "new sentence, new line".
  * roff(7): Warn about trailing whitespace at the end of comments.

+ * mdoc(7): Improve rendering of double quotes.

  * mdoc(7): Always do text production in the validator, never in the
    formatters.  Cleaner, simpler, shorter, helps NetBSD apropos(1)
    and also makes -Ttree output more useful.
  * mdoc(7): Always do text production in the validator, never in the
    formatters.  Cleaner, simpler, shorter, helps NetBSD apropos(1)
    and also makes -Ttree output more useful.


@@ -40,6 +41,8 @@ Changes in version 1.14.1, released on February XXX, 2017
     --- RELIABILITY BUGFIXES ---
  * man(1): Make "man -l" work with standard input from a pipe or file,
    as long as standard output is a terminal.
     --- RELIABILITY BUGFIXES ---
  * man(1): Make "man -l" work with standard input from a pipe or file,
    as long as standard output is a terminal.

+ * man(7): Fix out of bounds read access if a text node immediately
+   preceded the first .SH header.

  * mdoc(7): Fix out of bounds read access for .Bl without a type
    but with a width.
  * mdoc(7): Fix out of bounds read access for .Bl -column starting
  * mdoc(7): Fix out of bounds read access for .Bl without a type
    but with a width.
  * mdoc(7): Fix out of bounds read access for .Bl -column starting


@@ -48,17 +51,25 @@ Changes in version 1.14.1, released on February XXX, 2017
    by stray block end macros in nested blocks of mismatching type.
  * man(1): Fix NULL dereference when the first of multiple pages
    shown was preformatted.
    by stray block end macros in nested blocks of mismatching type.
  * man(1): Fix NULL dereference when the first of multiple pages
    shown was preformatted.

+ * mdoc(7): Fix syntax tree corruption leading to NULL dereference
+   caused by partial implicit macros inside .Bl -column table cells.

  * mdoc(7): Fix syntax tree corruption leading to NULL dereference
    for macro sequences like .Bl .Bl .It Bo .El .It.
  * mdoc(7): Fix syntax tree corruption leading to NULL dereference
    caused by .Ta following a nested .Bl -column breaking another block.
  * mdoc(7): Fix syntax tree corruption sometimes leading to NULL
  * mdoc(7): Fix syntax tree corruption leading to NULL dereference
    for macro sequences like .Bl .Bl .It Bo .El .It.
  * mdoc(7): Fix syntax tree corruption leading to NULL dereference
    caused by .Ta following a nested .Bl -column breaking another block.
  * mdoc(7): Fix syntax tree corruption sometimes leading to NULL

-   dereference caused by indirectly broken .Nm blocks in the SYNOPSIS.
+   dereference caused by indirectly broken .Nd or .Nm blocks.

  * mdoc(7) -Thtml: Fix a NULL dereference for .Bl -column with 0 columns.
  * mdoc(7) -Thtml: Fix a NULL dereference for .Bl -column with 0 columns.

+ * mdoc(7): Fix NULL dereference in some specific cases of a
+   block-end macro calling another block-end macro.

  * mdoc(7): Fix NULL dereference if the only child of the head
    of the first .Sh was an empty in-line macro.
  * mdoc(7): Fix NULL dereference if the only child of the head
    of the first .Sh was an empty in-line macro.

+ * eqn(7): Fix NULL dereference in the terminal formatter
+   for empty matrices and empty square roots.

  * mdoc(7): Fix an assertion failure for a .Bd without a type that
    breaks another block.
  * mdoc(7): Fix an assertion failure for a .Bd without a type that
    breaks another block.

+ * mdoc(7): Fix an assertion failure that happened for some .Bl -column
+   lists containing a column width of "-4n", "-3n", or "-2n".

  * mdoc(7): Fix an assertion failure caused by .Bl -column without .It
    but containing eqn(7) or tbl(7) code.
  * roff(7): Fix an assertion failure caused by \z\[u00FF] with -Tps/-Tpdf.
  * mdoc(7): Fix an assertion failure caused by .Bl -column without .It
    but containing eqn(7) or tbl(7) code.
  * roff(7): Fix an assertion failure caused by \z\[u00FF] with -Tps/-Tpdf.


@@ -70,9 +81,10 @@ Changes in version 1.14.1, released on February XXX, 2017
  * man(1): Do not mix stdio narrow and wide stream orientation
    on stdout, which could cause output corruption on glibc.
  * mandoc(1): Autodetect a suitable locale for -Tutf8 mode.
  * man(1): Do not mix stdio narrow and wide stream orientation
    on stdout, which could cause output corruption on glibc.
  * mandoc(1): Autodetect a suitable locale for -Tutf8 mode.

- * Autodetect whether PATH_MAX is defined.
- * Autodetect if nanosleep(3) needs -lrt.
- * Put compiler arguments that may contain -l at the end.
+ * ./configure: Autodetect whether PATH_MAX and O_DIRECTORY are defined.
+ * ./configure: Autodetect if nanosleep(3) needs -lrt.
+ * ./configure: Provide an ${LN} configuration variable.
+ * ./configure: Put compiler arguments that may contain -l at the end.

     --- MINOR BUGFIXES ---
  * mdoc(7): Fix SYNOPSIS output if the first child of .Nm is a macro.
  * mdoc(7) -Thtml: Improve formatting of .Bl -tag with short tags.
     --- MINOR BUGFIXES ---
  * mdoc(7): Fix SYNOPSIS output if the first child of .Nm is a macro.
  * mdoc(7) -Thtml: Improve formatting of .Bl -tag with short tags.


@@ -83,28 +95,32 @@ Changes in version 1.14.1, released on February XXX, 2017
    easier to use and reducing the amount of code by a few hundred lines.
     --- THANKS TO ---
  * Michael Stapelberg (Debian) for designing the new mandocd(8)
    easier to use and reducing the amount of code by a few hundred lines.
     --- THANKS TO ---
  * Michael Stapelberg (Debian) for designing the new mandocd(8)

-   and parts of the new catman(8), and for a number of patches
-   and bug reports.
+   and parts of the new catman(8), for release testing, and for a
+   number of patches and bug reports.

  * Baptiste Daroussin (FreeBSD) for profiling the new makewhatis(8)
    implementation and suggesting an algorithmic improvement which
    more than doubled performance, and for a few bug reports.
  * Ed Maste (FreeBSD) for an important patch improving reproducibility
    of builds in makewhatis(8), and for a few bug reports.
  * Baptiste Daroussin (FreeBSD) for profiling the new makewhatis(8)
    implementation and suggesting an algorithmic improvement which
    more than doubled performance, and for a few bug reports.
  * Ed Maste (FreeBSD) for an important patch improving reproducibility
    of builds in makewhatis(8), and for a few bug reports.

- * Theo Buehler (OpenBSD) for more than ten important bug reports,
+ * Theo Buehler (OpenBSD) for almost twenty important bug reports,

    most of them found by systematic afl(1) fuzzing.
  * Benny Lofgren, David Dahlberg, and in particular Vadim Zhukov
    for crucial help in getting .Bl -tag CSS formatting fixed.
  * Svyatoslav Mishyn (Crux Linux) for an initial version of the
    most of them found by systematic afl(1) fuzzing.
  * Benny Lofgren, David Dahlberg, and in particular Vadim Zhukov
    for crucial help in getting .Bl -tag CSS formatting fixed.
  * Svyatoslav Mishyn (Crux Linux) for an initial version of the

-   patch to autodetect a suitable locale for -Tutf8 mode.
+   patch to autodetect a suitable locale for -Tutf8 mode
+   and for release testing.

  * Jason McIntyre (OpenBSD) for multiple useful discussions
    and a number of bug reports.
  * Jason McIntyre (OpenBSD) for multiple useful discussions
    and a number of bug reports.

+ * Sevan Janiyan (NetBSD) for extensive release testing and multiple
+   bug reports.
+ * Thomas Klausner and Christos Zoulas (NetBSD), Yuri Pankov (illumos),
+   and Leah Neukirchen (Void Linux) for release testing and bug reports.
+ * Ulrich Spoerlein (FreeBSD) for release testing.

  * Alexander Bluhm, Andrew Fresh, Antoine Jacoutot, Antony Bentley,
    Christian Weisgerber, Jonathan Gray, Marc Espie, Martijn van Duren,
    Stuart Henderson, Ted Unangst, Theo de Raadt (OpenBSD), Abhinav
  * Alexander Bluhm, Andrew Fresh, Antoine Jacoutot, Antony Bentley,
    Christian Weisgerber, Jonathan Gray, Marc Espie, Martijn van Duren,
    Stuart Henderson, Ted Unangst, Theo de Raadt (OpenBSD), Abhinav

-   Upadhyay, Christos Zoulas, Kamil Rytarowski, Sevan Janiyan,
-   Thomas Klausner (NetBSD), Aaron M. Ucko, Bdale Garbee, Reiner
-   Herrmann, Shane Kerr (Debian), Leah Neukirchen (Void Linux),
-   Daniel Sabogal (Alpine Linux), Yuri Pankov (illumos),
+   Upadhyay, Kamil Rytarowski (NetBSD), Aaron M. Ucko, Bdale Garbee,
+   Reiner Herrmann, Shane Kerr (Debian), Daniel Sabogal (Alpine Linux),

    Carsten Kunze (Heirloom roff), Kristaps Dzonsons (bsd.lv),
    Anton Lindqvist, Jan Stary, Jeremy A. Mates, Mark Patruck,
    Pavan Maddamsetti, Sean Levy <attila@stalphonsos.com>, and
    Carsten Kunze (Heirloom roff), Kristaps Dzonsons (bsd.lv),
    Anton Lindqvist, Jan Stary, Jeremy A. Mates, Mark Patruck,
    Pavan Maddamsetti, Sean Levy <attila@stalphonsos.com>, and