[Help-smalltalk] Re: Dictionary>>#addAll: fails

[Stephen Compall]

Jānis Rūcis wrote:
>     "Answer a new instance of Dictionary initialized from the keys and
>     values of Associations in anArray.  This method is for convenience
>     only;  it allows its argument to be conveniently specified as a
>     braced Array literal that is structured accordingly:  {'key' ->
>     'value'. 'another key' -> 'another value'}."
>
> And maybe suggest that any other usage is considered "misuse" and is
> "strongly discouraged or bad things will happen"...  :)  Basically I
> think it should make it very clear that it's there for convenience.

I would like to avoid repeating what is already said in Collection 
class>>#from:'s docstring.  Is there a way to document Dictionary in a 
way that is less confusing but avoids explaining what is already 
specified elsewhere?

--
;;; Stephen Compall ** http://scompall.nocandysw.com/blog **
Failure to imagine vast possibilities usually stems from a lack of 
imagination, not a lack of possibility.