NetBSD Problem Report #42222

From reed@reedmedia.net  Sat Oct 24 11:08:00 2009
Return-Path: <reed@reedmedia.net>
Received: from mail.netbsd.org (mail.netbsd.org [204.152.190.11])
	by www.NetBSD.org (Postfix) with ESMTP id 296CD63B877
	for <gnats-bugs@gnats.NetBSD.org>; Sat, 24 Oct 2009 11:08:00 +0000 (UTC)
Message-Id: <54-1256382478@reedmedia.net>
Date: Sat, 24 Oct 2009 06:07:59 -0500
From: reed@reedmedia.net
Reply-To: reed@reedmedia.net
To: gnats-bugs@gnats.NetBSD.org
Subject: man use tbl
X-Send-Pr-Version: 3.95

>Number:         42222
>Category:       bin
>Synopsis:       man when viewing file not using tbl
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    bin-bug-people
>State:          open
>Class:          sw-bug
>Submitter-Id:   net
>Arrival-Date:   Sat Oct 24 11:10:00 +0000 2009
>Last-Modified:  Wed Nov 18 17:05:02 +0000 2009
>Originator:     reed@reedmedia.net
>Release:        NetBSD
>Organization:
>Environment:
Machine: amd64
>Description:
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.
>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;"
>Fix:


>Audit-Trail:
From: "Greg A. Woods" <woods@planix.ca>
To: NetBSD GNATS <gnats-bugs@NetBSD.org>
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 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>       +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--

NetBSD Home
NetBSD PR Database Search

(Contact us) $NetBSD: query-full-pr,v 1.39 2013/11/01 18:47:49 spz Exp $
$NetBSD: gnats_config.sh,v 1.8 2006/05/07 09:23:38 tsutsui Exp $
Copyright © 1994-2007 The NetBSD Foundation, Inc. ALL RIGHTS RESERVED.