Manual Pages for UNIX Operating System command usage for man rename

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  invo-
     cations 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 com-
     mands  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  attri-
     butes:













Tcl                       Last change:                          1






Tcl Built-In Commands                                  rename(1T)



     _______________________________________
    |   ATTRIBUTE TYPE   |  ATTRIBUTE VALUE|
    |____________________|__________________|_
    | Availability       |  runtime/tcl-8  |
    |____________________|__________________|_
    | Interface Stability|  Uncommitted    |
    |____________________|_________________|

NOTES
     Source for Tcl is available on http://opensolaris.org.













































Tcl                       Last change:                          2