From owner-freebsd-doc Thu Mar 28 23:20: 6 2002 Delivered-To: freebsd-doc@hub.freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 2F6C837B41B for ; Thu, 28 Mar 2002 23:20:03 -0800 (PST) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id g2T7K3i31943; Thu, 28 Mar 2002 23:20:03 -0800 (PST) (envelope-from gnats) Date: Thu, 28 Mar 2002 23:20:03 -0800 (PST) Message-Id: <200203290720.g2T7K3i31943@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org Cc: From: swear@blarg.net (Gary W. Swearingen) Subject: Re: docs/36456: csh(1) manual references wrong "signal.h". Reply-To: swear@blarg.net (Gary W. Swearingen) Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org The following reply was made to PR docs/36456; it has been noted by GNATS. From: swear@blarg.net (Gary W. Swearingen) To: Giorgos Keramidas Cc: bug-followup@freebsd.org Subject: Re: docs/36456: csh(1) manual references wrong "signal.h". Date: 28 Mar 2002 23:11:35 -0800 Giorgos Keramidas writes: > Why? Anyone who knows enough C to read /usr/include/signal.h can easily > spot the #include that leads to /usr/include/sys/signal.h: Because man page readers might not know any C so he can find the correct file but anyone can easily recognize the list of signals in the correct file. Even C readers, especially if not Unix people familiar with signals, would waste considerable time figuring it out. It took me a while. > But more importantly, csh.1 is hard linked to tcsh.1.gz which comes from > contrib/ source (the source of /usr/src/contrib/tcsh). If any changes are > made to that file, they should probably be made in the tcsh developer's > source and imported to FreeBSD verbatim when a newer version of tcsh is > imported to our source. I suspect that it's wrong because the tcsh developer's layout is different, but that's about all I have to say on it. (If you don't want to fix it one way or the other, I don't see any good reason to not leave it open for someone who cares about this low-priority stuff.) To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message