commit 4e7cbbee28d696d8b913e6afff326d5559887807
parent f2eb5d3b2d65790769b1de36243b5885360c8a75
Author: Hiltjo Posthuma <hiltjo@codemadness.org>
Date: Fri, 30 Jan 2015 23:49:13 +0100
sort.1: convert to mandoc
Diffstat:
| M | sort.1 | | | 108 | +++++++++++++++++++++++++++++++++++++++++++++---------------------------------- |
1 file changed, 62 insertions(+), 46 deletions(-)
diff --git a/sort.1 b/sort.1
@@ -1,67 +1,83 @@
-.TH SORT 1 sbase\-VERSION
-.SH NAME
-sort \- sort lines
-.SH SYNOPSIS
-.B sort
-.RB [ \-bnru ]
-.RB [ \-t
-.IR delim ]
-.RB [ \-k
-.IR key ]...
-.RI [ file ...]
-.SH DESCRIPTION
-.B sort
-writes the sorted concatenation of the given files to stdout. If no file is
+.Dd January 30, 2015
+.Dt SORT 1 sbase\-VERSION
+.Os
+.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 files to stdout. If no file is
given, sort reads from stdin.
-.SH OPTIONS
-.TP
-.B \-C
+.Sh OPTIONS
+.Bl -tag -width Ds
+.It Fl C
check that the concatenation of the given files is sorted rather than sorting
-them. In this mode, no output is printed to stdout, and the exit status
+them. In this mode, no output is printed to stdout, and the exit status
indicates the result of the check.
-.TP
-.B \-b
+.It Fl b
skip leading whitespace of columns when sorting.
-.TP
-.B \-c
+.It Fl c
the same as
-.B \-C
+.Fl C
except that when disorder is detected, a message is printed to stderr
indicating the location of the disorder.
-.TP
-.BI \-k \ key
+.It Fl k Ar key
specifies a key definition of the form
-.BR S [. s ][ f ][, E [. e ][ f ]]
+.Sm off
+[.
+.Sy s
+][
+.Sy f
+][,
+.Sy E
+[.
+.Sy e
+][
+.Sy f
+]]
+.Sm on
where
-.BR S ,
-.BR s ,
-.BR E ,
+.Sm off
+.Sy S
+,
+.Sy s
+,
+.Sy E
+.Sm on
and
-.B e
+.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,
-.B s
+the ending character of that column respectively. If they are not specified,
+.Sy s
refers to the first character of the specified starting column,
-.B E
+.Sy E
refers to the last column of every line, and
-.B e
+.Sy e
refers to the last character of that last column.
-.B f
+.Sy f
can be used to specify options
-.RB ( n ,
-.BR b )
+.Sm off
+(
+.Sy n
+,
+.Sy b
+)
+.Sm on
that only apply to this key definition.
-.B b
+.Sy b
is special in that it only applies to the column that it was specified after.
-.TP
-.B \-n
+.It Fl n
perform a numeric sort.
-.TP
-.B \-r
+.It Fl r
reverses the sort.
-.TP
-.BI \-t \ delim
+.It Fl t Ar delim
specifies the field delimiter.
-.TP
-.B \-u
+.It Fl u
prints equal lines only once.
+.El
