Re: [PATCH] drop spurious t comment header

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



At 2020-07-24T12:13:33+0200, Michael Kerrisk (man-pages) wrote:
> On Fri, 24 Jul 2020 at 02:03, G. Branden Robinson
> <g.branden.robinson@xxxxxxxxx> wrote:
> > it is a hint to the man
> > program to preprocess the man page text through tbl.
> 
> Yes, that's my understanding. But I believe that these days it's no
> longer needed(?). tbl(1) just gets used as needed, regardless of the
> presence of the 't' comment, right?

[A few "strace -f -e execve"s later...]

Hmm, for the man-db man(1) in Debian bullseye (testing), at least, this
is true!  And checking its own man page, it looks like it was true as
far back as April 2001 (the horizon of its Git history).

I guess there are so many man pages that embed tables without including
the hint that the man-db maintainers decided not to leave the comment to
chance.  The only other man-like program I know if in anything like wide
use on Linux systems is mandoc, which does all its own parsing and
doesn't depend on a *roff at all.

Retaining an accurate comment would be a kindness to other man
implementations I'm not aware of and to weirdos like me who run groff
directly because we develop it (though admittedly, even for us, there is
the crutch of grog(1)).  But I'll grant--these populations may be small.

> See my comments above. For 15 years or at least, I've not paid any
> attention to adding the 't' comments when I added tables to pages, and
> I do recall anyone reporting ill effects. So, I'm inclined to apply
> Mike's patch, but will hold off a moment, in case there's other
> feedback.

Sounds fair.

Regards,
Branden

Attachment: signature.asc
Description: PGP signature


[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux