33 lines
992 B
Plaintext
33 lines
992 B
Plaintext
|
'\"
|
||
|
|
'\" 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.
|
||
|
|
'\"
|
||
|
|
'\" SCCS: @(#) append.n 1.6 96/03/25 20:09:44
|
||
|
|
'\"
|
||
|
|
.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
|