.TH DATESORT LOCAL
.UC 4
.SH NAME
datesort \- sort temporally by day and month names
.SH SYNOPSIS
.B datesort
.IR "" [+ x |- x "...] [" files ]
.SH DESCRIPTION
.PP
.B Datesort
preprocesses input containing day-of-week (\c
.I Sun, Mon, Tue,
\&...) and month (\c
.I Jan, Feb, Mar,
\&...) into sortable fields.  It then calls
.B sort,
passing along the switch arguments
(those beginning with "\fI+\fP" or "\fI-\fP") which
tell sort which fields to sort.  Finally, the output of
.B sort
is postprocessed to undo the preprocessing, so the output looks like
the input except it is sorted temporally rather than alphabetically.
.SH EXAMPLE
.\" ### initiate asis block ###
.nr UU \n(.u   \"asis block ###
.nf            \"asis block ###
\&% \fBdatesort +4 -6 <<'EOF'\fP
\&\fI-rw-r--r--  1 corey  3986 Feb 22 20:09 d24533
\&-rw-r--r--  1 corey  4146 Mar  8 20:09 d24629
\&-rw-r--r--  1 corey  3952 Feb  9 20:09 d25181
\&-rw-r--r--  1 corey  3986 Feb 23 20:09 d26135
\&-rw-r--r--  1 corey  4146 Mar  9 20:09 d26348
\&-rw-r--r--  1 corey  3802 Jan 27 20:09 d26716
\&-rw-r--r--  1 corey  5165 Mar 23 20:10 d271
\&-rw-r--r--  1 corey  3952 Feb 10 20:09 d27323\fP
\&\fBEOF\fP
\&-rw-r--r--  1 corey  3802 Jan 27 20:09 d26716
\&-rw-r--r--  1 corey  3952 Feb  9 20:09 d25181
\&-rw-r--r--  1 corey  3952 Feb 10 20:09 d27323
\&-rw-r--r--  1 corey  3986 Feb 22 20:09 d24533
\&-rw-r--r--  1 corey  3986 Feb 23 20:09 d26135
\&-rw-r--r--  1 corey  4146 Mar  8 20:09 d24629
\&-rw-r--r--  1 corey  4146 Mar  9 20:09 d26348
\&-rw-r--r--  1 corey  5165 Mar 23 20:10 d271
.if \n(UU .fi  \"asis block ###
.\" ### complete asis block ###
.SH SEE ALSO
sed(1), sort(1)
.SH AUTHOR
Corey Satten \- corey @ cac.washington.edu
.SH BUGS
Any line length limits in
.BR sed " and " sort
apply here as well.