Subversion Repositories or1k

'\"

'\" Copyright (c) 1993 The Regents of the University of California.

'\" Copyright (c) 1994-1996 Sun Microsystems, Inc.

'\"

'\" 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.1.1.1 2002-01-16 10:25:24 markom Exp $

'\"

.so man.macros

.TH append n "" Tcl "Tcl Built-In Commands"

.BS

'\" Note:  do not modify the .SH NAME line immediately below!

.SH NAME

append \- Append to variable

.SH SYNOPSIS

\fBappend \fIvarName \fR?\fIvalue value value ...\fR?

.BE

.SH DESCRIPTION

.PP

Append all of the \fIvalue\fR arguments to the current value

of variable \fIvarName\fR.  If \fIvarName\fR doesn't exist,

it is given a value equal to the concatenation of all the

\fIvalue\fR arguments.

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 KEYWORDS

append, variable