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--
(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.