Date: Thu, 24 Sep 2020 19:32:07 +0300 From: xtouqh@mm.st To: =?UTF-8?Q?Fernando_Apestegu=c3=ada?= <fernape@FreeBSD.org>, src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: Re: svn commit: r366119 - head/usr.bin/which Message-ID: <7ed37edf-b448-2b48-b90f-7b3f7554a17a@mm.st> In-Reply-To: <202009241611.08OGBrG4024495@repo.freebsd.org> References: <202009241611.08OGBrG4024495@repo.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
Fernando Apesteguía wrote: > Author: fernape (ports committer) > Date: Thu Sep 24 16:11:53 2020 > New Revision: 366119 > URL: https://svnweb.freebsd.org/changeset/base/366119 > > Log: > which(1): Add EXAMPLES section to manpage > > Add EXAMPLES section showing the use of -a and -s flags and how which(1) > treates duplicates. > > Approved by: manpages (gbe@) > Differential Revision: https://reviews.freebsd.org/D26182 > > Modified: > head/usr.bin/which/which.1 > > Modified: head/usr.bin/which/which.1 > ============================================================================== > --- head/usr.bin/which/which.1 Thu Sep 24 15:38:01 2020 (r366118) > +++ head/usr.bin/which/which.1 Thu Sep 24 16:11:53 2020 (r366119) > @@ -29,7 +29,7 @@ > .\" > .\" $FreeBSD$ > .\" > -.Dd December 13, 2006 > +.Dd September 24, 2020 > .Dt WHICH 1 > .Os > .Sh NAME > @@ -62,6 +62,48 @@ command which is similar or identical to this utility. > Consult the > .Xr builtin 1 > manual page. > +.Sh EXAMPLES > +Locate the > +.Xr ls 1 > +and > +.Xr cp 1 > +commands: > +.Bd -literal -offset indent > +$ /usr/bin/which ls cp > +/bin/ls > +/bin/cp > +.Ed > +.Pp > +Same as above with a specific > +.Va PATH .Ev ? > +and showing all occurrences: > +.Bd -literal -offset indent > +$ PATH=/bin:/rescue /usr/bin/which -a ls cp > +/bin/ls > +/rescue/ls > +/bin/cp > +/rescue/cp > +.Ed > +.Pp > +.Nm which > +will show duplicates if the same executable is find more than once: found? > +.Bd -literal -offset indent > +$ PATH=/bin:/bin /usr/bin/which -a ls > +/bin/ls > +/bin/ls > +.Ed > +.Pp > +Do not show output. > +Just exit with an appropriate return code: > +.Bd -literal -offset indent > +$ /usr/bin/which -s ls cp > +$ echo $? > +0 > + > +$ /usr/bin/which -s fakecommand > +$ echo $? > +1 > +.Ed > .Sh SEE ALSO > .Xr builtin 1 , > .Xr csh 1 ,
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?7ed37edf-b448-2b48-b90f-7b3f7554a17a>