summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorericm <ericm>2000-01-21 18:24:06 (GMT)
committerericm <ericm>2000-01-21 18:24:06 (GMT)
commitedc8402b2f29c2f3373e55ae1c33af29a0928324 (patch)
treef81c321f5a68d666223390f52b6d38ac65b7315d
parentbe7a220702d4d12f0770b3e4b3813c45802f7552 (diff)
downloadtcl-edc8402b2f29c2f3373e55ae1c33af29a0928324.zip
tcl-edc8402b2f29c2f3373e55ae1c33af29a0928324.tar.gz
tcl-edc8402b2f29c2f3373e55ae1c33af29a0928324.tar.bz2
* doc/lreplace.n: Corrected man page with respect to treatment of
empty lists, and "prettied up" the page. (bug #1705).
-rw-r--r--ChangeLog22
-rw-r--r--doc/lreplace.n35
2 files changed, 33 insertions, 24 deletions
diff --git a/ChangeLog b/ChangeLog
index 07266ce..36fea5a 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,20 +1,26 @@
+2000-01-21 Eric Melski <ericm@scriptics.com>
+
+ * doc/lreplace.n: Corrected man page with respect to treatment of
+ empty lists, and "prettied up" the page. (bug #1705).
+
2000-01-20 Eric Melski <ericm@scriptics.com>
- * namespace.test: Added test for undefined variables with
+ * tests/namespace.test: Added test for undefined variables with
namespace which (bug #956).
- * tclNamesp.c: Added check for undefined variables in
+ * generic/tclNamesp.c: Added check for undefined variables in
NamespaceWhichCmd (bug #956).
- * var.test: Added tests for corrected variable behavior (bug #981).
+ * tests/var.test: Added tests for corrected variable behavior
+ (bug #981).
- * upvar.n: Expanded explanation of upvar behavior with respect to
+ * doc/upvar.n: Expanded explanation of upvar behavior with respect to
variable traces. (bugs 3917 1433 2110).
- * tclVar.c: Changed behavior of variable command when name refers
- to an element in an array (ie, "variable foo(x)") to always return
- an error, regardless of existance of that element in the array
- (now behavior is consistant with docs too) (bug #981).
+ * generic/tclVar.c: Changed behavior of variable command when name
+ refers to an element in an array (ie, "variable foo(x)") to always
+ return an error, regardless of existance of that element in the
+ array (now behavior is consistant with docs too) (bug #981).
2000-01-20 Jeff Hobbs <hobbs@scriptics.com>
diff --git a/doc/lreplace.n b/doc/lreplace.n
index bc5d20a..bb32aaa 100644
--- a/doc/lreplace.n
+++ b/doc/lreplace.n
@@ -5,7 +5,7 @@
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
-'\" RCS: @(#) $Id: lreplace.n,v 1.3 2000/01/21 02:25:05 hobbs Exp $
+'\" RCS: @(#) $Id: lreplace.n,v 1.4 2000/01/21 18:24:06 ericm Exp $
'\"
.so man.macros
.TH lreplace n 7.4 Tcl "Tcl Built-In Commands"
@@ -21,24 +21,27 @@ lreplace \- Replace elements in a list with new elements
.PP
\fBlreplace\fR returns a new list formed by replacing one or more elements of
\fIlist\fR with the \fIelement\fR arguments.
-\fIfirst\fR gives the index in \fIlist\fR of the first element
-to be replaced (0 refers to the first element).
-If \fIfirst\fR is less than zero then it refers to the first
-element of \fIlist\fR; the element indicated by \fIfirst\fR
-must exist in the list.
-\fIlast\fR gives the index in \fIlist\fR of the last element
-to be replaced. If it is less than zero but greater than \fIfirst\fR,
-then any specified elements will be prepended to the list.
-If \fIlast\fR is less than \fIfirst\fR then no elements are deleted;
-the new elements are simply inserted before \fIfirst\fR.
-\fIfirst\fR or \fIlast\fR may be \fBend\fR
-(or any abbreviation of it) to refer to the last element of the list.
+\fIfirst\fR and \fIlast\fR specify the first and last index of the
+range of elements to replace. 0 refers to the first element of the
+list, and \fBend\fR (or any abbreviation of it) may be used to refer
+to the last element of the list. If \fIlist\fR is empty, then
+\fIfirst\fR and \fIlast\fR are ignored.
+
+If \fIfirst\fR is less than zero, it is considered to refer to the
+first element of the list. For non-empty lists, the element indicated
+by \fIfirst\fR must exist.
+
+If \fIlast\fR is less than zero but greater than \fIfirst\fR, then any
+specified elements will be prepended to the list. If \fIlast\fR is
+less than \fIfirst\fR then no elements are deleted; the new elements
+are simply inserted before \fIfirst\fR.
+
The \fIelement\fR arguments specify zero or more new arguments to
be added to the list in place of those that were deleted.
Each \fIelement\fR argument will become a separate element of
-the list.
-If no \fIelement\fR arguments are specified, then the elements
-between \fIfirst\fR and \fIlast\fR are simply deleted.
+the list. If no \fIelement\fR arguments are specified, then the elements
+between \fIfirst\fR and \fIlast\fR are simply deleted. If \fIlist\fR
+is empty, any \fIelement\fR arguments are added to the end of the list.
.SH KEYWORDS
element, list, replace