Merge pull request #2012 from Kaiepi/nativecall

Document CArray.allocate

Author: Kaiepi

doc/Language/nativecall.pod6

@@ -287,10 +287,8 @@ subroutine, otherwise the C function may stomp all over Perl's memory
 leading to possibly unpredictable behaviour:
 
 =begin code :skip-test
-my $ints = CArray[int32].new;
 my $number_of_ints = 10;
-$ints[$number_of_ints - 1] = 0; # extend the array to 10 items
-
+my $ints = CArray[int32].allocate($number_of_ints); # instantiates an array with 10 elements
 my $n = get_n_ints($ints, $number_of_ints);
 =end code