From: Paul Fenwick <pjf@perltraining.com.au>
Date: Mon, 6 Jul 2009 05:04:26 +0000 (+1000)
Subject: Docs: Added explanations on 'no Moose' and 'make_immutable'.
X-Git-Tag: 0.87~7
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=b5332f430eed2cf37cbaf345a911d4f4f1675323;p=gitmo%2FMoose.git

Docs: Added explanations on 'no Moose' and 'make_immutable'.

Thanks to nothingmuch for assistance in the explanations.
---

diff --git a/lib/Moose/Manual/BestPractices.pod b/lib/Moose/Manual/BestPractices.pod
index 30c5673..9349718 100644
--- a/lib/Moose/Manual/BestPractices.pod
+++ b/lib/Moose/Manual/BestPractices.pod
@@ -32,8 +32,11 @@ Moose sugar and making your class immutable.
 
   1;
 
-The C<no Moose> bit is simply good code hygiene, and making classes
-immutable speeds up a lot of things, most notably object construction.
+The C<no Moose> bit simply good code hygiene, as it removes all the
+Moose keywords that are no longer needed once your class has been
+built.  C<make_immutable> relinquishes your right to make further
+changes to your class, and allows Moose to speed up a lot of things,
+most notably object construction.
 
 =head2 Never override C<new>