rename(1t) [opensolaris man page]

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

__________________________________________________________________________________________________________________________________________________

NAME

       rename - Rename or delete a command

SYNOPSIS

       rename oldName newName
_________________________________________________________________

DESCRIPTION

       Rename the command that used to be called oldName so that it is now called newName.  If newName is an empty string then oldName is deleted.
       oldName and newName may include namespace qualifiers (names of containing namespaces).  If a command is renamed into a different namespace,
       future invocations of it will execute in the new namespace.  The rename command returns an empty string as result.

EXAMPLE

       The  rename command can be used to wrap the standard Tcl commands with your own monitoring machinery.  For example, you might wish to count
       how often the source command is called:
	      rename ::source ::theRealSource
	      set sourceCount 0
	      proc ::source args {
		  global sourceCount
		  puts "called source for the [incr sourceCount]'th time"
		  uplevel 1 ::theRealSource $args
	      }

SEE ALSO

       namespace(1T), proc(1T)

KEYWORDS

       command, delete, namespace, rename

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																	rename(1T)

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

__________________________________________________________________________________________________________________________________________________

NAME

       global - Access global variables

SYNOPSIS

       global varname ?varname ...?
_________________________________________________________________

DESCRIPTION

       This command has no effect unless executed in the context of a proc body.  If the global command is executed in the context of a proc body,
       it creates local variables linked to the corresponding global variables (and therefore these variables are listed by info locals).

       If varname contains namespace qualifiers, the local variable's name is the unqualified name of the global variable, as  determined  by  the
       namespace tail command.

EXAMPLES

       This procedure sets the namespace variable ::a::x
	      proc reset {} {
		  global a::x
		  set x 0
	      }

       This  procedure	accumulates the strings passed to it in a global buffer, separated by newlines.  It is useful for situations when you want
       to build a message piece-by-piece (as if with puts) but send that full message in a single piece (e.g. over a connection opened with socket
       or as part of a counted HTTP response).
	      proc accum {string} {
		  global accumulator
		  append accumulator $string 

	      }

SEE ALSO

       namespace(1T), upvar(1T), variable(1T)

KEYWORDS

       global, namespace, procedure, 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																	global(1T)