Re: explanation of first column "v" is hiding
On Tue, Jul 27, 2021 at 07:28:30AM -0400, The Wanderer wrote:
> On 2021-07-27 at 07:25, Greg Wooledge wrote:
> > I would suggest taking the paragraph that describes what the letters
> > mean, which is currently under the "search" subcommand, and doing two
> > things to it:
> >
> > 1) Reformat it as a table.
> > 2) Move it to a separate section, and drop a sentence in the "search"
> > subcommand pointing to it.
> >
> > Then, add that same sentence to the "why" subcommand, and to any other
> > subcommands that have the same single-letter output indicators.
>
> Sounds worth a wishlist bug report, to me (against whatever package it
> is that contains the file which includes the text in question).
>
> If you can come up with a patch that implements this, that would make it
> *far* more likely that the requested change would get implemented.
https://bugs.debian.org/991578
At this point, I am firmly convinced that docbook's table generation
(at least as used by aptitude) is broken beyond repair. There is no
combination of width='...' and colwidth='...' which generates acceptable
output. I am also convinced that everyone else who uses docbook already
knows this, and does not try to use it to generate tables, and this is
why there are no real life examples of docbook man pages with tables
for Google to give me.
So, I gave up and made each table a "variable list" instead.
Reply to: