svn commit: r361783 - head/usr.bin/killall

[Rodney W. Grimes]

> It seems Conrad dropped me from his reply, so I can't include it directly,
> but...
> 
> On Thu, Jun 04, 2020 at 06:12:05AM -0700, Rodney W. Grimes wrote:
> > > 04.06.2020 11:29, Benjamin Kaduk wrote:
> > > 
> > > > Author: bjk (doc committer)
> > > > Date: Thu Jun  4 04:29:43 2020
> > > > New Revision: 361783
> > > > URL: https://svnweb.freebsd.org/changeset/base/361783
> > > > 
> > > > Log:
> > > >   Add EXAMPLES to killall(1)
> > > >   
> > > >   Submitted by:	fernape
> > > >   Differential Revision:	https://reviews.freebsd.org/D25002
> > > > 
> > > > Modified:
> > > >   head/usr.bin/killall/killall.1
> > > > 
> > > > Modified: head/usr.bin/killall/killall.1
> > > > ==============================================================================
> > > > --- head/usr.bin/killall/killall.1	Thu Jun  4 02:36:41 2020	(r361782)
> > > > +++ head/usr.bin/killall/killall.1	Thu Jun  4 04:29:43 2020	(r361783)
> > > > @@ -145,6 +145,50 @@ utility exits 0 if some processes have been found and
> > > >  signalled successfully.
> > > >  Otherwise, a status of 1 will be
> > > >  returned.
> > > > +.Sh EXAMPLES
> > > > +Send
> > > > +.Dv SIGTERM
> > > > +to all firefox processes:
> > > > +.Bd -literal -offset indent
> > > > +killall firefox
> > > > +.Ed
> > > > +.Pp
> > > > +Send
> > > > +.Dv SIGTERM
> > > > +to firefox processes belonging to
> > > > +.Va USER :
> > > > +.Bd -literal -offset indent
> > > > +killall -u ${USER} firefox
> > > > +.Ed
> > > > +.Pp
> > > > +Stop all firefox processes:
> > > > +.Bd -literal -offset indent
> > > > +killall -SIGSTOP firefox
> > > > +.Ed
> > > > +.Pp
> > > > +Resume firefox processes:
> > > > +.Bd -literal -offset indent
> > > > +killall -SIGCONT firefox
> > > > +.Ed
> > > > +.Pp
> > > > +Show what would be done to firefox processes, but do not actually signal them:
> > > > +.Bd -literal -offset indent
> > > > +killall -s firefox
> > > > +.Ed
> > > > +.Pp
> > > > +Send
> > > > +.Dv SIGKILL
> > > > +to csh process running inside jail ID 282:
> > > > +.Bd -literal -offset indent
> > > > +killall -9 -j282 csh
> > > > +.Ed
> > > > +.Pp
> > > > +Send
> > > > +.Dv SIGTERM
> > > > +to all processes matching provided pattern (like vim and vimdiff):
> > > > +.Bd -literal -offset indent
> > > > +killall -m 'vim*'
> > > > +.Ed
> > > >  .Sh DIAGNOSTICS
> > > >  Diagnostic messages will only be printed if requested by
> > > >  .Fl d
> > > 
> > > "Firefox" is a trade mark (type of intellectual property) of Mozilla Foundation.
> > > Is it OK for us to use this name such way?
> > > 
> > > Isn't it better using a name of some utility we have in the base system like systat(1) ?
> > 
> > Purley out of simple safety I agree here.   Though I doubt a case could
> > be made for infringement it is just too easy to do the safe thing.
> 
> I'm not aware of any issues with using a trademark-protected term to refer
> to the product named by the mark,

Actually since you fail to recognize it as a mark with a TM notice this
does have other legal issues....  much as Sony didnt recognize the TM
on FreeBSD when used Mozilla could send us a nasty gram.

Probably unlikely, but still possible.

> and don't see how one could claim that
> this usage is an attempt to dilute the mark.  I don't currently plan to
> make any further changes to this example, myself (though I will not stand
> in the way if someone else wants to blandify the example).

Good enough.

> Thanks,
> Ben
-- 
Rod Grimes                                                 rgrimes at freebsd.org