document Buf.subbuf

Author: moritz

lib/Buf.pod

@@ -37,4 +37,14 @@ Returns the number of elements of the buffer.
 
 Applies an encoding to turn the buffer into a C<Str>.
 
+=head2 subbuf
+
+    method subbuf(Int $from, Int $len = self.elems) returns Buf:D
+
+Extracts a part of the invocant buffer, statrting from the index with
+elements C<$from>, and taking C<$len> elements (or less if the buffer is
+shorter), and creates a new buffer as the result.
+
+    say Buf.new(1..10).subbuf(2, 4);    # Buf:0x<03 04 05 06>
+
 =end pod