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 ,
_______________________________________________
svn-src-all@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
