summaryrefslogtreecommitdiffstats
path: root/doc/lsort.n
diff options
context:
space:
mode:
authorhobbs <hobbs>1999-12-21 23:57:33 (GMT)
committerhobbs <hobbs>1999-12-21 23:57:33 (GMT)
commitad4a42c1c2da6828324db8589acddcca79616e8c (patch)
tree0be6faa1991f803049ddca969f3daf42f07f65c6 /doc/lsort.n
parenta7f2bf5da71129730441d5bc4c7b79b4aaa45f0b (diff)
downloadtcl-ad4a42c1c2da6828324db8589acddcca79616e8c.zip
tcl-ad4a42c1c2da6828324db8589acddcca79616e8c.tar.gz
tcl-ad4a42c1c2da6828324db8589acddcca79616e8c.tar.bz2
* doc/Hash.3: fixed reference to ckfree [Bug: 3912]
* doc/RegExp.3: fixed calling params for Tcl_RegExecFromObj * doc/open.n: fixed minor formatting errors * doc/string.n: fixed minor formatting errors * doc/lsort.n: added -unique docs
Diffstat (limited to 'doc/lsort.n')
-rw-r--r--doc/lsort.n23
1 files changed, 13 insertions, 10 deletions
diff --git a/doc/lsort.n b/doc/lsort.n
index bc0b658..8d326fc 100644
--- a/doc/lsort.n
+++ b/doc/lsort.n
@@ -6,10 +6,10 @@
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
-'\" RCS: @(#) $Id: lsort.n,v 1.4 1999/02/05 01:49:03 stanton Exp $
+'\" RCS: @(#) $Id: lsort.n,v 1.5 1999/12/21 23:57:33 hobbs Exp $
'\"
.so man.macros
-.TH lsort n 8.0 Tcl "Tcl Built-In Commands"
+.TH lsort n 8.3 Tcl "Tcl Built-In Commands"
.BS
'\" Note: do not modify the .SH NAME line immediately below!
.SH NAME
@@ -31,9 +31,7 @@ specified before \fIlist\fR to control the sorting process (unique
abbreviations are accepted):
.TP 20
\fB\-ascii\fR
-Use string comparison with ASCII collation order. This is
-the default.
-.VS 8.0 br
+Use string comparison with ASCII collation order. This is the default.
.TP 20
\fB\-dictionary\fR
Use dictionary-style comparison. This is the same as \fB\-ascii\fR
@@ -42,14 +40,12 @@ strings contain embedded numbers, the numbers compare as integers,
not characters. For example, in \fB\-dictionary\fR mode, \fBbigBoy\fR
sorts between \fBbigbang\fR and \fBbigboy\fR, and \fBx10y\fR
sorts between \fBx9y\fR and \fBx11y\fR.
-.VE
.TP 20
\fB\-integer\fR
Convert list elements to integers and use integer comparison.
.TP 20
\fB\-real\fR
-Convert list elements to floating-point values and use floating
-comparison.
+Convert list elements to floating-point values and use floating comparison.
.TP 20
\fB\-command\0\fIcommand\fR
Use \fIcommand\fR as a comparison command.
@@ -66,7 +62,6 @@ This is the default.
.TP 20
\fB\-decreasing\fR
Sort the list in decreasing order (``largest'' items first).
-.VS 8.0 br
.TP 20
\fB\-index\0\fIindex\fR
If this option is specified, each of the elements of \fIlist\fR must
@@ -82,8 +77,16 @@ returns \fB{Second 18} {First 24} {Third 30}\fR.
This option is much more efficient than using \fB\-command\fR
to achieve the same effect.
.RE
+.VS 8.3
+.TP 20
+\fB\-unique\fR
+If this option is specified, then only the last set of duplicate
+elements found in the list will be retained. Note that duplicates are
+determined relative to the comparison used in the sort. Thus if
+\fI-index 0\fR is used, \fB{1 a}\fR and \fB{1 b}\fR would be
+considered duplicates and only the second element, \fB{1 b}\fR, would
+be retained.
.VE
-
.SH KEYWORDS
element, list, order, sort