Quote:
Originally posted by michi
[snip]
The upshot of all of this is that, if you define a Slice parameter as foo, you *must* pass a class instance when invoking the operation, whereas, if you define Slice parameter as foo*, you *must* pass a proxy.
|
Thanks for the explanation. I suspected that was it after I read the section on Slice classes. However, when you're reading the documentation in order, you can't know that there is that other possibility yet, and so the "*" syntax is confusing.
Some kind of forward reference is definitely needed. Perhaps something briefly outlining that there are also classes that can also implement interfaces, hence the conflict, and that "we'll get to that later in the class section".
Then I think the readers brain will just push the question of what the "*" is disambiguating onto their mental stack until later ...
Regards,
Derek.