There is nothing magical about an attribute that isa => ArrayRef any more than an attribute that isa => Str. The former holds an array reference, the later a string. That is all, no other magic is done under the covers to make Perl 5's ugly dereferencing syntax go away.

Simply put, I think you are expecting to see magic where none actually exists.

I'm getting very frustrated with the Moose documentation. There is certainly a ton of documentation, but it skips from bare basics, up to the clouds, with very little in between

Yes, Moose documentation is lacking in places, we know this and are working to improve it, help is always appreciated. I run an audreyt/Pugs-style project too, so if you want a commit-bit just come on over to #moose and ask for one and you can start improving the docs right away.

In the meantime here are some suggestions which you may not have seen, all of which are accessible from the Moose homepage http://moose.perl.org:

-stvn

In reply to Re: Using ArrayRef data members in Moose by stvn
in thread Using ArrayRef data members in Moose by dmorgo

Title:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post, it's "PerlMonks-approved HTML":


  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, details, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  • You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.