From 8f44551e03712b6046cecdfc9e8ce0ba1b4a5225 Mon Sep 17 00:00:00 2001
From: dkf <donal.k.fellows@manchester.ac.uk>
Date: Tue, 18 May 2004 21:13:40 +0000
Subject: Added example

---
 ChangeLog    |  4 ++++
 doc/append.n | 12 +++++++++++-
 2 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/ChangeLog b/ChangeLog
index 88c1d11..16b24f3 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2004-05-18  Donal K. Fellows  <donal.k.fellows@man.ac.uk>
+
+	* doc/append.n: Added example.
+
 2004-05-18  David Gravereaux <davygrvy@pobox.com>
 
 	* win/makefile.vc: now generates a tclConfig.sh from Pat Thoyts
diff --git a/doc/append.n b/doc/append.n
index 5f1a3c7..d829c71 100644
--- a/doc/append.n
+++ b/doc/append.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: append.n,v 1.4 2003/02/10 13:32:22 dkf Exp $
+'\" RCS: @(#) $Id: append.n,v 1.5 2004/05/18 21:13:40 dkf Exp $
 '\" 
 .so man.macros
 .TH append n "" Tcl "Tcl Built-In Commands"
@@ -29,6 +29,16 @@ This command provides an efficient way to build up long
 variables incrementally.
 For example, ``\fBappend a $b\fR'' is much more efficient than
 ``\fBset a $a$b\fR'' if \fB$a\fR is long.
+.SH EXAMPLE
+Building a string of comma-separated numbers piecemeal using a loop.
+.CS
+set var 0
+for {set i 1} {$i<=10} {incr i} {
+   append var "," $i
+}
+puts $var
+# Prints 0,1,2,3,4,5,6,7,8,9,10
+.CE
 
 .SH "SEE ALSO"
 concat(n), lappend(n)
-- 
cgit v0.12