version 1.22, 2005/09/27 23:40:07 |
version 1.23, 2005/09/28 10:10:16 |
|
|
.Nd sort or merge text files |
.Nd sort or merge text files |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm sort |
.Nm sort |
.Op Fl cmubdfinrzH |
.Op Fl bcdfHimnruz |
.Op Fl t Ar char |
|
.Op Fl R Ar char |
|
.Oo |
.Oo |
.Fl k Ar field1[,field2] |
.Sm off |
.Oc |
.Fl k |
|
.Ar field1 Op , Ar field2 |
.Ar ... |
.Ar ... |
.Op Fl T Ar dir |
.Sm on |
|
.Oc |
.Op Fl o Ar output |
.Op Fl o Ar output |
.Op Ar file |
.Op Fl R Ar char |
.Ar ... |
.Bk -words |
|
.Op Fl T Ar dir |
|
.Ek |
|
.Op Fl t Ar char |
|
.Op Ar file ... |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
The |
The |
.Nm |
.Nm |
|
|
.It Fl f |
.It Fl f |
Considers all lowercase characters that have uppercase |
Considers all lowercase characters that have uppercase |
equivalents to be the same for purposes of comparison. |
equivalents to be the same for purposes of comparison. |
|
.It Fl H |
|
Use a merge sort instead of a radix sort. |
|
This option should be used for files larger than 60Mb. |
.It Fl i |
.It Fl i |
Ignore all non-printable characters. |
Ignore all non-printable characters. |
.It Fl n |
.It Fl n |
|
|
option.) |
option.) |
.It Fl r |
.It Fl r |
Reverse the sense of comparisons. |
Reverse the sense of comparisons. |
.It Fl H |
|
Use a merge sort instead of a radix sort. |
|
This option should be used for files larger than 60Mb. |
|
.El |
.El |
.Pp |
.Pp |
The treatment of field separators can be altered using these options: |
The treatment of field separators can be altered using these options: |
|
|
Note that the |
Note that the |
.Fl b |
.Fl b |
option has no effect unless key fields are specified. |
option has no effect unless key fields are specified. |
|
.It Xo |
|
.Sm off |
|
.Fl k\ \& Ar field1 Op , Ar field2 |
|
.Sm on |
|
.Xc |
|
Designates the starting position, |
|
.Ar field1 , |
|
and optional ending position, |
|
.Ar field2 , |
|
of a key field. |
|
The |
|
.Fl k |
|
option replaces the obsolescent options |
|
.Cm \(pl Ns Ar pos1 |
|
and |
|
.Fl Ns Ar pos2 . |
|
.It Fl R Ar char |
|
.Ar char |
|
is used as the record separator character. |
|
This should be used with discretion; |
|
.Fl R Aq Ar alphanumeric |
|
usually produces undesirable results. |
|
The default record separator is newline. |
.It Fl t Ar char |
.It Fl t Ar char |
.Ar char |
.Ar char |
is used as the field separator character. |
is used as the field separator character. |
|
|
delimit an empty field; further, the initial blank space |
delimit an empty field; further, the initial blank space |
.Em is |
.Em is |
considered part of a field when determining key offsets. |
considered part of a field when determining key offsets. |
.It Fl R Ar char |
|
.Ar char |
|
is used as the record separator character. |
|
This should be used with discretion; |
|
.Fl R Ar <alphanumeric> |
|
usually produces undesirable results. |
|
The default record separator is newline. |
|
.It Fl k Ar field1[,field2] |
|
Designates the starting position, |
|
.Ar field1 , |
|
and optional ending position, |
|
.Ar field2 , |
|
of a key field. |
|
The |
|
.Fl k |
|
option replaces the obsolescent options |
|
.Cm \(pl Ns Ar pos1 |
|
and |
|
.Fl Ns Ar pos2 . |
|
.It Fl z |
.It Fl z |
Uses the nul character as the record separator. |
Uses the nul character as the record separator. |
.El |
.El |
|
|
considered to be part of the first field. |
considered to be part of the first field. |
.Pp |
.Pp |
Fields are specified by the |
Fields are specified by the |
.Fl k Ar field1[,field2] |
.Sm off |
|
.Fl k\ \& Ar field1 Op , Ar field2 |
|
.Sm on |
argument. |
argument. |
A missing |
A missing |
.Ar field2 |
.Ar field2 |