summaryrefslogtreecommitdiffstats
path: root/tcl8.6/doc/copy.n
diff options
context:
space:
mode:
Diffstat (limited to 'tcl8.6/doc/copy.n')
-rw-r--r--tcl8.6/doc/copy.n76
1 files changed, 0 insertions, 76 deletions
diff --git a/tcl8.6/doc/copy.n b/tcl8.6/doc/copy.n
deleted file mode 100644
index 789a76c..0000000
--- a/tcl8.6/doc/copy.n
+++ /dev/null
@@ -1,76 +0,0 @@
-'\"
-'\" Copyright (c) 2007 Donal K. Fellows
-'\"
-'\" See the file "license.terms" for information on usage and redistribution
-'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
-'\"
-.TH copy n 0.1 TclOO "TclOO Commands"
-.so man.macros
-.BS
-'\" Note: do not modify the .SH NAME line immediately below!
-.SH NAME
-oo::copy \- create copies of objects and classes
-.SH SYNOPSIS
-.nf
-package require TclOO
-
-\fBoo::copy\fI sourceObject \fR?\fItargetObject\fR? ?\fItargetNamespace\fR?
-.fi
-.BE
-.SH DESCRIPTION
-.PP
-The \fBoo::copy\fR command creates a copy of an object or class. It takes the
-name of the object or class to be copied, \fIsourceObject\fR, and optionally
-the name of the object or class to create, \fItargetObject\fR, which will be
-resolved relative to the current namespace if not an absolute qualified name
-and
-.VS TIP473
-\fItargetNamespace\fR which is the name of the namespace that will hold the
-internal state of the object (\fBmy\fR command, etc.); it \fImust not\fR
-refer to an existing namespace.
-If either \fItargetObject\fR or \fItargetNamespace\fR is omitted or is given
-as the empty string, a new name is chosen. Names, unless specified, are
-chosen with the same algorithm used by the \fBnew\fR method of
-\fBoo::class\fR.
-.VE TIP473
-The copied object will be of the same class as the source object, and will have
-all its per-object methods copied. If it is a class, it will also have all the
-class methods in the class copied, but it will not have any of its instances
-copied.
-.PP
-.VS
-After the \fItargetObject\fR has been created and all definitions of its
-configuration (e.g., methods, filters, mixins) copied, the \fB<cloned>\fR
-method of \fItargetObject\fR will be invoked, to allow for customization of
-the created object such as installing related variable traces. The only
-argument given will be \fIsourceObject\fR. The default implementation of this
-method (in \fBoo::object\fR) just copies the procedures and variables in the
-namespace of \fIsourceObject\fR to the namespace of \fItargetObject\fR. If
-this method call does not return a result that is successful (i.e., an error
-or other kind of exception) then the \fItargetObject\fR will be deleted and an
-error returned.
-.VE
-.PP
-The result of the \fBoo::copy\fR command will be the fully-qualified name of
-the new object or class.
-.SH EXAMPLES
-.PP
-This example creates an object, copies it, modifies the source object, and
-then demonstrates that the copied object is indeed a copy.
-.PP
-.CS
-oo::object create src
-oo::objdefine src method msg {} {puts foo}
-\fBoo::copy\fR src dst
-oo::objdefine src method msg {} {puts bar}
-src msg \fI\(-> prints "bar"\fR
-dst msg \fI\(-> prints "foo"\fR
-.CE
-.SH "SEE ALSO"
-oo::class(n), oo::define(n), oo::object(n)
-.SH KEYWORDS
-clone, copy, duplication, object
-.\" Local variables:
-.\" mode: nroff
-.\" fill-column: 78
-.\" End: