svn commit: r366119 - head/usr.bin/which

[xtouqh at mm.st]

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 ,