From jb@narayan.borg.pp.se  Sat Feb  9 08:19:50 2002
Return-Path: <jb@narayan.borg.pp.se>
Received: from narayan.borg.pp.se (k3a214-2.kam.afb.lu.se [130.235.57.199])
	by hub.freebsd.org (Postfix) with ESMTP id 9D39F37B41A
	for <FreeBSD-gnats-submit@freebsd.org>; Sat,  9 Feb 2002 08:19:48 -0800 (PST)
Received: (from jb@localhost)
	by narayan.borg.pp.se (8.11.6/8.11.6) id g19GJkX69408;
	Sat, 9 Feb 2002 17:19:46 +0100 (CET)
	(envelope-from jb)
Message-Id: <200202091619.g19GJkX69408@narayan.borg.pp.se>
Date: Sat, 9 Feb 2002 17:19:46 +0100 (CET)
From: Jakob Borg <jakob@borg.pp.se>
Reply-To: Jakob Borg <jakob@borg.pp.se>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: Irrelevant comment in killall(1) manpage
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         34758
>Category:       docs
>Synopsis:       Irrelevant comment in killall(1) manpage
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Feb 09 08:20:01 PST 2002
>Closed-Date:    Sun Feb 10 17:52:45 PST 2002
>Last-Modified:  Mon Feb 11 12:50:01 PST 2002
>Originator:     Jakob Borg
>Release:        FreeBSD 4.5-STABLE i386
>Organization:
None 
>Environment:
System: FreeBSD narayan.borg.pp.se 4.5-STABLE FreeBSD 4.5-STABLE #8: Wed Jan 30 16:46:53 CET 2002 root@narayan.borg.pp.se:/usr/src/sys/compile/NARAYAN i386
>Description:

The manpage for killall(1) says:

       Be warned that  typing  killall  name  may  not  have  the
       desired  effect on non-Linux systems, especially when done
       by a privileged user.

which, while perhaps correct, is not relevant for a FreeBSD system. Also,
the operating system kernel in use at a particular system should not influence
the behavior of killall.

>How-To-Repeat:

man 1 killall

>Fix:

Replace with warning about FreeBSD or non-FreeBSD systems as appropriate, or
rephrase to talk about "... systems with non-GNU killall ..." or the whatever
the correct source for the current killall is.

>Release-Note:
>Audit-Trail:

From: Giorgos Keramidas <keramida@freebsd.org>
To: Jakob Borg <jakob@borg.pp.se>
Cc: bug-followup@freebsd.org
Subject: Re: docs/34758: Irrelevant comment in killall(1) manpage
Date: Sun, 10 Feb 2002 02:36:20 +0200 (EET)

 Jakob Borg wrote:
 
 > The manpage for killall(1) says:
 >
 >        Be warned that  typing  killall  name  may  not  have  the
 >        desired  effect on non-Linux systems, especially when done
 >        by a privileged user.
 >
 > which, while perhaps correct, is not relevant for a FreeBSD system. Also,
 > the operating system kernel in use at a particular system should not influence
 > the behavior of killall.
 
 Well the point the author is trying to make is that on Solaris (and
 probably other systems) typing "killall" in a prompt is a surprise in
 itself, because it REBOOTS the system !!!
 
 You're right that this should exclude Linux systems only though :-)
 
 
 Giorgos Keramidas                           FreeBSD Documentation Project
 keramida@{freebsd.org,ceid.upatras.gr}      http://www.FreeBSD.org/docproj/
 

From: "Jakob Borg" <jakob@borg.pp.se>
To: Giorgos Keramidas <keramida@freebsd.org>
Cc: bug-followup@freebsd.org
Subject: Re: docs/34758: Irrelevant comment in killall(1) manpage
Date: Sun, 10 Feb 2002 11:33:00 +0100

 On Sunday 10 February 2002 01.36, you wrote:
 > Jakob Borg wrote:
 > > The manpage for killall(1) says:
 > >
 > >        Be warned that  typing  killall  name  may  not  have  the
 > >        desired  effect on non-Linux systems, especially when done
 > >        by a privileged user.
 > >
 > > which, while perhaps correct, is not relevant for a FreeBSD system.
 > > Also, the operating system kernel in use at a particular system should
 > > not influence the behavior of killall.
 >
 > Well the point the author is trying to make is that on Solaris (and
 > probably other systems) typing "killall" in a prompt is a surprise in
 > itself, because it REBOOTS the system !!!
 
 It does what the command says, yes, I know, been there, done that in my 
 youth... My point was just that the Linuxness or non-Linuxness is not the 
 point, since it's FreeBSD wer're talking about.
 
 -- 
 Jakob Borg  |  jakob@borg.pp.se  |  +46 (0)46 397692
 Kmnrsv. 3a214 / SE-226 46 Lund / Sweden
State-Changed-From-To: open->closed 
State-Changed-By: keramida 
State-Changed-When: Sun Feb 10 17:52:45 PST 2002 
State-Changed-Why:  
The killall.1 manpage does not seem to contain the text posted. 
Are you sure this was on a 4.5-STABLE FreeBSD system? 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=34758 

From: Peter Pentchev <roam@ringlet.net>
To: "Gary W. Swearingen" <swear@blarg.net>
Cc: Jakob Borg <jakob@borg.pp.se>, bug-followup@FreeBSD.org,
	Giorgos Keramidas <keramida@FreeBSD.ORG>
Subject: Re: docs/34758: Irrelevant comment in killall(1) manpage
Date: Mon, 11 Feb 2002 10:50:58 +0200

 On Sun, Feb 10, 2002 at 06:33:29PM -0800, Gary W. Swearingen wrote:
 > Giorgos Keramidas <keramida@FreeBSD.ORG> writes:
 > 
 > > Date: Sun, 10 Feb 2002 02:36:20 +0200 (EET)
 > > 
 > >  Jakob Borg wrote:
 > >  
 > >  > The manpage for killall(1) says:
 > >  >
 > >  >        Be warned that  typing  killall  name  may  not  have  the
 > >  >        desired  effect on non-Linux systems, especially when done
 > >  >        by a privileged user.
 > >  >
 > >  > which, while perhaps correct, is not relevant for a FreeBSD system. Also,
 > >  > the operating system kernel in use at a particular system should not influence
 > >  > the behavior of killall.
 > >  
 > >  Well the point the author is trying to make is that on Solaris (and
 > >  probably other systems) typing "killall" in a prompt is a surprise in
 > >  itself, because it REBOOTS the system !!!
 > 
 > 1) The PR says it's on "FreeBSD 4.5-STABLE i386", but
 > http://www.FreeBSD.org/cgi/man.cgi?query=killall&apropos=0&sektion=0&manpath=FreeBSD+4.5-STABLE&format=html
 > doesn't have the text quoted.  (I was wanting to look at a different
 > display format.)  Is there a problem with with the CGI thing or with
 > the PR or me?
 
 This is a fun one: I guess the submitter made the same mistake I did
 once before.  The manual page in question, containing the Linux-specific
 text, comes from the sysutils/psmisc port :)  This is not a FreeBSD
 problem, this is a problem of the psmisc package and should be brought
 up with the psmisc author, Werner Almesberger
 <werner.almesberger@lrc.di.epfl.ch>.
 
 G'luck,
 Peter
 
 -- 
 Peter Pentchev	roam@ringlet.net	roam@FreeBSD.org
 PGP key:	http://people.FreeBSD.org/~roam/roam.key.asc
 Key fingerprint	FDBA FD79 C26F 3C51 C95E  DF9E ED18 B68D 1619 4553
 Thit sentence is not self-referential because "thit" is not a word.

From: "Jakob Borg" <jakob@borg.pp.se>
To: Peter Pentchev <roam@ringlet.net>,
	"Gary W. Swearingen" <swear@blarg.net>
Cc: bug-followup@FreeBSD.org,
	Giorgos Keramidas <keramida@FreeBSD.org>
Subject: Re: docs/34758: Irrelevant comment in killall(1) manpage
Date: Mon, 11 Feb 2002 11:08:21 +0100

 On Monday 11 February 2002 09.50, Peter Pentchev wrote:
 
 > This is a fun one: I guess the submitter made the same mistake I did
 > once before.  The manual page in question, containing the Linux-specific
 > text, comes from the sysutils/psmisc port :)  This is not a FreeBSD
 > problem, this is a problem of the psmisc package and should be brought
 > up with the psmisc author, Werner Almesberger
 > <werner.almesberger@lrc.di.epfl.ch>.
 
 Indeed this seems to be the case. Thank you for clearing it up.
 
 -- 
 Jakob Borg  |  jakob@borg.pp.se  |  +46 (0)46 397692
 Kmnrsv. 3a214 / SE-226 46 Lund / Sweden

From: swear@blarg.net (Gary W. Swearingen)
To: rantapaa@uswest.net
Cc: Peter Pentchev <roam@ringlet.net>,
	"Jakob Borg" <jakob@borg.pp.se>, bug-followup@FreeBSD.org,
	Giorgos Keramidas <keramida@FreeBSD.org>
Subject: Re: docs/34758: Irrelevant comment in killall(1) manpage
Date: 11 Feb 2002 09:38:49 -0800

 "Jakob Borg" <jakob@borg.pp.se> writes:
 
 > On Monday 11 February 2002 09.50, Peter Pentchev wrote:
 > 
 > > This is a fun one: I guess the submitter made the same mistake I did
 > > once before.  The manual page in question, containing the Linux-specific
 > > text, comes from the sysutils/psmisc port :)  This is not a FreeBSD
 > > problem, this is a problem of the psmisc package and should be brought
 > > up with the psmisc author, Werner Almesberger
 > > <werner.almesberger@lrc.di.epfl.ch>.
 > 
 > Indeed this seems to be the case. Thank you for clearing it up.
 
 From pkg-comment:
     A port of the Linux pstree, killall and pidof commands
 
 It seems wrong to ask the Linux people to make the Linux "killall" man
 page to not mention "Linux" (or "non-Linux" in this case).  I suppose
 it makes some sense, so others will disagree, but if you're going to ask
 them to change, please be extraordinarily polite.
 
 I've CC'd the port maintainer.  Let's see what he has to say about it.

From: "Jakob Borg" <jakob@borg.pp.se>
To: swear@blarg.net (Gary W. Swearingen), rantapaa@uswest.net
Cc: Peter Pentchev <roam@ringlet.net>, bug-followup@FreeBSD.org,
	Giorgos Keramidas <keramida@FreeBSD.org>
Subject: Re: docs/34758: Irrelevant comment in killall(1) manpage
Date: Mon, 11 Feb 2002 21:40:21 +0100

 On Monday 11 February 2002 18.38, Gary W. Swearingen wrote:
 > From pkg-comment:
 >     A port of the Linux pstree, killall and pidof commands
 >
 > It seems wrong to ask the Linux people to make the Linux "killall" man
 > page to not mention "Linux" (or "non-Linux" in this case).  I suppose
 > it makes some sense, so others will disagree, but if you're going to ask
 > them to change, please be extraordinarily polite.
 
 I wouldn't presume to suggest that that manpage be changed - my entire 
 problem report was dependant on it being a FreeBSD manpage, which it isn't. 
 I think the report has the status 'closed' now, and it would be best to 
 leave it there.
 
 -- 
 Jakob Borg  |  jakob@borg.pp.se  |  +46 (0)46 397692
 Kmnrsv. 3a214 / SE-226 46 Lund / Sweden
>Unformatted:
