version 1.19, 2017/02/12 14:19:01 |
version 1.28, 2018/07/31 10:18:15 |
|
|
$Id$ |
$Id$ |
|
|
This file lists the most important changes in the mdocml.bsd.lv distribution. |
This file lists the most important changes in the mandoc.bsd.lv distribution. |
|
|
Changes in version 1.14.1, released on February XXX, 2017 |
Changes in version 1.14.4, released on August XXX, 2018 |
|
|
--- MAJOR NEW FEATURES --- |
--- MAJOR NEW FEATURES --- |
|
* In ASCII output, render mathematical symbols and greek letters |
|
as transliterations conveying the characters' meanings rather |
|
than trying to imitate their shape. Consequently, such characters |
|
can now be used in portable manual pages. All the same, please |
|
limit their use to contexts where they really matter, for example |
|
when showing complicated mathematical formulae. |
|
* First steps towards better support for small screens in HTML |
|
output (responsive design): avoid most style= attributes, in |
|
particular all hard-coded indentations and column widths, and |
|
provide a better mandoc.css style sheet with a @media query, |
|
using em units throughout, and avoiding redundancy in selectors. |
|
* Better HTML output with some more fitting HTML elements, eliminating |
|
needless class= attributes, and avoiding various HTML syntax errors |
|
(element nesting, URL-fragment syntax, duplicate id= attributes). |
|
--- MINOR NEW FEATURES --- |
|
* When a man(1) argument contains a slash, imply -l like in man-db. |
|
* Use TIOCGWINSZ to reduce the default -Owidth and -Oindent during |
|
interactive use on terminals narrower than 79 columns. |
|
* Generated PostScript files are now more than 50% smaller. |
|
* Terminal rendering of eqn(7) is improved in several respects. |
|
* Simplified and nicer output from the mdoc(7) .Lk macro, formatting |
|
all links in-line, even long ones. |
|
* roff(7) \n+ and \n- numerical register auto-increment and -decrement |
|
* roff(7) .nr optional third argument (auto-increment step size) |
|
--- RELIABILITY BUGFIXES --- |
|
* Only activate UTF-8 output when the user really selected UTF-8, |
|
not some other multibyte character encoding. |
|
* Prevent excessive .ll arguments from generating infinite output. |
|
* Avoid an assertion failure in certain .Bl -column lists. |
|
* Avoid a NULL pointer access on deroff() failure after '.SS ""'. |
|
* Fix a segfault that could be triggered by two invalid .Dt macros. |
|
* Fix two syntax errors in generated PDF files. |
|
* Properly state the page size in generated PostScript files. |
|
* Close a memory leak caused by missing gzclose(3). |
|
* Fix misformatting of man(7) documents lacking .SH macros |
|
in PostScript and PDF output. |
|
* And many minor bugfixes. |
|
--- THANKS TO --- |
|
* Marc Espie (OpenBSD) for implementing the size reduction of |
|
PostScript files, one additional patch for code simplification, |
|
and two bug reports. |
|
* Theo Buehler (OpenBSD) for a bugfix patch, |
|
and Theo de Raadt (OpenBSD) for checking it. |
|
* John Gardner for more than a dozen suggestions regarding HTML output. |
|
* Mike Williams for teaching me how to use %%DocumentMedia and |
|
setpagedevice in PostScript files. |
|
* Werner Lemberg (groff) for feedback on mdoc(7) language changes. |
|
* Colin Watson (man-db) for feedback on man-db semantics. |
|
* Jason McIntyre (OpenBSD) for lots of feedback and suggestions |
|
on diagnostic messages and on the documentation. |
|
* Thomas Klausner (NetBSD) for suggesting two new style messages, |
|
one new feature, and for two bug reports. |
|
* Leah Neukirchen (Void Linux) for suggesting a new style message |
|
and for two bug reports. |
|
* Anthony Bentley (OpenBSD) for reporting multiple bugs and missing |
|
features. |
|
* Paul Irofti (OpenBSD) and Nate Bargmann for suggesting new features. |
|
* Christian Weisgerber, Jonathan Gray, Stuart Henderson, Ted Unangst |
|
(OpenBSD), Takeshi Nakayama (NetBSD), Michael Stapelberg (Debian), |
|
Anton Lazarov, Jakub Klinkovsky, Jan Stary, Jesper Wallin, |
|
Will Backmam, and Wolfgang Mueller for bug reports. |
|
* Sevan Janiyan (NetBSD) for additions to lib.in. |
|
* George Brown for suggesting code simplifications. |
|
* David Coppa, Igor Sobrado (OpenBSD), and Alexander Kuleshov |
|
for documentation improvements. |
|
* Laura Morales and Raf Czlonka for questions resulting in better |
|
documentation. |
|
|
|
Changes in version 1.14.3, released on August 5, 2017 |
|
|
|
--- BUG FIXES --- |
|
* man(7): Do not crash with out-of-bounds read access to a constant |
|
array if .sp or a blank line immediately precedes .SS or .SH. |
|
* mdoc(7): Do not crash with out-of-bounds read access to a constant |
|
array if .sp or a blank line precede the first .Sh macro. |
|
* tbl(7): Ignore explicitly specified negative column widths rather than |
|
wrapping around to huge numbers and risking memory exhaustion. |
|
* man(1): No longer use names that only occur in the SYNOPSIS section. |
|
Gets rid of some surprising behaviour and bogus warnings. |
|
--- THANKS TO --- |
|
Leah Neukirchen (Void Linux), Markus Waldeck (Debian), |
|
Peter Bui (nd.edu), and Yuri Pankov (illumos) for bug reports. |
|
|
|
Changes in version 1.14.2, released on July 28, 2017 |
|
|
|
--- MAJOR NEW FEATURES --- |
|
* New mdoc(7) -Tmarkdown output mode. |
|
* For -Thtml, implement internal hyperlinks pointing to authoritative |
|
definitions of various syntax elements, similar to the ctags(1)-like |
|
less(1) :t internal searching in terminal mode. |
|
* Provide a superset of the functionality of the former mdoclint(1) |
|
utility and a new -Wstyle message level with several new messages, |
|
including validity checking of .Xr cross references. |
|
* tbl(7): Implement automatic line breaking inside individual table |
|
cells, and several other formatting improvements. |
|
* eqn(7): Complete rewrite of the lexer, resulting in several bugfixes. |
|
* Continue parser unification, in particular allowing generation |
|
of syntax tree nodes on the roff(7) level, allowing implementation |
|
of many additional roff requests. |
|
--- REMOVED FUNCTIONALITY --- |
|
* Delete the manpage(1) utility. It was never enabled in any release. |
|
* Delete the -Txhtml command line option. It has been an obsolete |
|
alias for the -Thtml output mode for more than two years. |
|
--- MINOR NEW FEATURES --- |
|
* -Tlint now puts parser messages on stdout instead of stderr, |
|
making commands like "man -l -Tlint *.1" useful. |
|
* mdoc(7): Various .Lk formatting improvements. |
|
* mdoc(7) -Thtml: Better CSS for .Bl lists. |
|
* man(7): Implement the .MT/.ME block macro (mailto hyperlink). |
|
* man(7): Implement the .DT macro (restore default tab positions). |
|
* man(7): Improved support for manuals generated with reStructuredText |
|
by partial support for the \n[an-margin] number register. |
|
* man(7) -Thtml: Support deep linking to .SH and .SS headers. |
|
* tbl(7): Implement the "allbox" table option. |
|
* tbl(7): Implement the column spacing and the 'w' (minimum column |
|
width) layout modifiers. |
|
* tbl(7): Significant improvements of the manual page. |
|
* eqn(7): Much improved font selection, including recognition of |
|
well-known function names, and a few other formatting improvements. |
|
* eqn(7) -Thtml: Use <mn> and <mo> in addition to <mi>. |
|
* roff(7): Implement the .ce (centering), .mc (margin character), |
|
.rj (right justify), .ta (define tab stops), .ti (temporary indent), |
|
.als (macro alias), .ec and .eo (escape character control), |
|
.po (page offset), and .rn (macro rename) requests. |
|
* roff(7) .am: Implement appending to mdoc(7) and man(7) macros. |
|
* roff(7): implement the \h (horizontol motion), \l (horizontal |
|
line drawing), and \p (break output line) escape sequences, |
|
and also several additional character escape sequences. |
|
* roff(7): Implement the 'd' conditional (macro or string defined). |
|
* man.cgi(8) now uses pledge(2), too. |
|
* regress.pl(1): simpler user interface, better summary output, |
|
simpler code, and no more recursion. |
|
--- THANKS TO --- |
|
* Anthony Bentley (OpenBSD) for the implementation of .MT/.ME, |
|
reports of many bugs and missing features, and suggestions |
|
for a number of feature and documentation improvements. |
|
* Sebastien Marie (OpenBSD) for two source code patches and |
|
for some useful discussions. |
|
* Florian Obser (OpenBSD) for a bugfix patch and a bug report. |
|
* Jonathan Gray (OpenBSD) for several bug reports from afl(1) |
|
and several more from static analysis tools. |
|
* Theo Buehler (OpenBSD) for several bug reports, most from afl(1). |
|
* Jason McIntyre (OpenBSD) for many useful discussions about a |
|
wide variety of topics, lots of continuous testing, a number of |
|
bug reports, and some suggestions for messages and documentation. |
|
* Thomas Klausner (NetBSD) for lots of help while migrating |
|
mdoclint(1) functionality to mandoc -Tlint, for suggesting |
|
several useful new messages, and for release testing. |
|
* Reyk Floeter (OpenBSD) and Vsevolod Stakhov (FreeBSD) for |
|
suggesting a markdown output mode. |
|
* Thomas Guettler for suggesting -Thtml internal hyperlinks. |
|
* Yuri Pankov (Illumos) for inspiring new warning messages and |
|
for extensive release testing. |
|
* Anton Lindqvist and TJ Townsend (both OpenBSD) and Jan Stary |
|
for multiple bug reports. |
|
* Leah Neukirchen (Void Linux) for bug reports and release testing. |
|
* Michael Stapelberg (Debian) for suggesting feature improvements |
|
and for release testing. |
|
* Martin Natano and Theo de Raadt (both OpenBSD), Andreas Voegele, |
|
Gabriel Guzman, Gonzalo Tornaria, Markus Waldeck, and Raf Czlonka |
|
for bug reports. |
|
* Antoine Jacoutot (OpenBSD) and Steffen Nurpmeso for suggesting |
|
feature improvements. |
|
* Dag-Erling Smoergrav (FreeBSD) for inspiring new warning messages. |
|
* Ted Unangst and Marc Espie (OpenBSD) for providing useful ideas. |
|
* Svyatoslav Mishyn (Crux Linux) for release testing. |
|
* Carsten Kunze (Heirloom roff) for help keeping mandoc and groff |
|
compatible and for committing some of my patches to groff. |
|
|
|
Changes in version 1.14.1, released on February 21, 2017 |
|
|
|
--- MAJOR NEW FEATURES --- |
* apropos(1): Reimplement complete semantic search functionality |
* apropos(1): Reimplement complete semantic search functionality |
without the dependency on SQLite3, using only POSIX APIs. |
without the dependency on SQLite3, using only POSIX APIs. |
This comes with a completely new mandoc.db(5) file format. |
This comes with a completely new mandoc.db(5) file format. |
Line 32 Changes in version 1.14.1, released on February XXX, 2 |
|
Line 204 Changes in version 1.14.1, released on February XXX, 2 |
|
* mdoc(7): Warn about .Xr lacking the second argument (section). |
* mdoc(7): Warn about .Xr lacking the second argument (section). |
* mdoc(7): Warn about violations of the rule "new sentence, new line". |
* mdoc(7): Warn about violations of the rule "new sentence, new line". |
* roff(7): Warn about trailing whitespace at the end of comments. |
* 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 |
* mdoc(7): Always do text production in the validator, never in the |
formatters. Cleaner, simpler, shorter, helps NetBSD apropos(1) |
formatters. Cleaner, simpler, shorter, helps NetBSD apropos(1) |
and also makes -Ttree output more useful. |
and also makes -Ttree output more useful. |
Line 40 Changes in version 1.14.1, released on February XXX, 2 |
|
Line 213 Changes in version 1.14.1, released on February XXX, 2 |
|
--- RELIABILITY BUGFIXES --- |
--- RELIABILITY BUGFIXES --- |
* man(1): Make "man -l" work with standard input from a pipe or file, |
* man(1): Make "man -l" work with standard input from a pipe or file, |
as long as standard output is a terminal. |
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 |
* mdoc(7): Fix out of bounds read access for .Bl without a type |
but with a width. |
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 -column starting |
Line 65 Changes in version 1.14.1, released on February XXX, 2 |
|
Line 240 Changes in version 1.14.1, released on February XXX, 2 |
|
for empty matrices and empty square roots. |
for empty matrices and empty square roots. |
* mdoc(7): Fix an assertion failure for a .Bd without a type that |
* mdoc(7): Fix an assertion failure for a .Bd without a type that |
breaks another block. |
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 |
* mdoc(7): Fix an assertion failure caused by .Bl -column without .It |
but containing eqn(7) or tbl(7) code. |
but containing eqn(7) or tbl(7) code. |
* roff(7): Fix an assertion failure caused by \z\[u00FF] with -Tps/-Tpdf. |
* roff(7): Fix an assertion failure caused by \z\[u00FF] with -Tps/-Tpdf. |
Line 76 Changes in version 1.14.1, released on February XXX, 2 |
|
Line 253 Changes in version 1.14.1, released on February XXX, 2 |
|
* man(1): Do not mix stdio narrow and wide stream orientation |
* man(1): Do not mix stdio narrow and wide stream orientation |
on stdout, which could cause output corruption on glibc. |
on stdout, which could cause output corruption on glibc. |
* mandoc(1): Autodetect a suitable locale for -Tutf8 mode. |
* mandoc(1): Autodetect a suitable locale for -Tutf8 mode. |
* Autodetect whether PATH_MAX is defined. |
* ./configure: Autodetect whether PATH_MAX and O_DIRECTORY are defined. |
* Autodetect if nanosleep(3) needs -lrt. |
* ./configure: Autodetect if nanosleep(3) needs -lrt. |
* Put compiler arguments that may contain -l at the end. |
* ./configure: Provide an ${LN} configuration variable. |
|
* ./configure: Put compiler arguments that may contain -l at the end. |
--- MINOR BUGFIXES --- |
--- MINOR BUGFIXES --- |
* mdoc(7): Fix SYNOPSIS output if the first child of .Nm is a macro. |
* 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. |
* mdoc(7) -Thtml: Improve formatting of .Bl -tag with short tags. |
Line 89 Changes in version 1.14.1, released on February XXX, 2 |
|
Line 267 Changes in version 1.14.1, released on February XXX, 2 |
|
easier to use and reducing the amount of code by a few hundred lines. |
easier to use and reducing the amount of code by a few hundred lines. |
--- THANKS TO --- |
--- THANKS TO --- |
* Michael Stapelberg (Debian) for designing the new mandocd(8) |
* Michael Stapelberg (Debian) for designing the new mandocd(8) |
and parts of the new catman(8), and for a number of patches |
and parts of the new catman(8), for release testing, and for a |
and bug reports. |
number of patches and bug reports. |
* Baptiste Daroussin (FreeBSD) for profiling the new makewhatis(8) |
* Baptiste Daroussin (FreeBSD) for profiling the new makewhatis(8) |
implementation and suggesting an algorithmic improvement which |
implementation and suggesting an algorithmic improvement which |
more than doubled performance, and for a few bug reports. |
more than doubled performance, and for a few bug reports. |
* Ed Maste (FreeBSD) for an important patch improving reproducibility |
* Ed Maste (FreeBSD) for an important patch improving reproducibility |
of builds in makewhatis(8), and for a few bug reports. |
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. |
most of them found by systematic afl(1) fuzzing. |
* Benny Lofgren, David Dahlberg, and in particular Vadim Zhukov |
* Benny Lofgren, David Dahlberg, and in particular Vadim Zhukov |
for crucial help in getting .Bl -tag CSS formatting fixed. |
for crucial help in getting .Bl -tag CSS formatting fixed. |
* Svyatoslav Mishyn (Crux Linux) for an initial version of the |
* 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 |
* Jason McIntyre (OpenBSD) for multiple useful discussions |
and a number of bug reports. |
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, |
* Alexander Bluhm, Andrew Fresh, Antoine Jacoutot, Antony Bentley, |
Christian Weisgerber, Jonathan Gray, Marc Espie, Martijn van Duren, |
Christian Weisgerber, Jonathan Gray, Marc Espie, Martijn van Duren, |
Stuart Henderson, Ted Unangst, Theo de Raadt (OpenBSD), Abhinav |
Stuart Henderson, Ted Unangst, Theo de Raadt (OpenBSD), Abhinav |
Upadhyay, Christos Zoulas, Kamil Rytarowski, Sevan Janiyan, |
Upadhyay, Kamil Rytarowski (NetBSD), Aaron M. Ucko, Bdale Garbee, |
Thomas Klausner (NetBSD), Aaron M. Ucko, Bdale Garbee, Reiner |
Reiner Herrmann, Shane Kerr (Debian), Daniel Sabogal (Alpine Linux), |
Herrmann, Shane Kerr (Debian), Leah Neukirchen (Void Linux), |
|
Daniel Sabogal (Alpine Linux), Yuri Pankov (illumos), |
|
Carsten Kunze (Heirloom roff), Kristaps Dzonsons (bsd.lv), |
Carsten Kunze (Heirloom roff), Kristaps Dzonsons (bsd.lv), |
Anton Lindqvist, Jan Stary, Jeremy A. Mates, Mark Patruck, |
Anton Lindqvist, Jan Stary, Jeremy A. Mates, Mark Patruck, |
Pavan Maddamsetti, Sean Levy <attila@stalphonsos.com>, and |
Pavan Maddamsetti, Sean Levy <attila@stalphonsos.com>, and |
Line 264 Changes in version 1.13.3, released on March 13, 2015 |
|
Line 446 Changes in version 1.13.3, released on March 13, 2015 |
|
* New -Wunsupp message level. |
* New -Wunsupp message level. |
--- POTENTIONALLY SECURITY RELEVANT BUGFIXES --- |
--- POTENTIONALLY SECURITY RELEVANT BUGFIXES --- |
* Fix a potential write buffer overrun on incomplete string conditionals. |
* Fix a potential write buffer overrun on incomplete string conditionals. |
http://mdocml.bsd.lv/cgi-bin/cvsweb/roff.c#rev1.241 |
http://mandoc.bsd.lv/cgi-bin/cvsweb/roff.c#rev1.241 |
* Fix a potential write buffer overrun on backslash at EOF in a conditional. |
* Fix a potential write buffer overrun on backslash at EOF in a conditional. |
http://mdocml.bsd.lv/cgi-bin/cvsweb/roff.c#rev1.247 |
http://mandoc.bsd.lv/cgi-bin/cvsweb/roff.c#rev1.247 |
* Fix a use after free sometimes hit when validation deletes a block. |
* Fix a use after free sometimes hit when validation deletes a block. |
http://mdocml.bsd.lv/cgi-bin/cvsweb/mdoc_macro.c#rev1.180 |
http://mandoc.bsd.lv/cgi-bin/cvsweb/mdoc_macro.c#rev1.180 |
--- MAJOR FUNCTIONALLY RELEVANT BUGFIXES --- |
--- MAJOR FUNCTIONALLY RELEVANT BUGFIXES --- |
* Let man(1) show manuals for the current architecture by default, |
* Let man(1) show manuals for the current architecture by default, |
and support the MACHINE environment variable. |
and support the MACHINE environment variable. |
Line 879 Changes in version 1.9.15, released on February 18, 20 |
|
Line 1061 Changes in version 1.9.15, released on February 18, 20 |
|
* and column lengths handled correctly. |
* and column lengths handled correctly. |
|
|
For older releases, see the ChangeLog files |
For older releases, see the ChangeLog files |
in http://mdocml.bsd.lv/snapshots/ . |
in http://mandoc.bsd.lv/snapshots/ . |