.\"
.\" @(#)look.1 8.1 (Berkeley) 6/14/93
.\"
-.Dd June 14, 1993
-.Dt LOOK 1
-.Os
-.Sh NAME
-.Nm look
-.Nd display lines beginning with a given string
-.Sh SYNOPSIS
-.Nm look
-.Op Fl dfa
-.Op Fl t Ar termchar
-.Ar string
-.Op Ar file
-.Sh DESCRIPTION
-The
-.Nm look
+.TH LOOK 1 "June 2011" "util-linux" "User Commands"
+.SH NAME
+look \- display lines beginning with a given string
+.SH SYNOPSIS
+.B look
+[options]
+.IR "string " [ file ]
+.SH DESCRIPTION
+The
+.B look
utility displays any lines in
-.Ar file
+.I file
which contain
-.Ar string
-as a prefix.
+.IR string .
As
-.Nm look
+.B look
performs a binary search, the lines in
-.Ar file
+.I file
must be sorted (where
-.Xr sort 1
-got the same options \-d and/or \-f that
-.Nm look
+.BR sort (1)
+was given the same options
+.BR "\-d " and/or " \-f " that
+.B look
is invoked with).
-.Pp
+.PP
If
-.Ar file
+.I file
is not specified, the file
-.Pa /usr/share/dict/words
+.I /usr/share/dict/words
is used, only alphanumeric characters are compared and the case of
alphabetic characters is ignored.
-.Pp
-Options:
-.Bl -tag -width Ds
-.It Fl d
-Dictionary character set and order, i.e. only alphanumeric characters
-are compared. (On by default if no file specified).
-.It Fl f
-Ignore the case of alphabetic characters. (On by default if no file specified).
-.It Fl a
-Use the alternate dictionary
-.Pa /usr/share/dict/web2
-.It Fl t
+.SH OPTIONS
+.TP
+.BR \-a , " \-\-alternative"
+Use the alternative dictionary file.
+.TP
+.BR \-d , " \-\-alphanum"
+Use normal dictionary character set and order, i.e. only blanks and
+alphanumeric characters are compared. This is on by default if no file is
+specified.
+
+Note that blanks have been added to dictionary character set for
+compatibility with \fBsort \-d\fR command since version 2.28.
+.TP
+.BR \-f , " \-\-ignore\-case"
+Ignore the case of alphabetic characters. This is on by default if no file is
+specified.
+.TP
+.BR \-t , " \-\-terminate " \fIcharacter\fR
Specify a string termination character, i.e. only the characters
-in
-.Ar string
-up to and including the first occurrence of
-.Ar termchar
+in \fIstring\fR up to and including the first occurrence of \fIcharacter\fR
are compared.
-.El
-.Pp
+.TP
+.BR \-V , " \-\-version"
+Display version information and exit.
+.TP
+.BR \-h , " \-\-help"
+Display help text and exit.
+.PP
The
-.Nm look
-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 FILES
-.Bl -tag -width /usr/share/dict/words -compact
-.It Pa /usr/share/dict/words
+.B look
+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 EXAMPLE
+.RS
+.nf
+sort -d /etc/passwd -o /tmp/look.dict
+look -t: root:foobar /tmp/look.dict
+.nf
+.RE
+.SH ENVIRONMENT
+.TP
+.B WORDLIST
+Path to a dictionary file. The environment variable has greater priority
+than the dictionary path defined in FILES segment.
+.SH FILES
+.IP "\fB/usr/share/dict/words\fR" 4
the dictionary
-.It Pa /usr/share/dict/web2
-the alternate dictionary
-.El
-.Sh SEE ALSO
-.Xr grep 1 ,
-.Xr sort 1
-.Sh COMPATIBILITY
-The original manual page stated that tabs and blank characters participated
-in comparisons when the
-.Fl d
-option was specified.
-This was incorrect and the current man page matches the historic
-implementation.
-.Sh HISTORY
-.Nm Look
-appeared in Version 7 AT&T Unix.
-.Sh AVAILABILITY
+.IP "\fB/usr/share/dict/web2\fR" 4
+the alternative dictionary
+.SH "SEE ALSO"
+.BR grep (1),
+.BR sort (1)
+.SH HISTORY
+The
+.B look
+utility appeared in Version 7 AT&T Unix.
+.SH AVAILABILITY
The look command is part of the util-linux package and is available from
-ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
+https://www.kernel.org/pub/linux/utils/util-linux/.
projects / thirdparty / util-linux.git / blobdiff