Re: bin/42222: man use tbl

["Greg A. Woods" <woods%planix.ca@localhost>]

The following reply was made to PR bin/42222; it has been noted by GNATS.

From: "Greg A. Woods" <woods%planix.ca@localhost>
To: NetBSD GNATS <gnats-bugs%NetBSD.org@localhost>
Cc: 
Subject: Re: bin/42222: man use tbl
Date: Wed, 18 Nov 2009 12:04:45 -0500

 --pgp-sign-Multipart_Wed_Nov_18_12:04:44_2009-1
 Content-Type: text/plain; charset=US-ASCII
 Content-Transfer-Encoding: quoted-printable
 
 At Sat, 24 Oct 2009 11:10:00 +0000 (UTC), reed%reedmedia.net@localhost wrote:
 Subject: bin/42222: man use tbl
 >=20
 > Using man to view manual page which is a file name many need to run tbl.
 > This is for the new man page feature where the filename is on the
 > command line (and not the man page name).
 > I didn't look at source yet, but it appears it needs to detect or
 > know when to run tbl first.
 > If tbl is needed, there is junk and man page is hard to understand.
 
 
 This is (partly) because the ksh(1) manual page source file is not
 installed as the correct filename.  This is an ancient bug, though I'm
 not sure it was ever reported properly -- I had hoped to fix it and send
 the fix, but I've never got around to it.  See below.
 
 The man(1) command correctly invokes tbl(1) to format files with the
 ".tbl" extension of the source filename.
 
 I.e. if the source file is renamed to "ksh.tbl" then man(1) will
 correctly use tbl(1) to format the page, eg. with "man ksh".
 
 See man.conf(5) and /etc/man.conf.
 
 
 > >How-To-Repeat:
 > man /usr/share/man/man1/ksh.1
 > and look at the "Compound" commands section for "center;"
 > or look at "The set command" for "expand;"
 
 I don't know if this will work with the new pathname command-line
 feature or not, but if not then it should be fixed to work that way.
 
 
 > >Fix:
 
 The bigger problem is fixing share/mk/bsd.man.mk so that it correctly
 installs manual page source files with a ".tbl" extension (instead of
 their section number) when necessary (eg. when USETBL is set).
 
 Probably similar fixes are necessary for pgksrc too.
 
 Something should probably be done to properly support soelim with man(1)
 too, though I doubt this is as urgent as I don't think there are any
 existing system manual pages using ".so" directives.  I have one of my
 own in my replacement for newsyslog(1), but I solve that by building the
 final manual page sources as part of the "all" step like this:
 
 SOELIM =3D soelim
 
 .SUFFIXES: .5so .5
 
 .5so.5:
        @rm -f ${.TARGET}
        ${SOELIM} -I ${.CURDIR} ${.IMPSRC} > ${.TARGET} || (rm -f ${.TARGET}; 
exit=
  1)
 
 
 
 Note:  PR# 39822 contains an incorrect analysis and fix for a similar
 problem.
 
 --=20
                                                Greg A. Woods
                                                Planix, Inc.
 
 <woods%planix.com@localhost>       +1 416 218 0099        
http://www.planix.com/
 
 --pgp-sign-Multipart_Wed_Nov_18_12:04:44_2009-1
 Content-Type: application/pgp-signature
 Content-Transfer-Encoding: 7bit
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.4.9 (NetBSD)
 
 iD8DBQBLBCksZn1xt3i/9H8RAnSoAJsFxMIClDQZVQoO8V5A/0atWi3HEACcDWHn
 kg1YhXD8xBvuAgJvDs/SmyE=
 =PLN9
 -----END PGP SIGNATURE-----
 
 --pgp-sign-Multipart_Wed_Nov_18_12:04:44_2009-1--