.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.2.
.TH NATSORT "1" "June 2022" "natsort 8.0.2" "User Commands"
.SH NAME
natsort \- Natural sorting for shell
.SH DESCRIPTION
usage: natsort [\-h] [\-\-version] [\-p] [\-f LOW HIGH] [\-F LOW HIGH] [\-e EXCLUDE]
.IP
[\-r] [\-t {int,float,real,f,i,r}] [\-\-nosign] [\-s] [\-\-noexp] [\-l]
[entries ...]
.PP
Performs a natural sort on entries given on the command\-line.
.PP
Arguments are read from sys.argv.
.SS "positional arguments:"
.TP
entries
The entries to sort. Taken from stdin if nothing is
given on the command line.
.SS "options:"
.TP
\fB\-h\fR, \fB\-\-help\fR
show this help message and exit
.TP
\fB\-\-version\fR
show program's version number and exit
.TP
\fB\-p\fR, \fB\-\-paths\fR
Interpret the input as file paths. This is not
strictly necessary to sort all file paths, but in
cases where there are OS\-generated file paths like
"Folder/" and "Folder (1)/", this option is needed to
make the paths sorted in the order you expect
("Folder/" before "Folder (1)/").
.TP
\fB\-f\fR LOW HIGH, \fB\-\-filter\fR LOW HIGH
Used for keeping only the entries that have a number
falling in the given range.
.TP
\fB\-F\fR LOW HIGH, \fB\-\-reverse\-filter\fR LOW HIGH
Used for excluding the entries that have a number
falling in the given range.
.TP
\fB\-e\fR EXCLUDE, \fB\-\-exclude\fR EXCLUDE
Used to exclude an entry that contains a specific
number.
.TP
\fB\-r\fR, \fB\-\-reverse\fR
Returns in reversed order.
.TP
\fB\-t\fR {int,float,real,f,i,r}, \fB\-\-number\-type\fR {int,float,real,f,i,r}, \fB\-\-number_type\fR {int,float,real,f,i,r}
Choose the type of number to search for. "float" will
search for floating\-point numbers. "int" will only
search for integers. "real" is a shortcut for "float"
with \fB\-\-sign\fR. "i" is a synonym for "int", "f" is a
synonym for "float", and "r" is a synonym for
"real".The default is int.
.TP
\fB\-\-nosign\fR
Do not consider "+" or "\-" as part of a number, i.e.
do not take sign into consideration. This is the
default.
.TP
\fB\-s\fR, \fB\-\-sign\fR
Consider "+" or "\-" as part of a number, i.e. take
sign into consideration. The default is unsigned.
.TP
\fB\-\-noexp\fR
Do not consider an exponential as part of a number,
i.e. 1e4, would be considered as 1, "e", and 4, not as
10000. This only effects the \fB\-\-number\-type\fR=\fI\,float\/\fR.
.TP
\fB\-l\fR, \fB\-\-locale\fR
Causes natsort to use locale\-aware sorting. You will
get the best results if you install PyICU.
.SH "SEE ALSO"
The full documentation for
.B natsort
is maintained as a Texinfo manual.  If the
.B info
and
.B natsort
programs are properly installed at your site, the command
.IP
.B info natsort
.PP
should give you access to the complete manual.