summaryrefslogtreecommitdiffstats
path: root/doc/list.n
diff options
context:
space:
mode:
Diffstat (limited to 'doc/list.n')
-rw-r--r--doc/list.n38
1 files changed, 20 insertions, 18 deletions
diff --git a/doc/list.n b/doc/list.n
index 19a9034..a182fc8 100644
--- a/doc/list.n
+++ b/doc/list.n
@@ -1,15 +1,13 @@
'\"
'\" Copyright (c) 1993 The Regents of the University of California.
'\" Copyright (c) 1994-1996 Sun Microsystems, Inc.
-'\" Copyright (c) 2001 Kevin B. Kenny. All rights reserved.
+'\" Copyright (c) 2001 Kevin B. Kenny <kennykb@acm.org>. All rights reserved.
'\"
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
-'\"
-'\" RCS: @(#) $Id: list.n,v 1.7 2001/12/05 22:26:43 dgp Exp $
-'\"
-.so man.macros
+'\"
.TH list n "" Tcl "Tcl Built-In Commands"
+.so man.macros
.BS
'\" Note: do not modify the .SH NAME line immediately below!
.SH NAME
@@ -17,7 +15,6 @@ list \- Create a list
.SH SYNOPSIS
\fBlist \fR?\fIarg arg ...\fR?
.BE
-
.SH DESCRIPTION
.PP
This command returns a list comprised of all the \fIarg\fRs,
@@ -29,26 +26,31 @@ so that \fBeval\fR may be used to execute the resulting list, with
its arguments. \fBList\fR produces slightly different results than
\fBconcat\fR: \fBconcat\fR removes one level of grouping before forming
the list, while \fBlist\fR works directly from the original arguments.
-For example, the command
+.SH EXAMPLE
+.PP
+The command
+.PP
.CS
-\fBlist a b {c d e} {f {g h}}\fR
+\fBlist\fR a b "c d e " " f {g h}"
.CE
+.PP
will return
+.PP
.CS
-\fBa b {c d e} {f {g h}}\fR
+\fBa b {c d e } { f {g h}}\fR
.CE
+.PP
while \fBconcat\fR with the same arguments will return
+.PP
.CS
\fBa b c d e f {g h}\fR
.CE
-
.SH "SEE ALSO"
-lappend(n), lindex(n), linsert(n), llength(n), lsearch(n),
-.VS 8.4
-lset(n),
-.VE
-lsort(n),
-lrange(n), lreplace(n)
-
+lappend(n), lindex(n), linsert(n), llength(n), lrange(n),
+lrepeat(n),
+lreplace(n), lsearch(n), lset(n), lsort(n)
.SH KEYWORDS
-element, list
+element, list, quoting
+'\"Local Variables:
+'\"mode: nroff
+'\"End: