diff options
author | Ingo Schwarze <schwarze@cvs.openbsd.org> | 2025-01-05 18:03:52 +0000 |
---|---|---|
committer | Ingo Schwarze <schwarze@cvs.openbsd.org> | 2025-01-05 18:03:52 +0000 |
commit | 73bc5c79978b4794869bcb2e2450bfe8405c9a61 (patch) | |
tree | 55187593699e05cd6dfeb959c27e07c71bca15b0 /sys/arch/hppa/include/kcore.h | |
parent | c96cb3bf5d38c36cba7a47077b572ff2e6e9aa3b (diff) |
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.
Diffstat (limited to 'sys/arch/hppa/include/kcore.h')
0 files changed, 0 insertions, 0 deletions