Simplify the slot resolution protocol

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