summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--av.h6
1 files changed, 4 insertions, 2 deletions
diff --git a/av.h b/av.h
index 9b9df22487..505620fa78 100644
--- a/av.h
+++ b/av.h
@@ -132,8 +132,10 @@ This might be called directly:
Or it might be called implicitly when the first element is stored:
(void)av_store(av, 0, sv);
-Unused array elements are typically initialized by C<av_extend>, but this
-is undesirable and will not be the case for some specific arrays.
+Unused array elements are typically initialized by C<av_extend>. (Only
+core maintainers should have need to concern themseleves with when that
+is not the case. Refer to F<av.h> and F<av.c> for the differences between
+real and fake AVs.)
In contrast, when an AV is created for immediate population with a known
(or likely) number of elements, it is more efficient to immediately