.TH SORT 1
.SH NAME
sort \- sort or merge files
.SH SYNTAX
.B sort
[
.if t \fB\-mubdf\&inrt\fIx\fP
.if n -mubdfinrt_________x
]
[ \fB+\fIpos1 \fP [ \fB\-\fIpos2 \fP]
]
[ 
.B \-o 
name ] [
.B \-T
directory ] [ files ]
.SH DESCRIPTION
.I Sort
sorts
lines of all the named files together
and writes the result on
the standard output.
If no input files are named, the standard input is sorted.
The name "\fB-\fP" also means read input from standard input.
.PP
The default sort key is an entire line.
Default ordering is
lexicographic by bytes in the machine
collating sequence.
The ordering is affected globally by the following options,
one or more of which may appear.
.TP 5
.B  b
Ignore leading blanks (spaces and tabs) in field comparisons.
.TP 5
.B  d
`Dictionary' order: only letters, digits and blanks
are significant in comparisons.
.TP 5
.B  f
Fold upper case
letters onto lower case.
.TP 5
.B  i
Ignore characters outside the ASCII range (040-0176)
in nonnumeric comparisons.
.TP 5
.B  n
An initial numeric string,
consisting of optional blanks, optional minus sign,
and zero or more digits with optional decimal point,
is sorted by arithmetic value.
Option
.B n
implies option
.B b.
.TP 5
.B  r
Reverse the sense of comparisons.
.TP 5
.BI t x
`Tab character' separating fields is
.IR x .
.PP
The notation
.BI + "pos1 " "\-\fIpos2"
restricts a sort key to a field beginning at
.I pos1
and ending just before \fIpos2\fP.
.I pos1
and
.I pos2
each have the form
.IB m . n\fP,
optionally followed by one or more of the flags
\fBbdf\&inr\fP,
where
.I m
tells a number of fields to skip from the beginning of the line and
.I n
tells a number of characters to skip further.
If any flags are present they override all the global
ordering options for this key.
If the
.B b
option is in effect
.I n
is counted from the first nonblank in the field;
.B b
is attached independently to 
.IR pos2 .
A missing
\&\fB.\fIn\fP
means .0;
a missing
.BI \- pos2
means the end of the line.
Under the
.BI \-t x
option, fields are strings separated by
.IR x ;
otherwise fields are
nonempty nonblank strings separated by blanks.
.PP
When there are multiple sort keys, later keys
are compared only after all earlier keys
compare equal.
Lines that otherwise compare equal are ordered
on the basis of all bytes in the line.
.PP
These option arguments are also understood:
.TP 5
.B c
Check that the input file is sorted according to the ordering rules;
give no output unless the file is out of sort.
.TP 5
.B  m
Merge only, the input files are already sorted.
.TP 5
.B  o
The next argument is the name of an output file
to use instead of the standard output.
This file may be the same as one of the inputs.
.TP 5
.B T
The next argument is the name of a directory in which temporary files
should be made.
.TP 5
.B  u
Suppress all but one in each
set of equal lines.
Ignored bytes
and bytes outside keys
do not participate in
this comparison.
.SH FILES
.ta 2i
/usr/tmp/stm*	first try for temporary files
.br
/tmp/*	second trie for temporary files
.SH SEE ALSO
comm(1), join(1), rev(1), uniq(1)
.SH DIAGNOSTICS
Comments and exits with nonzero status for various trouble conditions
and for disorder discovered under option \fB-c\fP.
.SH BUGS
Very long lines are silently truncated.
.SH EXAMPLES
Sort a file called \fBlist\fP in numeric order:
.PP
.ti +8
\fBsort  \-n  list\fP
.PP
Sort by field 3 in file \fBlist\fP where fields are separated by "\fB;\fP":
.PP
.ti +8
\fBsort  \-t;  +2  \-3  list\fP
.PP
Sort by columns 10 to 24 in numeric order:
.PP
.ti +8
\fBsort  \-n  +0.9  \-0.24  list\fP
.PP
Take the case where columns 10 to 24 are dates where each two columns is
respectively year, month, day, hour, minute, and columns 20 to 24 are
seconds such as 20.34.  Furthermore, assume the seconds can be blank.  Then
sorting must not be numeric since these are left justified numbers and 
lexicographic sorting is required.
.PP
.ti +8
\fBsort  +0.9  \-0.24  list\fP
.PP
Sort by columns 3 and 4 of field 10 where the fields are separated by "\fB:\fP":
.PP
.ti +8
\fBsort  \-t:  +9.2  \-9.4  list\fP
.PP
Print in alphabetical order all the unique spellings
in a list of words.
Capitalized words differ from uncapitalized.
.PP
.ti +8
\fBsort  \-u  +0f  +0  list\fP
.PP
Print the password file (\fIpasswd\fP\|(5))
sorted by user id number (the 3rd colon-separated field).
.PP
.ti +8
\fBsort  \-t:  +2n  /etc/passwd\fP
.PP
Print the first instance of each month in an already sorted file
of (month day) entries.
The options
.B \-um
with just one input file make the choice of a
unique representative from a set of equal lines predictable.
.PP
.ti +8
\fBsort  \-um  +0  \-1 dates\fP