summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authordkf <donal.k.fellows@manchester.ac.uk>2009-11-02 09:54:44 (GMT)
committerdkf <donal.k.fellows@manchester.ac.uk>2009-11-02 09:54:44 (GMT)
commite62716c266ab1511101551c6dd792bbad4d905cc (patch)
treeebffb6f26ef8968a1d83603f5b9d2f114e0b8dab /doc
parent43e9577d9668906d453aac7d1af0f8fa831a1070 (diff)
downloadtcl-e62716c266ab1511101551c6dd792bbad4d905cc.zip
tcl-e62716c266ab1511101551c6dd792bbad4d905cc.tar.gz
tcl-e62716c266ab1511101551c6dd792bbad4d905cc.tar.bz2
Improve the general description.
Diffstat (limited to 'doc')
-rw-r--r--doc/object.n22
1 files changed, 17 insertions, 5 deletions
diff --git a/doc/object.n b/doc/object.n
index 0836728..68d642b 100644
--- a/doc/object.n
+++ b/doc/object.n
@@ -4,7 +4,7 @@
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
-'\" RCS: @(#) $Id: object.n,v 1.4 2008/10/17 10:22:25 dkf Exp $
+'\" RCS: @(#) $Id: object.n,v 1.5 2009/11/02 09:54:45 dkf Exp $
'\"
.so man.macros
.TH object n 0.1 TclOO "TclOO Commands"
@@ -26,12 +26,24 @@ package require TclOO
.SH DESCRIPTION
.PP
The \fBoo::object\fR class is the root class of the object hierarchy; every
-object (and hence every class) is an instance of this class. Objects are
-always referred to by their name, and may be \fBrename\fRd while maintaining
-their identity. Each object has a unique namespace associated with it.
+object is an instance of this class. Since classes are themselves objects,
+they are instances of this class too. Objects are always referred to by their
+name, and may be \fBrename\fRd while maintaining their identity.
+.PP
Instances of objects may be made with either the \fBcreate\fR or \fBnew\fR
methods of the \fBoo::object\fR object itself, or by invoking those methods on
-any of the subclass objects; see \fBoo::class\fR for more details.
+any of the subclass objects; see \fBoo::class\fR for more details. The
+configuration of individual objects (i.e., instance-specific methods, mixed-in
+classes, etc.) may be controlled with the \fBoo::objdefine\fR command.
+.PP
+Each object has a unique namespace associated with it, the instance namespace.
+This namespace holds all the instance variables of the object, and will be the
+current namespace whenever a method of the object is invoked (including a
+method of the class of the object). When the object is destroyed, its instance
+namespace is deleted. The instance namespace contains the object's \fBmy\fR
+command, which may be used to invoke non-exported methods of the object or to
+create a reference to the object for the purpose of invokation which persists
+across renamings of the object.
.SS CONSTRUCTOR
The \fBoo::object\fR class does not define an explicit constructor.
.SS DESTRUCTOR