Annotation of mandoc/NEWS, Revision 1.40
1.40 ! schwarze 1: $Id: NEWS,v 1.39 2021/09/23 17:12:00 schwarze Exp $
1.1 schwarze 2:
1.22 schwarze 3: This file lists the most important changes in the mandoc.bsd.lv distribution.
1.35 schwarze 4:
1.40 ! schwarze 5: Changes in version 1.14.6, released on September 23, 2021
1.35 schwarze 6:
7: --- MAJOR NEW FEATURES ---
1.36 schwarze 8: * mdoc(7): automatic tagging improved in many respects
9: * mdoc(7): new .Tg (tag) macro to explicitly mark a place as defining a term
10: * man(7): implement some automatic tagging support
11: * man(1): let -w without argument show the manpath, like in man-db and man-1.6
12: * -T html: wrap text and phrasing elements in paragraphs unless already
13: contained in flow containers; never put them directly into sections.
14: This helps to format paragraphs with the CSS class selector .Pp.
15: * man.conf(5): remove support for the "_whatdb" configuration directive
16: that was deprecated in 2015; please use "manpath" instead
1.35 schwarze 17: --- MINOR NEW FEATURES ---
1.36 schwarze 18: * man(1): switch the default pager from "more -s" to "less"
19: * man(1): in the fallback code to look for manual pages without using
20: mandoc.db(5), accept files "man<one-digit-section>/<name>.<full-section>"
21: in addition to the already supported "man<full-section>/name.[01-9]*"
22: * if messages are shown and output is printed without a pager, display
23: a heads-up on stderr at the end because otherwise, users may easily
24: miss the messages
25: * man.cgi(8): add a Content-Security-Policy HTTP header
26: * man.cgi(8): switch off autocomplete and autocapitalize
27: * mandoc.css: support prefers-color-scheme: dark
28: * -T html: add meta viewport element to help mobile devices
29: * -T html -O tag: let this pass a file:// URI to the pager
30: * tbl(7): implement the "nospaces" option
31: * tbl(7) -T html: implement the "a" (em indent) layout specification
32: * tbl(7) -T html: implement the "b" (bold) and "i" (italic) layout modifiers
33: * tbl(7): support two-character font names in the layout font modifier
34: * tbl(7) -T html: support horinzontal rulers in individual cells
35: * tbl(7) -T tree: print more details about columns, options, rows, and cells
1.35 schwarze 36: * roff(7): implement the .break request (break out of a .while loop)
1.36 schwarze 37: * roff(7): support the CB and CI fonts in \f and .ft
38: * -T lint: new STYLE message if a file name extension contradicts .Dt/.TH
39: * -T lint: new STYLE message about overlong text lines
40: * -W style: check .Xr links along the full manpath
1.35 schwarze 41: --- RELIABILITY BUGFIXES ---
42: * man(1): do not segfault if /tmp/ is not writeable
1.36 schwarze 43: * man(1): do not access a NULL pointer when both -l and -w are given
44: * makewhatis(8): do not crash when a manpath directory contains
45: a symbolic link that points to a directory
46: * man(7): fix an assertion failure caused by doubly nested next-line scopes
1.35 schwarze 47: * tbl(7): fix a crash when the last column is only reached by spans
1.36 schwarze 48: * tbl(7): fix a NULL pointer access in some cases of two spans on one row
1.35 schwarze 49: * tbl(7) -T ascii: fix a NULL pointer access on empty data cells
50: * tbl(7) -T ascii: fix a NULL pointer access on a line next to a short row
1.36 schwarze 51: * tbl(7): fix an assertion failure caused by excessive spacing modifiers
52: * tbl(7): fix an infinite loop for some overlapping horizontal spans
53: * roff(7): fix a rare case of writing one byte past the end of the input buffer
54: * roff(7): do not call abort(3) when \*[.T] is encountered
55: * roff(7): fix an assertion failure caused by a macro inside .ce .if
56: * roff(7): fix assertion failures for .ti and .po with excessive arguments
57: * roff(7): avoid near-infinte output for .ce inside explicit no-fill mode
58: * -T ascii/utf8: fix assertion failures caused by excessive spacing
1.35 schwarze 59: * -T html: fix an assertion failure caused by .ft in rare situations
1.36 schwarze 60: * -T man: fix an assertion failure caused by tbl(7) and eqn(7) input
61: --- PORTABILITY IMPROVEMENTS ---
62: * rename HOMEBREWDIR to READ_ALLOWED_PATH, allow it to contain more than
63: one directory, and explain how to use that for NixOS and GNU Guix Linux
64: * configure: stop trying to ask make(1) what the default compiler is
65: because that test was too fragile; just use "cc" by default
66: * configure: various simplifications and improved robustness
67: * configure: only compile compat_*.c implementations that are needed
1.38 schwarze 68: * configure: provide feature tests for __attribute__(()) and mkstemps(3)
1.36 schwarze 69: * compat_*: sync with upstreams for security, functionality, and style
1.38 schwarze 70: * in regress.pl, avoid the non-portable options sed(1) -i and echo(1) -n
1.36 schwarze 71: * in the regression suite, avoid file names that differ only by case
1.35 schwarze 72: --- MINOR FUNCTIONAL IMPROVEMENTS ---
73: * man(1) -h: for pages lacking a SYNOPSIS, show the NAME section
74: * man(1): when the first argument starts with a digit, optionally
75: followed by a letter, and at least one more argument follows,
76: interpret the first argument as a section name even when additional
77: characters follow after the digit and letter
78: * man(1): with a specific section requested, try harder to find
79: the best match; use this order of preference:
80: 1. The section in both the directory name and the file name matches exactly.
81: 2. The section in the file name matches exactly.
82: 3. The section in the directory name matches exactly.
83: 4. Neither of them matches exactly.
1.36 schwarze 84: * man(1): if no tags were generated at all, unlink(2) the empty tags file
85: as soon as the condition can be detected and do not pass it to less(1)
1.35 schwarze 86: * makewhatis(8): handle both dangling symlinks and .so links
87: in manual page directories more gracefully
88: * man.cgi(8): for invalid queries and for valid queries returning
89: no result, return the appropriate 40x status code rather than 200
1.36 schwarze 90: * mdoc(7): let .Dd concatenate all arguments and default to the empty string
91: * mdoc(7): convert ".Fl Fl" to ".Fl \-" during validation, improving -T html
92: * mdoc(7): improve output of .At 32v
93: * man(7): no longer print multiple blank lines before NAME and page footer
1.35 schwarze 94: * tbl(7) -T utf8: improved rendering of horizontal lines
1.36 schwarze 95: * tbl(7) -T html: in "n" cells, align by padding numbers on the right
96: * tbl(7): no longer leak tabulator settings to subsequent roff(7) code
97: * mdoc(7) -T html: for .Bl -tag, use "column-count: 1" rather
98: than "overflow: auto" to avoid the ugly side effects
99: * mdoc(7) -T html: render .Bd -unfilled in proportionally-spaced font
1.35 schwarze 100: * mdoc(7) -T html: format .Nd with <span> rather than <div>
1.36 schwarze 101: * mdoc(7) -T lint: do not warn about Mdocdate without an actual date
1.35 schwarze 102: * mdoc(7) -T lint: do not complain about function types of the
103: form "ret_type (fname)(args)", but otherwise check names more strictly
1.36 schwarze 104: * -T html: append .html suffix to temporary files to please browsers
105: * -T markdown: print a BAGARG message if called on man(7) input
1.35 schwarze 106: --- MINOR BUGFIXES ---
1.36 schwarze 107: * man(1): do the search for each name independently, and
108: show the results in the order of the command line argument
109: * man(1): escape shell wildcard characters in name arguments before glob(3)
110: * man(1): when asking for a single manual page by name, prefer file name
111: matches over .Dt/.TH matches over first NAME matches over later NAME
112: matches, but do not change the ordering for apropos(1) nor for man -a
113: * man(1): correctly extract the section name from the file name extension
114: of gzipped manual page files
115: * makewhatis(8): fix file type tests putting wrong data into mandoc.db(5)
116: * man.cgi(8): fix section number in the <title> element for preformatted pages
117: * tbl(7): correct handling of T& after horizontal rulers in the layout
118: * tbl(7): correct column widths if rows have different numbers of cells
119: * tbl(7): empty columns are 1n wide rather than 0n
120: * tbl(7): correctly calculate required column widths for tables containing
121: cells that horizontally span columns which contains "n" (number) formatted
122: cells on other rows
123: * tbl(7): skip escape sequences when looking for column separators
124: * eqn(7): skip whitespace before tokens
1.35 schwarze 125: * roff(7): when calling an empty macro, do not clobber existing arguments
1.36 schwarze 126: * roff(7): recognize \} on lines closing a macro definition request
127: * roff(7): do not throw a bogus warning for "'br\}" and similar lines
128: * roff(7): stop generating comment nodes when encountering the first content
129: * mandoc_char(7): make \0 (digit-width space) non-breaking
1.35 schwarze 130: * mdoc(7) .Bl -column: parse Macro in .It "word<tab>word" Ta word Macro<eol>
1.36 schwarze 131: * mdoc(7) -T html: display straight quotes, not curly quotes, for .Qq/.Qo
1.35 schwarze 132: * -T html: remove some spurious line breaks, in particular inside <pre>
1.36 schwarze 133: * -T html: use <br/> for a space character at the beginning of an input line
134: * -T html: use ~%d for ordinal fragment suffixes, reserve '~' for that purpose
1.35 schwarze 135: --- STRUCTURAL IMPROVEMENTS ---
1.36 schwarze 136: * introduce the concept of semantically transparent syntax tree nodes,
137: allowing improved decisions in various validators and formatters
1.35 schwarze 138: * move some code out of the giant main() into separate functions
139: doing one well-defined task each
140: * clearly separate parser state (struct curparse) and formatter state
141: (struct outstate), don't mix them in the same struct
142: * in the HTML formatter, assert(3) that no HTML nesting violation occurs
143: * let html_close_paragraph() close any phrasing context
144: --- THANKS TO ---
1.36 schwarze 145: * Anthony Bentley and Klemens Nanni (OpenBSD) for many patches and bug
146: reports, for useful discussions, and for checking patches
147: * Anton Lindqvist (OpenBSD) for two patches and a bug report
148: * Marc Espie (OpenBSD) for a patch, many bug reports, and useful discussions
1.39 schwarze 149: * Lukas Epple (NixOS) for a patch, bug reports, suggesting a minor
150: portability feature, checking patches, and extensive release testing
1.36 schwarze 151: * Abel Romero Perez for a patch, a bug report, and suggesting a new feature
152: * nabijaczleweli for a patch and for suggesting feature improvements
153: * Jonathan Gray (OpenBSD) for a patch and for bug reports
154: * Otto Moerbeek (OpenBSD) and Alexander Gromnitsky for a patch
1.35 schwarze 155: * Armin Besirovic for a contribution to mandoc.css
1.37 schwarze 156: * Jason McIntyre (OpenBSD) for manual page patches, suggesting a new feature,
1.36 schwarze 157: checking many patches, and useful discussions
158: * Martin Vahlensieck for a manual page patch and reporting a code style issue
159: * Frederic Cambus and Ian Sutton (OpenBSD) for a manual page patch
160: * Jan Schreiber for many bug reports found with afl(1)
161: * G. Branden Robinson (GNU troff) for several bug reports, feature
162: suggestions, and for checking many groff patches
1.39 schwarze 163: * Michael Stapelberg (Debian) for several bug reports and feature
164: suggestions, and for extensive release testing
165: * Ian Ropers, Lorenzo Beretta, and Oliver Corff for several bug reports
166: and feature suggestions
1.36 schwarze 167: * Stephen Gregoratto for several bug reports
168: * Theo de Raadt (OpenBSD) for two bug reports, checking a patch,
169: and a useful discussion
1.39 schwarze 170: * Thomas Klausner (NetBSD) for two bug reports and for release testing
1.36 schwarze 171: * Andreas Kahari and Jason A. Donenfeld for two bug reports
172: * Soeren Tempel (Alpine Linux) for a bug report, suggesting a feature
173: improvement, and checking two patches
174: * Aman Verma, Jan Stary, and John Gardner for a bug report
1.35 schwarze 175: and for suggesting a feature impovement
1.36 schwarze 176: * Todd Miller (OpenBSD) for a bug report, checking a patch,
177: and a useful discussion
178: * Andrew Fresh, Brian Callahan, Christian Weisgerber, Paul de Weerd (OpenBSD),
1.39 schwarze 179: Havard Eidnes, Jason Thorpe (NetBSD), Yuri Pankov (FreeBSD),
180: Bjarni Ingi Gislason, Chris Bennett, Edgar Pettijohn, Eldred Habert,
181: Jamie Landeg-Jones, Kazuo KUROI, and Wynn Wolf Arbor for a bug report
1.36 schwarze 182: * Theo Buehler (OpenBSD) for suggesting two feature impovements
183: and for checking a patch
1.39 schwarze 184: * Leah Neukirchen (Void Linux) for suggesting a feature impovement
185: and for release testing
1.36 schwarze 186: * Colin Watson (Debian) for suggesting a feature impovement
187: and for checking groff patches
1.39 schwarze 188: * Matej Cepl (SUSE Linux), Matthew Martin, Steffen Nurpmeso,
189: and Tim Baumgard for suggesting a feature impovement
1.36 schwarze 190: * Christos Zoulas (NetBSD) for a report regarding portability
191: * Daniel Dickman (OpenBSD) for suggesting a portability improvement
192: * Werner Lemberg (GNU troff) and Douglas McIlroy
193: for reporting bugs in manual pages
194: * Baptiste Daroussin and Eygene Ryabinkin (FreeBSD)
195: for an additional regression test
196: * Michal Nowak for reporting several code style issues
1.35 schwarze 197: * TJ Townsend (OpenBSD) for help with CSS
1.39 schwarze 198: * Sevan Janiyan (NetBSD) and Robert Mustacchi (Illumos)
199: for extensive release testing
1.36 schwarze 200: * Job Snijders, Kinichiro INOGUCHI, and Martijn van Duren (OpenBSD)
201: for checking patches
202: * Bertrand Garrigues and Ralph Corderoy (GNU troff) for checking groff patches
1.33 schwarze 203:
1.34 schwarze 204: Changes in version 1.14.5, released on March 10, 2019
205:
1.33 schwarze 206: --- MAJOR NEW FEATURES ---
207: * apropos(1): improve POSIX compliance by accepting case-insensitive
208: extended regular expressions by default
209: * new -O tag[=term] output option (open a page at the definition of a term)
210: * tbl(7) -T html: spanning and horizontal and vertical alignment of cells
211: * tbl(7) -T html: draw lines on the edges of table cells
212: * tbl(7) -T utf8: render lines with the Unicode box drawing characters
213: * mandoc is now able to handle the manual pages of the groff package.
214: --- MINOR NEW FEATURES ---
215: * -T html: new option -O toc (table of contents)
216: * -T html: second argument to -O man to support local and remote links
217: * mdoc(7) .Bd -centered now fills the text contained in it
218: * man-ext .SY and .YS macros (synopsis block)
219: * man-ext .TQ macro (tagged paragraph without vertical space before it)
220: * tbl(7) \& explicit alignment indicator
221: * roff(7) .shift, .while, and .return requests
222: * roff(7) .char request (output glyph definition)
223: * roff(7) .nop request (no operation)
224: * roff(7) .ft request: handle the CB, CI, and CR fonts
225: * roff(7) .if c conditional (character available)
226: * roff(7) \\$@ escape sequence (insert all macro arguments, quoted)
227: * roff(7) \*(.T predefined string (interpolate output device name)
228: * roff(7) \[charNNN] escape sequence (for printable ASCII characters)
229: * roff(7) \# escape sequence (line continuation with comment)
230: --- HTML OUTPUT SYNTAX CORRECTIONS ---
231: * Render .br and \p as <br/>, not as an empty <div>.
232: * Render .Pp and .PP as <p> and automatically close it when needed.
233: * Stop writing empty list elements for non-compact .Bl -tag lists.
234: * Do not put <p> inside <a> if .UR or .MT contain .PP.
235: * Implement tooltips purely in CSS rather than abusing title= attributes.
236: --- MINOR FUNCTIONAL IMPROVEMENTS ---
237: * many improvements to the handling of fill and no-fill mode
238: * tbl(7): better column widths in the presence of horizontal spans
239: * several minor improvements to escape sequence handling
240: * several minor improvements to manual font handling
241: * portability: autodetect need for _GNU_SOURCE or _OPENBSD_SOURCE
242: * portability: autodetect whether less(1) supports the -T option
243: * large numbers of bugfixes of diverse kinds
244: --- STRUCTURAL IMPROVEMENTS ---
245: * Disentangle eqn(7) and tbl(7) from other parser header files,
246: and clean up some parser data structures.
247: * Substantially simplify error and warning message infrastructure.
248: --- THANKS TO ---
249: * John Gardner for crucial help implementing tooltips in CSS.
250: * Alexander Bluhm, Raphael Graf, Ted Unangst (OpenBSD)
251: and Daniel Sabogal (Alpine Linux) for patches.
252: * Anthony Bentley and Jason McIntyre (OpenBSD) for documentation patches,
253: suggesting new features, bug reports, and useful discussions.
254: * Kyle Evans and Baptiste Daroussin (FreeBSD) for minor patches.
255: * Pali Rohar for suggesting multiple new features and for reporting
256: several bugs and missing features.
257: * Klemens Nanni (OpenBSD) for suggesting multiple new features.
258: * Kristaps Dzonsons (bsd.lv), Marc Espie (OpenBSD), Adam Kalisz,
259: and Laura Morales for suggesting new features.
260: * Wolfram Schneider and Yuri Pankov (FreeBSD) for reporting missing features.
261: * Edward Tomasz Napierala (FreeBSD) for suggesting a feature improvement.
1.34 schwarze 262: * Thomas Klausner (NetBSD) and Sevan Janiyan (SmartOS)
263: for bug reports and release testing.
1.33 schwarze 264: * Bryan Steele, Janne Johansson, Kurt Mosiejczuk, Mike Belopuhov, Theo
265: Buehler, Todd Miller (OpenBSD), Andreas Gustafsson, Christos Zoulas,
1.34 schwarze 266: Robert Elz (NetBSD), Kurt Jaeger (FreeBSD), Fabio Scotoni, Kelvin
267: Sherlock, Mark Harris, Orestis Ioannou, Raf Czlonka, and Sean Farrell
268: for bug reports.
269: * Ulrich Spoerlein (FreeBSD), Leah Neukirchen (Void Linux),
270: Matej Cepl (openSUSE), and Jan Stary (MacOS X) for release testing.
1.33 schwarze 271: * Brian Callahan and Stuart Henderson (OpenBSD) for help
272: with the OpenBSD groff port.
273: * Bertrand Garrigues, Branden Robinson, Ralph Corderoy, and Werner
274: Lemberg (GNU troff) for checking groff patches.
275: * Scott Cheloha, Theo de Raadt (OpenBSD)
276: and Natanael Copa (Alpine Linux) for useful discussions.
1.28 schwarze 277:
1.32 schwarze 278: Changes in version 1.14.4, released on August 8, 2018
1.28 schwarze 279:
280: --- MAJOR NEW FEATURES ---
281: * In ASCII output, render mathematical symbols and greek letters
282: as transliterations conveying the characters' meanings rather
283: than trying to imitate their shape. Consequently, such characters
284: can now be used in portable manual pages. All the same, please
285: limit their use to contexts where they really matter, for example
286: when showing complicated mathematical formulae.
287: * First steps towards better support for small screens in HTML
288: output (responsive design): avoid most style= attributes, in
289: particular all hard-coded indentations and column widths, and
290: provide a better mandoc.css style sheet with a @media query,
291: using em units throughout, and avoiding redundancy in selectors.
292: * Better HTML output with some more fitting HTML elements, eliminating
293: needless class= attributes, and avoiding various HTML syntax errors
294: (element nesting, URL-fragment syntax, duplicate id= attributes).
295: --- MINOR NEW FEATURES ---
296: * When a man(1) argument contains a slash, imply -l like in man-db.
297: * Use TIOCGWINSZ to reduce the default -Owidth and -Oindent during
298: interactive use on terminals narrower than 79 columns.
299: * Generated PostScript files are now more than 50% smaller.
300: * Terminal rendering of eqn(7) is improved in several respects.
301: * Simplified and nicer output from the mdoc(7) .Lk macro, formatting
302: all links in-line, even long ones.
303: * roff(7) \n+ and \n- numerical register auto-increment and -decrement
304: * roff(7) .nr optional third argument (auto-increment step size)
1.29 schwarze 305: * Autodetect in ./configure whether the compiler can use -W and -static,
306: allowing to build on Solaris 10 and 11 without any configure.local.
1.28 schwarze 307: --- RELIABILITY BUGFIXES ---
308: * Only activate UTF-8 output when the user really selected UTF-8,
309: not some other multibyte character encoding.
310: * Prevent excessive .ll arguments from generating infinite output.
1.31 schwarze 311: * Fix out of bounds accesses to parse buffers that could happen when
312: using renamed or user defined macros after roff(7) conditionals.
1.28 schwarze 313: * Avoid an assertion failure in certain .Bl -column lists.
314: * Avoid a NULL pointer access on deroff() failure after '.SS ""'.
315: * Fix a segfault that could be triggered by two invalid .Dt macros.
316: * Fix two syntax errors in generated PDF files.
317: * Properly state the page size in generated PostScript files.
318: * Close a memory leak caused by missing gzclose(3).
319: * Fix misformatting of man(7) documents lacking .SH macros
320: in PostScript and PDF output.
321: * And many minor bugfixes.
322: --- THANKS TO ---
323: * Marc Espie (OpenBSD) for implementing the size reduction of
324: PostScript files, one additional patch for code simplification,
325: and two bug reports.
326: * Theo Buehler (OpenBSD) for a bugfix patch,
327: and Theo de Raadt (OpenBSD) for checking it.
328: * John Gardner for more than a dozen suggestions regarding HTML output.
329: * Mike Williams for teaching me how to use %%DocumentMedia and
330: setpagedevice in PostScript files.
331: * Werner Lemberg (groff) for feedback on mdoc(7) language changes.
332: * Colin Watson (man-db) for feedback on man-db semantics.
333: * Jason McIntyre (OpenBSD) for lots of feedback and suggestions
334: on diagnostic messages and on the documentation.
1.32 schwarze 335: * Thomas Klausner (NetBSD) for suggesting two new style messages
336: and one new feature, for two bug reports, and for release testing.
1.30 schwarze 337: * Leah Neukirchen (Void Linux) for suggesting a new style message,
1.31 schwarze 338: five bug reports, and release testing.
1.28 schwarze 339: * Anthony Bentley (OpenBSD) for reporting multiple bugs and missing
340: features.
341: * Paul Irofti (OpenBSD) and Nate Bargmann for suggesting new features.
1.32 schwarze 342: * Michael Stapelberg (Debian) for bug reports and release testing.
343: * Christian Weisgerber, Jonathan Gray, Stuart Henderson,
344: Ted Unangst (OpenBSD), Takeshi Nakayama (NetBSD),
1.28 schwarze 345: Anton Lazarov, Jakub Klinkovsky, Jan Stary, Jesper Wallin,
346: Will Backmam, and Wolfgang Mueller for bug reports.
347: * Sevan Janiyan (NetBSD) for additions to lib.in.
348: * George Brown for suggesting code simplifications.
349: * David Coppa, Igor Sobrado (OpenBSD), and Alexander Kuleshov
350: for documentation improvements.
351: * Laura Morales and Raf Czlonka for questions resulting in better
352: documentation.
1.32 schwarze 353: * Yuri Pankov (illumos) for release testing.
1.27 schwarze 354:
355: Changes in version 1.14.3, released on August 5, 2017
356:
357: --- BUG FIXES ---
358: * man(7): Do not crash with out-of-bounds read access to a constant
359: array if .sp or a blank line immediately precedes .SS or .SH.
360: * mdoc(7): Do not crash with out-of-bounds read access to a constant
361: array if .sp or a blank line precede the first .Sh macro.
362: * tbl(7): Ignore explicitly specified negative column widths rather than
363: wrapping around to huge numbers and risking memory exhaustion.
364: * man(1): No longer use names that only occur in the SYNOPSIS section.
365: Gets rid of some surprising behaviour and bogus warnings.
366: --- THANKS TO ---
367: Leah Neukirchen (Void Linux), Markus Waldeck (Debian),
368: Peter Bui (nd.edu), and Yuri Pankov (illumos) for bug reports.
1.23 schwarze 369:
1.26 schwarze 370: Changes in version 1.14.2, released on July 28, 2017
1.23 schwarze 371:
372: --- MAJOR NEW FEATURES ---
373: * New mdoc(7) -Tmarkdown output mode.
374: * For -Thtml, implement internal hyperlinks pointing to authoritative
375: definitions of various syntax elements, similar to the ctags(1)-like
376: less(1) :t internal searching in terminal mode.
377: * Provide a superset of the functionality of the former mdoclint(1)
378: utility and a new -Wstyle message level with several new messages,
379: including validity checking of .Xr cross references.
380: * tbl(7): Implement automatic line breaking inside individual table
381: cells, and several other formatting improvements.
382: * eqn(7): Complete rewrite of the lexer, resulting in several bugfixes.
383: * Continue parser unification, in particular allowing generation
384: of syntax tree nodes on the roff(7) level, allowing implementation
385: of many additional roff requests.
386: --- REMOVED FUNCTIONALITY ---
387: * Delete the manpage(1) utility. It was never enabled in any release.
388: * Delete the -Txhtml command line option. It has been an obsolete
389: alias for the -Thtml output mode for more than two years.
390: --- MINOR NEW FEATURES ---
1.25 schwarze 391: * -Tlint now puts parser messages on stdout instead of stderr,
392: making commands like "man -l -Tlint *.1" useful.
1.23 schwarze 393: * mdoc(7): Various .Lk formatting improvements.
1.24 schwarze 394: * mdoc(7) -Thtml: Better CSS for .Bl lists.
1.23 schwarze 395: * man(7): Implement the .MT/.ME block macro (mailto hyperlink).
396: * man(7): Implement the .DT macro (restore default tab positions).
397: * man(7): Improved support for manuals generated with reStructuredText
398: by partial support for the \n[an-margin] number register.
399: * man(7) -Thtml: Support deep linking to .SH and .SS headers.
400: * tbl(7): Implement the "allbox" table option.
401: * tbl(7): Implement the column spacing and the 'w' (minimum column
402: width) layout modifiers.
403: * tbl(7): Significant improvements of the manual page.
404: * eqn(7): Much improved font selection, including recognition of
405: well-known function names, and a few other formatting improvements.
406: * eqn(7) -Thtml: Use <mn> and <mo> in addition to <mi>.
407: * roff(7): Implement the .ce (centering), .mc (margin character),
408: .rj (right justify), .ta (define tab stops), .ti (temporary indent),
409: .als (macro alias), .ec and .eo (escape character control),
410: .po (page offset), and .rn (macro rename) requests.
411: * roff(7) .am: Implement appending to mdoc(7) and man(7) macros.
412: * roff(7): implement the \h (horizontol motion), \l (horizontal
413: line drawing), and \p (break output line) escape sequences,
414: and also several additional character escape sequences.
415: * roff(7): Implement the 'd' conditional (macro or string defined).
416: * man.cgi(8) now uses pledge(2), too.
1.24 schwarze 417: * regress.pl(1): simpler user interface, better summary output,
418: simpler code, and no more recursion.
1.23 schwarze 419: --- THANKS TO ---
420: * Anthony Bentley (OpenBSD) for the implementation of .MT/.ME,
421: reports of many bugs and missing features, and suggestions
422: for a number of feature and documentation improvements.
423: * Sebastien Marie (OpenBSD) for two source code patches and
424: for some useful discussions.
1.26 schwarze 425: * Florian Obser (OpenBSD) for a bugfix patch and a bug report.
1.23 schwarze 426: * Jonathan Gray (OpenBSD) for several bug reports from afl(1)
427: and several more from static analysis tools.
428: * Theo Buehler (OpenBSD) for several bug reports, most from afl(1).
429: * Jason McIntyre (OpenBSD) for many useful discussions about a
430: wide variety of topics, lots of continuous testing, a number of
431: bug reports, and some suggestions for messages and documentation.
432: * Thomas Klausner (NetBSD) for lots of help while migrating
1.26 schwarze 433: mdoclint(1) functionality to mandoc -Tlint, for suggesting
434: several useful new messages, and for release testing.
1.23 schwarze 435: * Reyk Floeter (OpenBSD) and Vsevolod Stakhov (FreeBSD) for
436: suggesting a markdown output mode.
437: * Thomas Guettler for suggesting -Thtml internal hyperlinks.
1.26 schwarze 438: * Yuri Pankov (Illumos) for inspiring new warning messages and
439: for extensive release testing.
1.24 schwarze 440: * Anton Lindqvist and TJ Townsend (both OpenBSD) and Jan Stary
441: for multiple bug reports.
1.26 schwarze 442: * Leah Neukirchen (Void Linux) for bug reports and release testing.
443: * Michael Stapelberg (Debian) for suggesting feature improvements
444: and for release testing.
445: * Martin Natano and Theo de Raadt (both OpenBSD), Andreas Voegele,
446: Gabriel Guzman, Gonzalo Tornaria, Markus Waldeck, and Raf Czlonka
447: for bug reports.
448: * Antoine Jacoutot (OpenBSD) and Steffen Nurpmeso for suggesting
449: feature improvements.
450: * Dag-Erling Smoergrav (FreeBSD) for inspiring new warning messages.
1.24 schwarze 451: * Ted Unangst and Marc Espie (OpenBSD) for providing useful ideas.
1.26 schwarze 452: * Svyatoslav Mishyn (Crux Linux) for release testing.
1.23 schwarze 453: * Carsten Kunze (Heirloom roff) for help keeping mandoc and groff
454: compatible and for committing some of my patches to groff.
1.13 schwarze 455:
1.21 schwarze 456: Changes in version 1.14.1, released on February 21, 2017
1.13 schwarze 457:
458: --- MAJOR NEW FEATURES ---
459: * apropos(1): Reimplement complete semantic search functionality
460: without the dependency on SQLite3, using only POSIX APIs.
461: This comes with a completely new mandoc.db(5) file format.
462: * man(1): Support more than one tag entry for the same search term,
463: plus some minor improvements to the less(1) :t support.
464: * -Thtml: Use real macro names for CSS classes.
465: Systematic cleanup of and many improvements to mandoc.css.
466: * -Thtml: Produce human readable HTML code by using indentation
467: and better line breaks. Improve various HTML elements,
468: and trim several useless ones.
469: * New catman(8) utility, still somewhat experimental.
1.14 schwarze 470: * Now includes a portable version of the OpenBSD mandoc regression
471: suite, see regress/regress.pl.1 for details.
1.13 schwarze 472: --- REMOVED FUNCTIONALITY ---
473: * Operating systems that don't provide mmap(3) are no longer supported.
474: * Drop support for manpath(1). Even if your system has manpath(1),
475: it is simpler to use MANPATH_DEFAULT in configure.local for
476: operating system defaults, man.conf(5) for machine-specific
477: modifications, and ${MANPATH}, -m, and -M for user preferences
478: than to bother with the complexity of manpath(1).
479: * makewhatis(8) -p: No longer warn about missing MLINKS since these
480: are no longer needed for anything.
481: --- MINOR NEW FEATURES ---
482: * mdoc(7): Warn about invalid punctuation and content below NAME.
483: * mdoc(7): Warn about .Xr lacking the second argument (section).
484: * mdoc(7): Warn about violations of the rule "new sentence, new line".
485: * roff(7): Warn about trailing whitespace at the end of comments.
1.21 schwarze 486: * mdoc(7): Improve rendering of double quotes.
1.13 schwarze 487: * mdoc(7): Always do text production in the validator, never in the
488: formatters. Cleaner, simpler, shorter, helps NetBSD apropos(1)
489: and also makes -Ttree output more useful.
1.15 schwarze 490: * -Ttree: Show metadata and some additional node flags.
491: New -Onoval output option to show the unvalidated tree.
1.13 schwarze 492: --- RELIABILITY BUGFIXES ---
493: * man(1): Make "man -l" work with standard input from a pipe or file,
494: as long as standard output is a terminal.
1.21 schwarze 495: * man(7): Fix out of bounds read access if a text node immediately
496: preceded the first .SH header.
1.13 schwarze 497: * mdoc(7): Fix out of bounds read access for .Bl without a type
498: but with a width.
499: * mdoc(7): Fix out of bounds read access for .Bl -column starting
500: with a tab character instead of a child .It macro.
501: * mdoc(7): Fix syntax tree corruption leading to segfaults caused
502: by stray block end macros in nested blocks of mismatching type.
503: * man(1): Fix NULL dereference when the first of multiple pages
504: shown was preformatted.
1.18 schwarze 505: * mdoc(7): Fix syntax tree corruption leading to NULL dereference
506: caused by partial implicit macros inside .Bl -column table cells.
1.13 schwarze 507: * mdoc(7): Fix syntax tree corruption leading to NULL dereference
508: for macro sequences like .Bl .Bl .It Bo .El .It.
1.15 schwarze 509: * mdoc(7): Fix syntax tree corruption leading to NULL dereference
1.13 schwarze 510: caused by .Ta following a nested .Bl -column breaking another block.
1.16 schwarze 511: * mdoc(7): Fix syntax tree corruption sometimes leading to NULL
1.17 schwarze 512: dereference caused by indirectly broken .Nd or .Nm blocks.
1.13 schwarze 513: * mdoc(7) -Thtml: Fix a NULL dereference for .Bl -column with 0 columns.
1.17 schwarze 514: * mdoc(7): Fix NULL dereference in some specific cases of a
515: block-end macro calling another block-end macro.
1.13 schwarze 516: * mdoc(7): Fix NULL dereference if the only child of the head
517: of the first .Sh was an empty in-line macro.
1.19 schwarze 518: * eqn(7): Fix NULL dereference in the terminal formatter
519: for empty matrices and empty square roots.
1.13 schwarze 520: * mdoc(7): Fix an assertion failure for a .Bd without a type that
521: breaks another block.
1.20 schwarze 522: * mdoc(7): Fix an assertion failure that happened for some .Bl -column
523: lists containing a column width of "-4n", "-3n", or "-2n".
1.13 schwarze 524: * mdoc(7): Fix an assertion failure caused by .Bl -column without .It
525: but containing eqn(7) or tbl(7) code.
526: * roff(7): Fix an assertion failure caused by \z\[u00FF] with -Tps/-Tpdf.
527: * roff(7): Fix an assertion failures caused by whitespace inside \o''
528: (overstrike) sequences.
529: * -Thtml: Fix an assertion failure caused by -Oman or -Oincludes of
530: excessive length.
531: --- PORTABILITY IMPROVEMENTS ---
532: * man(1): Do not mix stdio narrow and wide stream orientation
533: on stdout, which could cause output corruption on glibc.
534: * mandoc(1): Autodetect a suitable locale for -Tutf8 mode.
1.21 schwarze 535: * ./configure: Autodetect whether PATH_MAX and O_DIRECTORY are defined.
536: * ./configure: Autodetect if nanosleep(3) needs -lrt.
537: * ./configure: Provide an ${LN} configuration variable.
538: * ./configure: Put compiler arguments that may contain -l at the end.
1.13 schwarze 539: --- MINOR BUGFIXES ---
540: * mdoc(7): Fix SYNOPSIS output if the first child of .Nm is a macro.
541: * mdoc(7) -Thtml: Improve formatting of .Bl -tag with short tags.
542: * man(7) -Thtml: Preserve whitespace in .nf (nofill) mode.
543: * mandoc(1): Error out on invalid output options on the command line.
544: --- STRUCTURAL CHANGES, no functional change ---
545: * Redesign part of the mandoc_html(3) interfaces, making them much
546: easier to use and reducing the amount of code by a few hundred lines.
547: --- THANKS TO ---
548: * Michael Stapelberg (Debian) for designing the new mandocd(8)
1.21 schwarze 549: and parts of the new catman(8), for release testing, and for a
550: number of patches and bug reports.
1.13 schwarze 551: * Baptiste Daroussin (FreeBSD) for profiling the new makewhatis(8)
552: implementation and suggesting an algorithmic improvement which
553: more than doubled performance, and for a few bug reports.
554: * Ed Maste (FreeBSD) for an important patch improving reproducibility
555: of builds in makewhatis(8), and for a few bug reports.
1.21 schwarze 556: * Theo Buehler (OpenBSD) for almost twenty important bug reports,
1.13 schwarze 557: most of them found by systematic afl(1) fuzzing.
558: * Benny Lofgren, David Dahlberg, and in particular Vadim Zhukov
559: for crucial help in getting .Bl -tag CSS formatting fixed.
560: * Svyatoslav Mishyn (Crux Linux) for an initial version of the
1.21 schwarze 561: patch to autodetect a suitable locale for -Tutf8 mode
562: and for release testing.
1.13 schwarze 563: * Jason McIntyre (OpenBSD) for multiple useful discussions
564: and a number of bug reports.
1.21 schwarze 565: * Sevan Janiyan (NetBSD) for extensive release testing and multiple
566: bug reports.
567: * Thomas Klausner and Christos Zoulas (NetBSD), Yuri Pankov (illumos),
568: and Leah Neukirchen (Void Linux) for release testing and bug reports.
569: * Ulrich Spoerlein (FreeBSD) for release testing.
1.13 schwarze 570: * Alexander Bluhm, Andrew Fresh, Antoine Jacoutot, Antony Bentley,
571: Christian Weisgerber, Jonathan Gray, Marc Espie, Martijn van Duren,
572: Stuart Henderson, Ted Unangst, Theo de Raadt (OpenBSD), Abhinav
1.21 schwarze 573: Upadhyay, Kamil Rytarowski (NetBSD), Aaron M. Ucko, Bdale Garbee,
574: Reiner Herrmann, Shane Kerr (Debian), Daniel Sabogal (Alpine Linux),
1.13 schwarze 575: Carsten Kunze (Heirloom roff), Kristaps Dzonsons (bsd.lv),
576: Anton Lindqvist, Jan Stary, Jeremy A. Mates, Mark Patruck,
577: Pavan Maddamsetti, Sean Levy <attila@stalphonsos.com>, and
578: Tiago Silva for bug reports.
579: * Brent Cook, Marc Espie, Philip Guenther, Todd Miller (OpenBSD)
580: and Markus Waldeck for useful discussions.
581: * And as usual, OpenCSW for providing me with a Solaris 9/10/11
582: testing environment.
1.11 schwarze 583:
1.12 schwarze 584: Changes in version 1.13.4, released on July 14, 2016
1.11 schwarze 585:
586: --- MAJOR NEW FEATURES ---
587: * man.conf(5): Design and implement a simpler configuration file format.
588: * man(1): Leverage less(1) -T and :t in a way resembling ctags(1)
589: to jump to the definitions of various terms inside manual pages.
590: * soelim(1): New implementation by Baptiste Daroussin.
1.12 schwarze 591: * privilege limitation: Use OpenBSD pledge(2) or OS X sandbox_init(3)
592: when available.
593: * man.cgi(8): Support short URIs like http://man.openbsd.org/mdoc .
1.11 schwarze 594: * mandoc.css: Use one unified stylesheet rather than three different ones.
595: --- MAJOR FUNCTIONALLY RELEVANT BUGFIXES ---
596: * mdoc(7): Fix multiple aspects of SYNOPSIS .Nm formatting.
597: * man(1): Fix process group handling, avoiding unclean shutdowns.
598: --- PORTABILITY IMPROVEMENTS ---
599: * Correctly use the ohash(3) compatibility implementation
600: even when building without SQLite support.
601: * Add compat glue for building on Solaris 9 and 10.
602: * Let ./configure select a supported RE syntax for word boundaries.
1.12 schwarze 603: * Support LDFLAGS, to be used for example for hardening options.
604: * Avoid mixing putchar(3) and putwchar(3) on the same file descriptor,
605: it resulted in output corruption on some platforms.
1.11 schwarze 606: * Avoid reusing va_lists, use va_copy(3) for better portability.
607: * Do not hardcode the path to the more(1) program.
608: --- MINOR NEW FEATURES ---
609: * roff(7): Implement \n(.$ (number of macro arguments).
610: * roff(7): Fully implement \z (do not advance cursor).
611: * roff(7): Implement the `r' conditional (register exists).
612: * roff(7): Implement \\$* (interpolate all arguments).
613: * roff(7): Parse and ignore \, and \/ (italic corrections).
614: * When there is no -m, no -M, no MANPATH and no /etc/man.conf,
615: fall back to /usr/share/man:/usr/X11R6/man:/usr/local/man.
616: * man(1): Give manuals in purely numerical sections priority over
617: manuals of the same name in sections with an alphabetical suffix.
618: * man.cgi(8): Support "header.html" and "footer.html".
619: * man.cgi(8): Set the "autofocus" attribute on the query text box.
620: * man.cgi(8): Simplify the search form, drop two useless buttons.
1.12 schwarze 621: * man.cgi(8): Delete the pseudo-manpath "mandoc", assume that
622: apropos(1) and man.cgi(8) are installed in the default manpath.
1.11 schwarze 623: --- RELIABILITY BUGFIXES ---
624: * mdoc(7): Avoid a use after free and an assertion failure when nodes
625: are deleted during validation.
626: * mdoc(7): Avoid a NULL pointer access when .Bd has no arguments.
627: * mdoc(7): Avoid a NULL pointer access triggered by mismatching end macros.
628: * mdoc(7): Avoid an assertion when .Fo has no argument.
629: * mdoc(7): Avoid an assertion when .Ta<tab> occurs in .Bl -column.
630: * mdoc(7): Avoid an assertion when a body gets broken and has a tail.
631: * roff(7): Avoid an assertion caused by blanks inside \o.
1.12 schwarze 632: * roff(7): Make .so links to gziped manuals work without mandoc.db(5).
1.11 schwarze 633: * tbl(7): Avoid a use after free when the last line of a layout is empty.
634: * eqn(7): Avoid an infinite loop caused by recursive "define".
635: * makewhatis(8): Avoid a segfault caused by unusual directory structures.
636: * Fix handling of leading, trailing, and double colons in MANPATH and -m.
637: --- MINOR BUGFIXES ---
638: * mdoc(7): Put arguments to end macros of broken partial explicit blocks
639: inside the breaking block.
640: * mdoc(7): Let .Dv force normal font.
641: * mdoc(7): Make trailing whitespace significant in .Bl -tag widths.
642: * mdoc(7): Fix macro interpretation around tabs in .Bl -column.
643: * man(7): Use the default width for .RS without arguments.
644: * man(7): On a new RS nesting level, the saved width starts from
645: the default width, not from the saved width of the previous level.
646: * man(7): Allow .PD in next-line scope.
647: * man(7): Improve handling of empty .HP.
648: * man(7): Improve formatting of .br and .sp inside .HP.
649: * man(7): Do not mistreat empty arguments to font alternating
650: macros as vertical spacing requests.
651: * man(7): Allow fill mode changes in tagged paragraph next-line scope.
652: * man(7): Fix minor bugs in block rewinding and simplify the related code.
653: * man(7): Add missing line breaks before subsection headers.
654: * man(7): Give section and subsection headers hanging indentation.
655: * man(7): Make trailing whitespace significant in .TP widths.
656: * roff(7): Don't allow breaking the output line after hyphens
657: that immediately follow escape sequences.
658: * roff(7): Ignore blank characters at the beginning of conditional blocks.
659: * roff(7): Escape breakable hyphens only after handling input line traps.
660: * roff(7): Reject \[uD800] to \[uDFFF] (surrogates) in the parser.
661: * tbl(7): Allow more than one data field after T} on the same input line.
662: * terminal output: Apply bold and italic to non-ASCII Unicode codepoints.
663: * terminal output: Improve rounding rules for horizontal scaling widths.
664: * HTML output: Render ASCII_NBRSP as " ", not "-".
665: * man(1): Do not match the first part of a name if it continues with a dot.
666: * man(1): Keep working even if the current directory is unusable.
667: * man(1): Better error message when $PAGER is invalid.
668: * makewhatis(8): Improve handling of .Va and .Vt macros.
669: * apropos(1): Print "nothing appropriate" to stderr when appropriate.
670: * apropos(1): Abort with a useful error message when elementary
671: database operations like preparing queries or binding variables fail.
672: --- STRUCTURAL CHANGES, no functional change ---
673: * mdoc(7) and man(7): Unified data structures struct roff_node etc.
674: * mdoc(7) and man(7): Unified node handling library in roff.c.
675: * mdoc(7) and man(7): Seperate validation phase from parsing.
1.12 schwarze 676: * roff(7): Major character table cleanup.
1.11 schwarze 677: * Link with libz rather than forking gunzip(1).
678: --- THANKS TO ---
1.12 schwarze 679: * Baptiste Daroussin (FreeBSD) for the new soelim(1)
680: and for release testing.
1.11 schwarze 681: * Anthony Bentley (OpenBSD) for unifying mandoc.css, two nice
682: patches for man.cgi(8), some documentation patches, some bug
683: reports, and various useful discussions.
684: * Todd Miller (OpenBSD) for lots of help with process group and
685: signal handling, a few patches, some bug reports and some useful
686: discussions.
687: * Jonathan Gray (OpenBSD) for yet more testing with afl(1)
688: again resulting in more than half a dozen important bug reports.
1.12 schwarze 689: * Svyatoslav Mishyn (Crux Linux) for some patches, several bug
690: reports, and extensive release testing.
1.15 schwarze 691: * Leah Neukirchen (Void Linux) for a number of compatibility
1.12 schwarze 692: patches and suggestions and several bug reports.
1.11 schwarze 693: * Christos Zoulas (NetBSD) for a bug fix patch and some useful
694: suggestions for cleanup.
695: * Florian Obser (OpenBSD) for a bugfix patch and some bug reports.
1.12 schwarze 696: * Sevan Janiyan for help with Solaris compatibility and release
697: testing on many platforms.
698: * Jan Holzhueter and OpenCSW in general for help with Solaris
699: compatibility, and for providing me with a Solaris 9/10/11 testing
700: environment.
1.11 schwarze 701: * Michael McConville (OpenBSD) for some simple cleanup patches.
1.12 schwarze 702: * Thomas Klausner (NetBSD) for some bug reports and release testing.
1.11 schwarze 703: * Christian Weisgerber, Dmitrij Czarkoff, Igor Sobrado,
1.12 schwarze 704: Ken Westerback, Marc Espie, Mike Belopuhov, Rafael Neves,
705: Ted Unangst, Tim van der Molen, Theo Buehler, Theo de Raadt
706: (OpenBSD), Kurt Jaeger, Dag Erling Smoergrav (FreeBSD),
707: Joerg Sonnenberger (NetBSD), Carsten Kunze (Heirloom troff),
708: Daniel Levai, Fabian Raetz, Jan Stary, Jean-Yves Migeon,
1.11 schwarze 709: Lorenzo Beretta, Markus Waldeck, Maxim Belooussov, Michael Reed,
710: Peter Bray, and Serguey Parkhomovsky for bug reports and feature
711: suggestions.
712: * Alexander Hall, Andrew Fresh, Antoine Jacoutot, Doug Hogan,
713: Jason McIntyre, Jasper Lievisse Adriaanse, Kent Spillner,
714: Nicholas Marriott, Peter Hessler, Sebastien Marie, Stefan Sperling,
715: and Theo de Raadt (OpenBSD) for helpful discussions and feedback.
1.9 schwarze 716:
717: Changes in version 1.13.3, released on March 13, 2015
718:
719: --- MAJOR NEW FEATURES ---
720: * When a manual is missing from an outdated database, let man(1)
721: show it anyway, using a KISS file system lookup as a fallback.
722: * Use this to always provide man(1), even without database support.
723: * Fatal errors no longer exist. If a file can be opened, mandoc
724: will produce some output; at worst, the output may be almost empty.
725: * New -Wunsupp message level.
726: --- POTENTIONALLY SECURITY RELEVANT BUGFIXES ---
727: * Fix a potential write buffer overrun on incomplete string conditionals.
1.22 schwarze 728: http://mandoc.bsd.lv/cgi-bin/cvsweb/roff.c#rev1.241
1.9 schwarze 729: * Fix a potential write buffer overrun on backslash at EOF in a conditional.
1.22 schwarze 730: http://mandoc.bsd.lv/cgi-bin/cvsweb/roff.c#rev1.247
1.9 schwarze 731: * Fix a use after free sometimes hit when validation deletes a block.
1.22 schwarze 732: http://mandoc.bsd.lv/cgi-bin/cvsweb/mdoc_macro.c#rev1.180
1.9 schwarze 733: --- MAJOR FUNCTIONALLY RELEVANT BUGFIXES ---
734: * Let man(1) show manuals for the current architecture by default,
735: and support the MACHINE environment variable.
736: * Fix the man(1) and apropos(1) -m option, it didn't work at all.
737: * Do not spawn a pager when there is no output.
738: * In makewhatis(8), fix detection of hardlinked manuals on platforms
739: having padding in struct inodev (typically 64bit platforms).
740: --- PORTABILITY IMPROVEMENTS ---
741: * Ignore O_CLOEXEC when the operating system doesn't provide it.
742: * Avoid forward reference to enum type which violates ISO C99.
743: * Support homebrew-style linking on Mac OS X.
744: --- MINOR NEW FEATURES ---
745: * lookup: Accept digit+letter and "n" as section names in man(1),
746: and consistently handle digit+letter in file name extensions.
747: * lookup: Speed up -s/-S by using the "mlinks" rather than the "keys" table.
748: * output: Insert horizontal lines between formatted manual pages.
749: * input: New stricter and more resilient UTF-8 parser.
750: * mdoc(7): Refactor block rewinding for simpler and more robust parsing.
751: * man(7): Use the -Ios option when .TH has less than four arguments.
752: * tbl(7): Implement the "center" option.
753: * tbl(7): New option and format parsers, improved in many respects.
754: * roff(7): Basic implementation of the \o escape sequence (overstrike),
755: and improved rendering of overstrikes in PostScript and PDF output.
756: * Message improvements, in particular for, but not restricted to,
757: eqn(7), tbl(7), and wrong numbers of arguments in mdoc(7) and man(7),
758: in various cases also improving output generated by invalid input.
759: * Delete the -V option. It serves no purpose but keeps confusing people.
760: * gmdiff: Minimal support for Heirloom roff.
761: --- RELIABILITY BUGFIXES ---
762: * tbl(7): Fix a read buffer overrun on 'f' at EOL in a layout.
763: * roff(7): Fix a read buffer overrun on incomplete numerical conditions.
764: * mdoc(7): Fix a NULL pointer access on .Nd followed by an explicit block.
765: * mdoc(7): Fix a NULL pointer access on .It Xo without .Xc.
766: * mdoc(7): Fix a NULL pointer access on .Eo without a tail.
767: * mdoc(7): Fix a NULL pointer access in the validation of empty .St macros.
768: * man(7)/tbl(7): Fix a NULL pointer access on .TS right after .TP.
769: * tbl(7): Fix a NULL pointer access on layout lines without any cells.
770: * eqn(7): Fix NULL pointer accesses in the terminal formatter.
771: * roff(7): Fix a NULL pointer access on trailing \s-/\s+ without an argument.
772: * gz: Fix a potential NULL pointer access after waitpid() failure.
773: * roff(7): Don't let the modulo operator divide by zero.
774: * input: Fix an assertion failure on certain invalid UTF-8 input.
775: * terminal output: Allow arbitrary depth of the font stack (assertion fix).
776: * mdoc(7): Fix assertion failures and endless loops on invalid block closing.
777: * mdoc(7): Fix an assertion failure on .Bl .Sm not followed by .It.
778: * mdoc(7): Fix an assertion failure on .Bl -column ... .El .Ta.
779: * tbl(7): Fix assertion failures by macros inside table data,
780: but do not throw away the macro arguments.
781: * Prevent certain kinds of unreasonable input from producing excessive
782: output, in one case caused by unsigned integer underflow.
783: * Fix a potential memory leak in makewhatis(8) on very long filenames.
784: --- MINOR BUGFIXES ---
785: * mdoc(7): Fix parsing of badly nested blocks with multiple identical blocks.
786: * mdoc(7): Support negative indentations for displays and lists.
787: * mdoc(7): Don't mistreat negative .sp arguments as large positive ones.
788: * mdoc(7): Some spacing fixes for .Eo/.Ec.
789: * man(7): Support negative horizontal widths.
790: * man(7): Do not print out invalid .IP arguments.
791: * man(7): Correctly handle scaling units after .PD.
792: * man(7): Support .RE with an argument.
793: * man(7): Fix restoring indentation after .RS with large negative arguments.
794: * tbl(7): Prevent tables from breaking the filling of preceding text.
795: * tbl(7): Fix vertical spacing at the beginning of tables.
796: * tbl(7): Parser and formatter fixes for line drawing and font modifiers.
797: * tbl(7): Correct handling of blank data lines.
798: * eqn(7): Add sometimes missing whitespace before equation output.
799: * roff(7): Fix vertical scaling, most of it was wrong.
800: * roff(7): Slightly improve \w width measurements.
801: * roff(7): Accept the historic aliases \s10 to \s39 for \s(10 to \s(39.
802: * roff(7): Correctly escape quotes when expanding macro arguments.
803: * roff(7): Correctly handle scaling units in numerical expressions,
804: and some other improvements to the parsing of numerical expressions.
805: * roff(7): Three minor fixes with respect to evaluation of conditionals.
806: * roff(7): Let .it accept numerical expressions, not just constants.
807: * mandoc_char(7): Correct some character names and renderings.
1.10 schwarze 808: * If earlier files set a non-zero exit status, never reset it to zero.
1.9 schwarze 809: --- THANKS TO ---
810: * Jonathan Gray (OpenBSD) for yet more testing with afl (the American
811: Fuzzy Lop security fuzzer), again resulting in many bug reports.
812: * Theo de Raadt (OpenBSD) for suggesting the main new feature (man(1) file
813: system lookup) and for reporting an important bug (pager without output).
814: * Theo Buehler for an important bug report (-s/-S slowness)
815: and for proposing a nice new feature (lines between pages).
816: * Jason McIntyre for an important bug report (hardlink detection)
817: and multiple documentation patches.
818: * Pascal Stumpf (OpenBSD) and Alessandro de Laurenzis for
819: important bug reports (architecture and man -m, respectively).
820: * Thomas Klausner (NetBSD) for proposing a new feature (man(7) -Ios),
821: a bug report, and release testing.
822: * Anthony Bentley, Daniel Dickman, Ted Unangst (OpenBSD) and
823: Kristaps Dzonsons (bsd.lv) for source code patches and bug reports.
824: * Christian Weisgerber (OpenBSD) for more than half a dozen bug reports.
825: * Carsten Kunze (Heirloom troff) for bug reports and release testing.
826: * Antoine Jacoutot (OpenBSD) for release testing.
827: * Alexis Hildebrandt (Homebrew), Baptiste Daroussin (FreeBSD),
828: Jonathan Perkin (SmartOS), Pedro Giffuni (FreeBSD), Svyatoslav
829: Mishyn (Crux Linux), Ulrich Spoerlein (FreeBSD), Jan Stary, Patrick
830: Keshishian, Sebastien Marie, and Steffen Nurpmeso for bug reports.
1.7 schwarze 831:
1.8 schwarze 832: Changes in version 1.13.2, released on December 13, 2014
1.7 schwarze 833:
834: --- MAJOR NEW FEATURES ---
835: * Include an implementation of man(1), the manual page viewer.
836: * Unified set of command line option, each one supported by all
837: command names, including new options -a (format all), -c (no
838: pager), -h (synopsis only), and -w (list filenames).
839: * Support the MANPAGER and PAGER environment variables.
840: * Support gzip'ed manuals by the whole toolset, even as .so targets.
841: * Support UTF-8 and Latin-1 input by the whole toolset, delete preconv(1).
842: * Switch the default output mode from -Tascii to -Tlocale.
843: * Improve -Tascii output for Unicode escape sequences.
844: * Let the -Thtml output mode produce polyglot HTML5.
845: * Many improvements for eqn(7), in particular in-line equations,
846: MathML output in -Thtml mode, and much improved terminal formatting.
847: --- PORTABILITY IMPROVEMENTS ---
848: * Change the build sequence to the usual ./configure; make; make install.
849: * Support ./configure.local for build customizations.
850: * Autodetect wchar, sqlite3, and manpath support.
851: * Provide a fallback version of fts(3) for systems lacking it.
852: * Support choosing alternative binary and manual names.
853: --- MINOR NEW FEATURES ---
854: * Rudimentary implementation of the e, x, and z tbl(7) layout
855: modifiers to equalize, maximize, and ignore the width of columns.
856: * Implement font modifiers in tbl(7) layouts.
857: * Allow comma-separated options in the tbl(7) options line.
858: * Parse and ignore the .pl (page length) roff(7) request.
859: * Implement .An -[no]split for the mdoc(7) -Thtml output mode.
860: * Support bold italic font in PostScript and PDF output.
861: * Warn about commas in function arguments and parentheses in function names.
862: * Warn about botched .Xr ordering and punctuation below SEE ALSO.
863: * Warn about AUTHORS sections without .An macros.
864: * Warn about attempts to call non-callable macros.
865: * New developer documentation manual page mandoc_headers(3).
866: --- BUGFIXES ---
867: * Fix read buffer overrun sometimes triggered by trailing whitespace.
868: * Fix read buffer overrun triggered by certain invalid \H sequences.
869: * Fix NULL pointer access triggered by .Bl without any arguments.
870: * Fix NULL pointer access triggered by .It Nm Fo without .Fc.
871: * Fix NULL pointer access triggered by .Sh Xo .Sh without .Xc.
872: * Fix NULL pointer access triggered by missing .Nm.
873: * Fix an assertion triggered by .It right after .El.
874: * Fix an assertion triggered by .Ec without preceding .Eo.
875: * Fix an assertion triggered by .Sm or .Db with multiple arguments.
876: * Fix assertion failures triggered by very large width arguments.
877: * Fix a division by zero in the roff(7) parser.
878: * Prevent negative arguments to .ll from causing integer underflow.
879: * Correctly autodetect source format even when .Dd is preceded by .ll.
880: * Multiple fixes with respect to .Bd and .Bl -offset and -width.
881: * Many bugfixes with respect to scaling units.
882: * Multiple fixes with respect to delimiter handling by in-line macros.
883: * Multiple fixes with respect to .Pf.
884: * Make \c work properly in no-fill mode.
885: * Stricter syntax checking of Unicode character names.
886: --- THANKS TO ---
887: * Kristaps Dzonsons for rewriting the eqn(7) parser, implementing
888: HTML5 and MathML output, and various other code contributions.
889: * Jonathan Gray (OpenBSD) for extensive testing with afl (the
890: American Fuzzy Lop security fuzzer) resulting in many bug reports.
891: * Anthony Bentley (OpenBSD), Baptiste Daroussin (FreeBSD), Daniel
892: Dickman, Doug Hogan, Jason McIntyre, Theo de Raadt (OpenBSD),
893: and Martin Natano for source code patches.
894: * Carsten Kunze (Heirloom troff), Daniel Levai (Slackware),
895: Garrett D'Amore (illumos), Giovanni Becchis, Matthew Dempsky,
896: Stuart Henderson, Ted Unangst, Todd Miller (OpenBSD), Thomas
897: Klausner (NetBSD), Ulrich Spoerlein (FreeBSD), Justin Haynes,
898: Marcus Merighi, Sebastien Marie, Steffen Nurpmeso and Theo Buehler
899: for bug reports.
1.5 schwarze 900:
901: Changes in version 1.13.1, released on August 10, 2014
902:
903: --- MAJOR NEW FEATURES ---
904: * A complete apropos(1)/makewhatis(8)/man.cgi(8) suite
905: based on SQLite3 is now included.
906: * The roff(7) parser now provides an almost complete implementation
907: of numerical expressions.
908: * Warning and error messages have been improved in many ways.
909: Almost all fatal errors were downgraded to normal errors and some
910: even to warnings. Almost all messages now mention the macro where
911: the issue is detected and many indicate the workaround employed.
912: The mandoc(1) manual now includes a list explaining all messages.
913: --- MINOR NEW FEATURES ---
914: * The roff(7) parser now supports the .ami (append to macro with
915: indirectly specified name), .as (append to user-defined
916: string), .dei (define macro with indirectly specified name),
917: .ll (line length), and .rr (remove register) requests.
918: * The roff(7) parser now supports string comparison and numerical
919: conditionals in the .if and .ie requests.
920: * The roff parser now fully supports the \B (validate numerical
921: expression) and partially supports the \w (measure text width)
922: escape sequences.
923: * The terminal formatter now supports the \: (optional line break)
924: escape sequence.
925: * The roff parser now supports expansion of user-defined strings
926: involving indirect references.
927: * The roff(7) parser now handles some pre-defined read-only
928: number registers that occur in the pod2man(1) preamble.
929: * For backward compatibility, the mdoc(7) parser and formatters
930: now support the obsolete macros .En, .Es, .Fr, and .Ot.
931: * The mdoc(7) formatter non partially supports .Bd -centered.
932: * tbl(7) now handles leading and trailing vertical lines.
933: * The build system now provides fallback versions of strcasestr(3)
934: and strsep(3) for systems lacking them.
935: * The mdoc(7) manual now explains how various standards
936: supported by the .St macro are related to each other.
937: --- BUGFIXES ---
938: * In the roff(7) parser, several bugs were fixed with respect
939: to closing conditional blocks on macro lines.
940: * Parsing of roff(7) identifiers and escape sequences was improved
941: in multiple respects.
942: * In the mdoc(7) parser, the handling of defective document
943: prologues was improved in multiple ways.
944: * The mdoc(7) parser no longer skips content before the first section
945: header, and it no longer deletes non-.% content from .Rs blocks.
946: * In the mdoc(7) parser, a crash was fixed related to weird .Sh headers.
947: * In the mdoc(7) parser, handling of .Sm with missing or invalid
948: arguments was corrected.
949: * In the mdoc(7) parser, trailing punctuation at the end of partial
950: implicit macros no longer triggers end-of-sentence spacing.
951: * In the terminal formatter, two crashes were fixed: one triggered by
952: excessive indentation and another by excessively long .Nm arguments.
953: * In the terminal formatter, a floating point rounding bug was
954: fixed that sometimes caused an off-by-one error in indentation.
955: * In the UTF-8 formatter, rendering of accents, breakable hyphens,
956: and non-breakable spaces was corrected.
957: * In the HTML formatter, encoding of special characters was
958: corrected in multiple respects.
959: * In the mdoc(7) formatter, rendering of .Ex and .Rv was
960: improved for various edge cases.
961: * In the mdoc(7) formatter, handling of empty .Bl -inset item
962: heads was improved.
963: * In the man(7) formatter, some bugs were fixed with respect
964: to same-line detection in the context of .TP and .nf macros,
965: and the indentation of .IP and .TP blocks was improved.
966: * The mandoc(3) library no longer prints to stderr.
967: --- THANKS TO ---
968: Abhinav Upadhyay (NetBSD), Andreas Voegele, Anthony Bentley (OpenBSD),
969: Christian Weisgerber (OpenBSD), Havard Eidnes (NetBSD), Jan Stary,
970: Jason McIntyre (OpenBSD), Jeremie Courreges-Anglas (OpenBSD),
971: Joerg Sonnenberger (NetBSD), Juan Francisco Cantero Hurtado (OpenBSD),
972: Marc Espie (OpenBSD), Matthias Scheler (NetBSD), Pascal Stumpf (OpenBSD),
973: Paul Onyschuk (Alpine Linux), Sebastien Marie, Steffen Nurpmeso,
974: Stuart Henderson (OpenBSD), Ted Unangst (OpenBSD), Theo de Raadt (OpenBSD),
975: Thomas Klausner (NetBSD), and Ulrich Spoerlein (FreeBSD)
976: for reporting bugs and missing features.
1.4 schwarze 977:
978: Changes in version 1.12.3, released on December 31, 2013
979:
980: * In the mdoc(7) SYNOPSIS, line breaks and hanging indentation
981: now work correctly for .Fo/.Fa/.Fc and .Fn blocks.
982: Thanks to Franco Fichtner for doing part of the work.
983: * The mdoc(7) .Bk macro got some addititonal bugfixes.
984: * In mdoc(7) macro arguments, double quotes can now be quoted
985: by doubling them, just like in man(7).
986: Thanks to Tsugutomo ENAMI for the patch.
987: * At the end of man(7) macro lines, end-of-sentence spacing
988: now works. Thanks to Franco Fichtner for the patch.
989: * For backward compatibility, the man(7) parser now supports the
990: man-ext .UR/.UE (uniform resource identifier) block macros.
991: * The man(7) parser now handles closing blocks that are not open
992: more gracefully.
993: * The man(7) parser now ignores blank lines right after .SH and .SS.
994: * In the man(7) formatter, reset indentation when leaving a block,
995: not just when entering the next one.
996: * The roff(7) .nr request now supports incrementing and decrementing
997: number registers and stops parsing the number right before the
998: first non-digit character.
999: * The roff(7) parser now supports the alternative escape sequence
1000: syntax \C'uXXXX' for Unicode characters.
1001: * The roff(7) parser now parses and ignores the .fam (font family)
1002: and .hw (hyphenation points) requests and the \d and \u escape
1003: sequences.
1004: * The roff(7) manual got a new ESCAPE SEQUENCE REFERENCE.
1.1 schwarze 1005:
1.2 schwarze 1006: Changes in version 1.12.2, released on Oktober 5, 2013
1.1 schwarze 1007:
1008: * The mdoc(7) to man(7) converter, to be called as mandoc -Tman,
1009: is now fully functional.
1010: * The mandoc(1) utility now supports the -Ios (default operating system)
1011: input option, and the -Tutf8 output mode now actually works.
1012: * The mandocdb(8) utility no longer truncates existing databases when
1013: starting to build new ones, but only replaces them when the build
1014: actually succeeds.
1015: * The man(7) parser now supports the PD macro (paragraph distance),
1016: and (for GNU man-ext compatibility only) EX (example block) and EE
1017: (example end). Plus several bugfixes regarding indentation, line
1018: breaks, and vertical spacing, and regarding RS following TP.
1019: * The roff(7) parser now supports the \f(BI (bold+italic) font escape,
1020: the \z (zero cursor advance) escape and the cc (change control
1021: character) and it (input line trap) requests. Plus bugfixes regarding
1022: the \t (tab) escape, nested escape sequences, and conditional requests.
1023: * In mdoc(7), several bugs were fixed related to UTF-8 output of quoting
1024: enclosures, delimiter handling, list indentation and horizontal and
1025: vertical spacing, formatting of the Lk, %U, and %C macros, plus some
1026: bugfixes related to the handling of syntax errors like badly nested
1027: font blocks, stray Ta macros outside column lists, unterminated It Xo
1028: blocks, and non-text children of Nm blocks.
1029: * In tbl(7), the width of horizontal spans and the vertical spacing
1030: around tables was corrected, and in man(7) files, a crash was fixed
1031: that was triggered by some particular unclosed T{ macros.
1032: * For mandoc developers, we now provide a tbl(3) library manual and
1033: gmdiff, a very small, very simplistic groff-versus-mandoc output
1034: comparison tool.
1.2 schwarze 1035: * Provide this NEWS file.
1.1 schwarze 1036:
1037: Changes in version 1.12.1, released on March 23, 2012
1038:
1039: * Significant work on apropos(1) and mandocdb(8). These tools are now
1040: much more robust. A whatis(1) implementation is now handled as an
1041: apropos(1) mode. These tools are also able to minimally handle
1042: pre-formatted pages, that is, those already formatted by another
1043: utility such as GNU troff.
1044: * The man.cgi(7) script is also now available for wider testing.
1045: It interfaces with mandocdb(8) manuals cached by catman(8).
1046: HTML output is generated on-the-fly by libmandoc or internal
1047: methods to convert pre-formatted pages.
1048: * The mailing list archive for the discuss and tech lists are being
1049: hosted by Gmane at gmane.comp.tools.mdocml.user and
1050: gmane.comp.tools.mdocml.devel, respectively.
1051:
1052: Changes in version 1.12.0, released on October 8, 2011
1053:
1054: * This version features a new, work-in-progress mandoc(1) output mode:
1055: -Tman. This mode allows a system maintainer to distribute man(7)
1056: media for older systems that may not natively support mdoc(7), such
1057: as old Solaris systems.
1058: * The -Ofragment option was added to mandoc(1)'s -Thtml and -Txhtml modes.
1059: * While adding features, an apropos(1) utility has been merged from the
1060: mandoc-tools sandbox. This interfaces with mandocdb(8) for semantic
1061: search of manual content. apropos(1) is different from the traditional
1062: apropos primarily in allowing keyword search (such as for functions,
1063: utilities, etc.) and regular expressions. Note that the calling
1064: syntax for apropos is likely to change as it settles down.
1065: * In documentation news, the mdoc(7) and man(7) manuals have been
1066: made considerably more readable by adding MACRO OVERVIEW sections, by
1067: moving the gory details of the LANGUAGE SYNTAX to the roff(7) manual,
1068: and by moving the very technical MACRO SYNTAX sections down to the
1069: bottom of the page.
1070: * Furthermore, for tbl(7), the -Tascii mode horizontal spacing of tables
1071: was rewritten completely. It is now compatible with groff(1), both
1072: with and without frames and rulers.
1073: * Nesting of indented blocks is now supported in man(7), and several
1074: bugs were fixed regarding indentation and alignment.
1075: * The page headers in mdoc(7) are now nicer for very long titles.
1076:
1077: Changes in version 1.11.7, released on September 2, 2011
1078:
1079: * Added demandoc(1) utility for stripping away macros and escapes.
1080: This replaces the historical deroff(1) utility.
1081: * Also improved the mdoc(7) and man(7) manuals.
1082:
1083: Changes in version 1.11.6, released on August 16, 2011
1084:
1085: * Handling of tr macro in roff(7) implemented. This makes Perl
1086: documentation much more readable. Hyphenation is also now enabled in
1087: man(7) format documents. Many other general improvements have been
1088: implemented.
1089:
1090: Changes in version 1.11.5, released on July 24, 2011
1091:
1092: * Significant eqn(7) improvements. mdocml can now parse arbitrary eqn
1093: input (although few GNU extensions are accepted, nor is mixing
1094: low-level roff with eqn). See the eqn(7) manual for details.
1095: For the time being, equations are rendered as simple in-line text.
1096: The equation parser satisfies the language specified in the
1097: Second Edition User's Guide:
1098: http://www.kohala.com/start/troff/v7man/eqn/eqn2e.ps
1099:
1100: Changes in version 1.11.4, released on July 12, 2011
1101:
1102: * Bug-fixes and clean-ups across all systems, especially in mandocdb(8)
1103: and the man(7) parser. This release was significantly assisted by
1104: participants in OpenBSD's c2k11. Thanks!
1105:
1106: Changes in version 1.11.3, released on May 26, 2011
1107:
1108: * Introduce locale-encoding of output with the -Tlocale output option and
1109: Unicode escaped-character input. See mandoc(1) and mandoc_char(7),
1110: respectively, for details. This allows for non-ASCII characters (e.g.,
1111: \[u5000]) to be rendered in the locale's encoding, if said environment
1112: supports wide-character encoding (if it does not, -Tascii is used
1113: instead). Locale support can be turned off at compile time by removing
1114: -DUSE_WCHAR in the Makefile, in which case -Tlocale is always a synonym
1115: for -Tascii.
1116: * Furthermore, multibyte-encoded documents, such as those in UTF-8, may
1117: be on-the-fly recoded into mandoc(1) input by using the newly-added
1118: preconv(1) utility. Note: in the future, this feature may be
1119: integrated into mandoc(1).
1120:
1121: Changes in version 1.11.2, released on May 12, 2011
1122:
1123: * Corrected some installation issues in version 1.11.1.
1124: * Further migration to libmandoc.
1125: * Initial public release (this utility is very much under development)
1126: of mandocdb(8). This utility produces keyword databases of manual
1127: content, which features semantic querying of manual content.
1128:
1129: Changes in version 1.11.1, released on April 4, 2011
1130:
1131: * The earlier libroff, libmdoc, and libman soup have been merged into
1132: a single library, libmandoc, which manages all aspects of parsing
1133: real manuals, from line-handling to tbl(7) parsing.
1134: * As usual, many general fixes and improvements have also occurred.
1135: In particular, a great deal of redundancy and superfluous code has
1136: been removed with the merging of the backend libraries.
1.3 schwarze 1137: * see also the changes in 1.10.10
1138:
1139: Changes in version 1.10.10, March 20, 2011, NOT released
1140:
1141: * Initial eqn(7) functionality is in place. For the time being,
1142: this is limited to the recognition of equation blocks;
1143: future version of mdocml will expand upon this framework.
1.1 schwarze 1144:
1145: Changes in version 1.10.9, released on January 7, 2011
1146:
1147: * Many back-end fixes have been implemented: argument handling (quoting),
1148: man(7) improvements, error/warning classes, and many more.
1149: * Initial tbl(7) functionality (see the "TS", "TE", and "T&" macros in
1150: the roff(7) manual) has been merged from tbl.bsd.lv. Output is still
1151: minimal, especially for -Thtml and -Txhtml, but manages to at least
1152: display data. This means that mandoc(1) now has built-in support
1153: for two troff preprocessors via libroff: soelim(1) and tbl(1).
1154:
1155: Changes in version 1.10.8, released on December 24, 2010
1156:
1.3 schwarze 1157: * Overhauled the -Thtml and -Txhtml output modes. They now display
1.1 schwarze 1158: readable output in arbitrary browsers, including text-based ones like
1159: lynx(1). See HTML and XHTML manuals in the DOCUMENTATION section
1160: for examples. Attention: available style-sheet classes have been
1161: considerably changed! See the example.style.css file for details.
1162: Lastly, libmdoc and libman have been cleaned up and reduced in size
1163: and complexity.
1.3 schwarze 1164: * see also the changes in 1.10.7
1165:
1166: Changes in version 1.10.7, December 6, 2010, NOT released
1167:
1168: Significant improvements merged from OpenBSD downstream, including:
1169: * many new roff(7) components,
1170: * in-line implementation of troff's soelim(1),
1171: * broken-block handling,
1172: * overhauled error classifications, and
1173: * cleaned up handling of error conditions.
1.1 schwarze 1174:
1175: Changes in version 1.10.6, released on September 27, 2010
1176:
1177: * Calling conventions for mandoc(1) have changed: -W improved and -f
1178: deprecated.
1179: * Non-ASCII characters are also now uniformly discarded.
1180: * Lots of documentation improvements.
1181: * Many incremental fixes accomodating for groff's more interesting
1182: productions.
1183: * Lastly, pod2man(1) preambles are now fully accepted after some
1184: considerable roff(7) and special character support.
1185:
1186: Changes in version 1.10.5, released on July 27, 2010
1187:
1188: * Primarily a bug-fix and polish release, but including -Tpdf support
1189: in mandoc(1) by way of "Summer of Code". Highlights:
1190: * fix "Sm" and "Bd" handling
1191: * fix end-of-sentence handling for embedded sentences
1192: * polish man(7) documentation
1193: * document all mdoc(7) macros
1194: * polish mandoc(1) -Tps output
1195: * lots of internal clean-ups in character escapes
1196: * un-break literal contexts in man(7) documents
1197: * improve -Thtml output for -man
1198: * add mandoc(1) -Tpdf support
1199:
1200: Changes in version 1.10.4, released on July 12, 2010
1201:
1202: * Lots of features developed during both "Summer of Code" and the
1203: OpenBSD c2k10 hackathon:
1204: * minimal "ds" roff(7) symbols are supported
1205: * beautified SYNOPSIS section output
1206: * acceptance of scope-block breakage in mdoc(7)
1207: * clarify error message status
1208: * many minor bug-fixes and formatting issues resolved
1.3 schwarze 1209: * see also changes in 1.10.3
1210:
1211: Changes in version 1.10.3, June 29, 2010, NOT released
1212:
1213: * variable font-width and paper-size support in mandoc(1) -Tps output
1214: * "Bk" mdoc(7) support
1.1 schwarze 1215:
1216: Changes in version 1.10.2, released on June 19, 2010
1217:
1218: * Small release featuring text-decoration in -Tps output,
1219: a few minor relaxations of errors, and some optimisations.
1220:
1221: Changes in version 1.10.1, released on June 7, 2010
1222:
1223: * This primarily focusses on the "Bl" and "It" macros described in
1224: mdoc(7). Multi-line column support is now fully compatible with groff,
1225: as are implicit list entries for columns.
1226: * Removed manuals(7) in favour of http://manpages.bsd.lv.
1227: * The way we handle the SYNOPSIS section (see the SYNOPSIS documentation
1228: in MANUAL STRUCTURE) has also been considerably simplified compared
1229: to groff's method.
1230: * Furthermore, the -Owidth=width output option has been added to -Tascii,
1231: see mandoc(1).
1232: * Lastly, initial PostScript output has been added with the -Tps option
1233: to mandoc(1). It's brutally simple at the moment: fixed-font, with no
1234: font decorations.
1235:
1236: Changes in version 1.10.0, released on May 29, 2010
1237:
1238: * Release consisting of the results from the m2k10 hackathon and up-merge
1239: from OpenBSD. This requires a significant note of thanks to Ingo
1240: Schwarze (OpenBSD) and Joerg Sonnenberger (NetBSD) for their hard work,
1241: and again to Joerg for hosting m2k10. Highlights (mostly cribbed from
1242: Ingo's m2k10 report) follow in no particular order:
1243: * a libroff preprocessor in front of libmdoc and libman stripping out
1244: roff(7) instructions;
1245: * end-of-sentence (EOS) detection in free-form and macro lines;
1246: * correct handling of tab-separated columnar lists in mdoc(7);
1247: * improved main calling routines to optionally use mmap(3) for better
1248: performance;
1249: * cleaned up exiting when invoked as -Tlint or over multiple files
1250: with -fign-errors;
1251: * error and warning message handling re-written to be unified for
1252: libroff, libmdoc, and libman;
1253: * handling of badly-nested explicit-scoped macros;
1254: * improved free-form text parsing in libman and libmdoc;
1255: * significant GNU troff compatibility improvements in -Tascii,
1256: largely in terms of spacing;
1257: * a regression framework for making sure the many fragilities of GNU
1258: troff aren't trampled in subsequent work;
1259: * support for -Tascii breaking at hyphens encountered in free-form text;
1260: * and many more minor fixes and improvements
1261:
1262: Changes in version 1.9.25, released on May 13, 2010
1263:
1264: * Fixed handling of "\*(Ba" escape.
1265: * Backed out -fno-ign-chars (pointless complexity).
1266: * Fixed erroneous breaking of literal lines.
1267: * Fixed SYNOPSIS breaking lines before non-initial macros.
1268: * Changed default section ordering.
1269: * Most importantly, the framework for end-of-sentence double-spacing is
1270: in place, now implemented for the "end-of-sentence, end-of-line" rule.
1271: * This is a stable roll-back point before the mandoc hackathon in Rostock!
1272:
1273: Changes in version 1.9.24, released on May 9, 2010
1274:
1275: * Rolled back break-at-hyphen.
1276: * -DUGLY is now the default (no feature splits!).
1277: * Free-form text is not de-chunked any more: lines are passed
1278: whole-sale into the front-end, including whitespace.
1279: * Added mailing lists.
1280:
1281: Changes in version 1.9.23, released on April 7, 2010
1282:
1283: * mdocml has been linked to the OpenBSD build.
1284: * This version incorporates many small changes, mostly from patches
1285: by OpenBSD, allowing crufty manuals to slip by with warnings instead
1286: of erroring-out.
1287: * Some subtle semantic issues, such as punctuation scope, have also
1288: been fixed.
1289: * Lastly, some issues with -Thtml have been fixed, which prompted an
1290: update to the online manual pages style layout.
1291:
1292: Changes in version 1.9.22, released on March 31, 2010
1293:
1294: * Adjusted merge of the significant work by Ingo Schwarze
1295: in getting "Xo" blocks (block full implicit, e.g., "It"
1296: for non-columnar lists) to work properly. This isn't
1297: enabled by default: you must specify -DUGLY as a compiler
1298: flag (see the Makefile for details).
1299:
1300: Changes in version 1.9.20, released on March 30, 2010
1301:
1302: * More efforts to get roff instructions in man(7) documents under
1303: control. Note that roff instructions embedded in line-scoped,
1304: next-line macros (e.g. "B") are not supported.
1305: * Leading punctuation for mdoc(7) macros, such as "Fl ( ( a",
1306: are now correctly handled.
1307:
1308: Changes in version 1.9.18, released on March 27, 2010
1309:
1310: * Many fixes (largely pertaining to scope)
1311: and improvements (e.g., handling of apostrophe-control macros,
1312: which fixes the strange "BR" seen in some macro output)
1313: to handling roff instructions in man(7) documents.
1314:
1315: Changes in version 1.9.17, released on March 25, 2010
1316:
1317: * Accept perlpod(1) standard preamble.
1318: * Also accept (and discard) "de", "dei", "am", "ami", and "ig"
1319: roff macro blocks.
1320:
1321: Changes in version 1.9.16, released on March 22, 2010
1322:
1323: * Inspired by patches and bug reports by Ingo Schwarze,
1324: allowed man(7) to accept non-printing elements to be nested
1325: within next-line scopes, such as "br" within "B" or "TH",
1326: which is valid roff.
1327: * Longsoon architecture also noted and Makefile cleaned up.
1328:
1329: Changes in version 1.9.15, released on February 18, 2010
1330:
1331: * Moved to our new BSD.lv home.
1332: * XHTML is now an acceptable output mode for mandoc(1);
1333: * "Xr" made more compatible with groff;
1334: * "Vt" fixed when invoked in SYNOPSIS;
1335: * "\\" escape removed;
1336: * end-of-line white-space detected for all lines;
1337: * subtle bug fixed in list display for some modes;
1338: * compatibility layer checked in for compilation in diverse
1339: UNIX systems;
1340: * and column lengths handled correctly.
1341:
1342: For older releases, see the ChangeLog files
1.22 schwarze 1343: in http://mandoc.bsd.lv/snapshots/ .
CVSweb