aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorFernando ApesteguĂ­a <fernape@FreeBSD.org>2020-12-29 20:48:12 +0000
committerFernando ApesteguĂ­a <fernape@FreeBSD.org>2020-12-29 20:48:12 +0000
commitf3f16c31fea258b2b1ec51ddd1bceb6207b66198 (patch)
tree252e332dadc8561838e42320ed563db38dde5859
parent0ce6e534d372df81743b1eb00e89d02b3597beb0 (diff)
downloadsrc-f3f16c31fea258b2b1ec51ddd1bceb6207b66198.tar.gz
src-f3f16c31fea258b2b1ec51ddd1bceb6207b66198.zip
look(1): Add EXAMPLES section
Add two simple examples. In this case I opted to show a small portion of the output since it helps to understand what the tool does. It shows the use of the -t flag too. PR: Submitted by: Reported by: Reviewed by: gbe@ Approved by: manpages (bcr@) Obtained from: MFC after: MFH: Relnotes: Security: Sponsored by: Differential Revision: https://reviews.freebsd.org/D27543
-rw-r--r--usr.bin/look/look.131
1 files changed, 30 insertions, 1 deletions
diff --git a/usr.bin/look/look.1 b/usr.bin/look/look.1
index b2f7100da530..177306e4eb09 100644
--- a/usr.bin/look/look.1
+++ b/usr.bin/look/look.1
@@ -28,7 +28,7 @@
.\" @(#)look.1 8.1 (Berkeley) 6/14/93
.\" $FreeBSD$
.\"
-.Dd July 17, 2004
+.Dd December 29, 2020
.Dt LOOK 1
.Os
.Sh NAME
@@ -96,6 +96,35 @@ The
.Nm
utility exits 0 if one or more lines were found and displayed,
1 if no lines were found, and >1 if an error occurred.
+.Sh EXAMPLES
+Look for lines starting with
+.Ql xylene
+in the file
+.Pa /usr/share/dict/words :
+.Bd -literal -offset indent
+$ look xylen
+xylene
+xylenol
+xylenyl
+.Ed
+.Pp
+Same as above, but do not consider any characters in
+.Ar string
+beyond the first
+.Ql e .
+Note that
+.Fl f
+is implicit since we are searching the default file
+.Pa /usr/share/dict/words :
+.Bd -literal -offset indent
+$ look -t e xylen
+Xyleborus
+xylem
+xylene
+xylenol
+xylenyl
+xyletic
+.Ed
.Sh COMPATIBILITY
The original manual page stated that tabs and blank characters participated
in comparisons when the