A couple years ago I wrote a little Perl6 in response to a challenge,
and it took me a while to figure out BUILD, BUILDALL, and new().
Learning the object model meant reading what was available on the web
plus some time on the #perl6 IRC channel. I managed to get it all
working properly for my little code, but it didn't make complete sense
to me until later when I did a Perl5 project with Moose. Moose's
cookbooks, examples, and documentation explained the concepts &
implementation a few different ways. Moose borrowed a lot from Perl6,
and it helped me understand the why's & how's of Perl6.

Alas, Perl6's "distributed docs" is a known issue (so much to write!).
As an illustration, this thread got me curious as to these .+ and .*
operators and Perl6's "TEARDOWN", so I searched for "perl6 object
teardown". The first link I clicked from that search was
http://doc.perl6.org/language/objects - which is a great intro - but
it doesn't mention teardown/destruction, nor these operators. "perl6
object +teardown" didn't seem to return any user-facing docs at all,
other than "Apocalypses" which are not current. Searching for "perl6
object destroy" shows me that it is implemented via
http://perl6.org/compilers/features - with no links to spec or code.

I enjoy reading these explanations as to how these operators are
useful, and the example referencing TEARDOWN, can they go into some
documentation for future readers? In a context to help me see how they
fit? Or is there already a doc that I'm not seeing in my searches?


Reply via email to