More tweaking of t0m's doc changes
Dave Rolsky [Fri, 29 Aug 2008 17:40:43 +0000 (17:40 +0000)]
lib/Moose/Cookbook/FAQ.pod

index ee14c71..74f06d1 100644 (file)
@@ -284,17 +284,14 @@ is not called for my composed roles?> question in the B<Roles> section.
 
 =head3 What are Traits, and how are they different to Roles?
 
-In Moose, a trait is almost exactly the same thing as a role, except that 
-traits typically register themselves, and thus can be referred to by a short name. 
-
-The word I<Role> is typically used to indicate a class building block, which 
-is composed into a class at class composition time, whereas I<Trait> is used to
-indicate functionality which is composed into an instance of a class at runtime 
-to add or modify the behavior of B<that instance>.
-
-But this is all just convention, so don't take it too seriously - nobody
-is going to yell at you if you use them interchangeably, or use one instead
-of the other.
+In Moose, a trait is almost exactly the same thing as a role, except
+that traits typically register themselves, which allows you to refer
+to them by a short name ("Big" vs "MyApp::Role::Big").
+
+In Moose-speak, a I<Role> is usually composed into a I<class> at
+compile time, whereas a I<Trait> is usually composed into an instance
+of a class at runtime to add or modify the behavior of B<just that
+instance>.
 
 Outside the context of Moose, traits and roles generally mean exactly the
 same thing. The original paper called them Traits, however Perl 6 will call