opensolaris man page for append

append(1T)						       Tcl Built-In Commands							append(1T)

__________________________________________________________________________________________________________________________________________________

NAME
       append - Append to variable

SYNOPSIS
       append varName ?value value value ...?
_________________________________________________________________

DESCRIPTION
       Append  all  of	the  value arguments to the current value of variable varName.	If varName doesn't exist, it is given a value equal to the
       concatenation of all the value arguments.  The result of this command is the new value stored in variable varName.  This  command  provides
       an  efficient  way to build up long variables incrementally.  For example, ``append a $b'' is much more efficient than ``set a $a$b'' if $a
       is long.

EXAMPLE
       Building a string of comma-separated numbers piecemeal using a loop.
	      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

SEE ALSO
       concat(1T), lappend(1T)

KEYWORDS
       append, variable

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWTcl	      |
       +--------------------+-----------------+
       |Interface Stability | Uncommitted     |
       +--------------------+-----------------+
NOTES
       Source for Tcl is available on http://opensolaris.org.

Tcl																	append(1T)