[Mu] document bless and CREATE

Author: moritz

lib/Mu.pod

@@ -73,6 +73,42 @@ used to initialize attributes with accessors of the same name.
 Classes may provide
 their own C<new> method to override this default.
 
+=head2 bless
+
+    method bless(Mu $candidate, *%attrinit) returns Mu:D
+
+Lower-level object construction method than C<new>.
+
+If you pass a C<Whatever> as a candidate, it creates a new object
+of the same type as the invocant, and then uses the named arguments
+to initialize attributes.
+
+If you pass something else than a C<Whatever> object as a candidate,
+it simply does the attribute initialization on the C<$candidate>.
+
+In both cases, the object with the attributes initialized is returned.
+
+You can use this method when writing custom constructors:
+
+    class Point {
+        has $.x;
+        has $.y;
+        multi method new($x, $y) {
+            self.bless(:$x, :$y);
+        }
+    }
+    my $p = Point.new(-1, 1);
+
+(Though each time you write a custom constructor, remember that it makes
+subclassing harder).
+
+=head2 CREATE
+
+    method CREATE() returns Mu:D
+
+Allocates a new object of the same type as the invocant, without
+initializating any attributes.
+
 =head2 print
 
     multi method print() returns Bool:D