summaryrefslogtreecommitdiffstats
path: root/doc/define.n
diff options
context:
space:
mode:
Diffstat (limited to 'doc/define.n')
-rw-r--r--doc/define.n25
1 files changed, 12 insertions, 13 deletions
diff --git a/doc/define.n b/doc/define.n
index 1030096..883d5fa 100644
--- a/doc/define.n
+++ b/doc/define.n
@@ -477,22 +477,21 @@ concept to the slot.
.VE TIP516
.RE
.TP
-\fIslot\fR \fBResolve\fR \fIelementList\fR
+\fIslot\fR \fBResolve\fR \fIslotElement\fR
.VS TIP516
-Returns a list that is the elements of \fIelementList\fR with a resolution
-operation applied to each of them, but does not modify the slot. For slots of
-simple strings, this is an operation that does nothing. For slots of classes,
-this maps each class name to its fully qualified class name. This method must
-always be called from a stack frame created by a call to \fBoo::define\fR or
-\fBoo::objdefine\fR. This method \fIshould not\fR return an error unless it
-is called from outside a definition context or with the wrong number of
-arguments.
+Returns \fIslotElement\fR with a resolution operation applied to it, but does
+not modify the slot. For slots of simple strings, this is an operation that
+does nothing, whereas for slots of classes, this maps a class name to its
+fully-qualified class name. This method must always be called from a stack
+frame created by a call to \fBoo::define\fR or \fBoo::objdefine\fR. This
+method \fIshould not\fR return an error unless it is called from outside a
+definition context or with the wrong number of arguments; unresolvable
+arguments should be returned as is (as not all slot operations strictly
+require that values are resolvable to work).
.RS
.PP
-Implementations \fIshould not\fR reorder or filter elements in this operation;
-uniqueness and ordering constraints should be enforced in the \fBSet\fR
-method. This is because this method is not normally presented with the full
-contents of the slot (except via the \fB\-set\fR slot operation).
+Implementations \fIshould not\fR enforce uniqueness and ordering constraints
+in this method; that is the responsibility of the \fBSet\fR method.
.RE
.VE TIP516
.TP