Document Buf.reallocate

Author: lizmat

doc/Type/Buf.pod6

@@ -27,6 +27,7 @@ For example, to replace one element at index 3 with two elements, C<100> and C<1
     my Buf $b .= new(0..5);
     $b.subbuf-rw(3,1) = Buf.new(100, 101);
     say $b.perl;   # OUTPUT: «Buf.new(0,1,2,100,101,4,5)␤»
+
 =head2 routine subbuf-rw
 
     sub subbuf-rw(Buf:D $buf, $from, $length?)
@@ -37,6 +38,19 @@ Returns a writable reference to a part of a buffer. Similar to the C<subbuf-rw>
     subbuf-rw($b,2,1) = Buf.new(42);
     say $b.perl;   # OUTPUT: «Buf.new(1,2,42)␤»
 
+=head2 method reallocate
+
+    method reallocate($elems)
+
+Change the number of elements of the C<Buf>.  The C<Buf> will be made larger if
+the specified value is larger than the current number of elements.  The value of
+newly created elements is undetermined and should thus not be relied upon.  It
+returns the altered C<Buf>.
+
+    my Buf $b .= new(^10);
+    $b.reallocate(5);
+    say $b.perl;  # OUTPUT: «Buf.new(0,1,2,3,4)␤»
+
 =end pod
 
 # vim: expandtab softtabstop=4 shiftwidth=4 ft=perl6