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

[Benjamin Kaduk]

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, 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).

Thanks,

Ben