#
60395358 |
| 05-Jan-2025 |
schwarze <schwarze@openbsd.org> |
In the tbl(7) layout parser, use the roff(7) numerical expression parser to support arithmetic operations in column width modifiers.
Documentation authors ought to focus on semantic markup and avoid
In the tbl(7) layout parser, use the roff(7) numerical expression parser to support arithmetic operations in column width modifiers.
Documentation authors ought to focus on semantic markup and avoid trying to manipulate presentational details. Consequently, using tbl(7) is discouraged in the first place, using column width modifiers even more so, and complicating them by performing arithmetics yet more so.
However, the madhouse called DocBook relies on this feature. For example, DocBook XSL version 1.79.2 generates man(7)+tbl(7) code that abuses arithmetics in column width modifiers to format things as simple and mundane as numbered lists, resulting in atrocious layout that is very hard to read. Last year, tb@ reported git-reset(1) as an example of an affected manual page.
Properly parsing the width in the tbl(7) parser allows removal of some incomplete ad-hoc parsing from the tbl(7) formatter, where it didn't really belong.
show more ...
|
#
943fb9d8 |
| 04-Jul-2017 |
schwarze <schwarze@openbsd.org> |
Messages of the -Wbase level now print STYLE:. Since this causes horrible churn anyway, profit of the opportunity to stop excessive testing, such that this is hopefully the last instance of such chu
Messages of the -Wbase level now print STYLE:. Since this causes horrible churn anyway, profit of the opportunity to stop excessive testing, such that this is hopefully the last instance of such churn. Consistently use OpenBSD RCS tags, blank .Os, blank fourth .TH argument, and Mdocdate like everywhere else. Use -Ios=OpenBSD for platform-independent predictable output.
show more ...
|