summaryrefslogtreecommitdiffstats
path: root/doc/linsert.n
diff options
context:
space:
mode:
authordkf <donal.k.fellows@manchester.ac.uk>2004-04-16 22:20:55 (GMT)
committerdkf <donal.k.fellows@manchester.ac.uk>2004-04-16 22:20:55 (GMT)
commit52abe65a5f5579fb24ba16793f367efdca4b216d (patch)
tree515875301b5f35918e582aa3d36cef09b4824dce /doc/linsert.n
parent79f407d4f411f9c26a8fb3bbda9c76112b7f444e (diff)
downloadtcl-52abe65a5f5579fb24ba16793f367efdca4b216d.zip
tcl-52abe65a5f5579fb24ba16793f367efdca4b216d.tar.gz
tcl-52abe65a5f5579fb24ba16793f367efdca4b216d.tar.bz2
Add more examples to documentation along the lines of David Welton's project.
Diffstat (limited to 'doc/linsert.n')
-rw-r--r--doc/linsert.n13
1 files changed, 12 insertions, 1 deletions
diff --git a/doc/linsert.n b/doc/linsert.n
index 3a0a66d..eca0acc 100644
--- a/doc/linsert.n
+++ b/doc/linsert.n
@@ -6,7 +6,7 @@
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
-'\" RCS: @(#) $Id: linsert.n,v 1.7 2001/11/14 23:38:39 hobbs Exp $
+'\" RCS: @(#) $Id: linsert.n,v 1.8 2004/04/16 22:20:58 dkf Exp $
'\"
.so man.macros
.TH linsert n 8.2 Tcl "Tcl Built-In Commands"
@@ -30,6 +30,17 @@ elements in the list, then the new elements are appended to the list.
\fBend\-\fIinteger\fR refers to the last element in the list minus the
specified integer offset.
+.SH EXAMPLE
+Putting some values into a list, first indexing from the start and
+then indexing from the end, and then chaining them together:
+
+.CS
+set oldList {the fox jumps over the dog}
+set midList [linsert $oldList 1 quick]
+set newList [linsert $midList end-1 lazy]
+# The old lists still exist though...
+set newerList [linsert [linsert $oldList end-1 quick] 1 lazy]
+.CE
.SH "SEE ALSO"
.VS 8.4