version 1.22, 2017/06/23 15:58:14 |
version 1.28, 2018/07/31 10:18:15 |
|
|
|
|
This file lists the most important changes in the mandoc.bsd.lv distribution. |
This file lists the most important changes in the mandoc.bsd.lv distribution. |
|
|
|
Changes in version 1.14.4, released on August XXX, 2018 |
|
|
|
--- 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 |
Changes in version 1.14.1, released on February 21, 2017 |
|
|
--- MAJOR NEW FEATURES --- |
--- MAJOR NEW FEATURES --- |