sbase/sort.1
2015-02-01 20:52:28 +01:00

91 lines
1.6 KiB
Groff

.Dd January 30, 2015
.Dt SORT 1
.Os sbase
.Sh NAME
.Nm sort
.Nd sort lines
.Sh SYNOPSIS
.Nm
.Op Fl bnru
.Op Fl t Ar delim
.Op Fl k Ar key ...
.Op Ar file ...
.Sh DESCRIPTION
.Nm
writes the sorted concatenation of the given
.Ar files
to stdout. If no
.Ar file
is given,
.Nm
reads from stdin.
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl C
Check that the concatenation of the given
.Ar files
is sorted rather than sorting them. In this mode, no output is printed to
stdout, and the exit status indicates the result of the check.
.It Fl b
Skip leading whitespace of columns when sorting.
.It Fl c
The same as
.Fl C
except that when disorder is detected, a message is printed to stderr
indicating the location of the disorder.
.It Fl k Ar key
Specifies a key definition of the form
.Sm off
.Sy S
.No [.
.Sy s
.No ][
.Sy f
.No ][,
.Sy E
.No [.
.Sy e
.No ][
.Sy f
.No ]]
.Sm on
where
.Sm off
.Sy S
,
.Sy s
,
.Sy E
.Sm on
and
.Sy e
are the starting column, starting character in that column, ending column and
the ending character of that column respectively. If they are not specified,
.Sy s
refers to the first character of the specified starting column,
.Sy E
refers to the last column of every line, and
.Sy e
refers to the last character of the ending column.
.Sy f
can be used to specify options
.Sm off
(
.Sy n
,
.Sy b
)
.Sm on
that only apply to this key definition.
.Sy b
is special in that it only applies to the column that it was specified after.
.It Fl n
Perform a numeric sort.
.It Fl r
Reverses the sort.
.It Fl t Ar delim
Specifies the field delimiter.
.It Fl u
Prints equal lines only once.
.El