From edc8402b2f29c2f3373e55ae1c33af29a0928324 Mon Sep 17 00:00:00 2001 From: ericm Date: Fri, 21 Jan 2000 18:24:06 +0000 Subject: * doc/lreplace.n: Corrected man page with respect to treatment of empty lists, and "prettied up" the page. (bug #1705). --- ChangeLog | 22 ++++++++++++++-------- doc/lreplace.n | 35 +++++++++++++++++++---------------- 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 + + * 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 - * 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 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 -- cgit v0.12