Commits

Anonymous committed f5e2d36

Clarified the comments.

Comments (0)

Files changed (1)

perl5/ext-embed-internals/docbook/examples/incremental-examples-1/XSTest/lib/XSTest.xs

                          * reference it in another place and av_push
                          * does not do it for us.
                          * 
-                         * This is a variation of SvREFCNT_inc which has
-                         * some limitations that don't matter here.
+                         * SvREFCNT_inc_void_NN is a variation of SvREFCNT_inc 
+                         * which has some limitations that don't matter here.
                          * 
                          * From the documentation (perldoc perlapi):
                          *
                                that sv is not NULL.  The macro doesn't need to
                                return a meaningful value, or check for
                                NULLness, so it's smaller and faster.
+
+                         * av_fetch cannot return a non-NULL SV** that points
+                         * to a NULL SV*.
                          * */
 
                         SvREFCNT_inc_void_NN(*elem);