From f5d13a25262cb242090ad5e0703cf287e26156db Mon Sep 17 00:00:00 2001 From: Karl Williamson Date: Sat, 12 Jan 2013 08:48:01 -0700 Subject: [PATCH] perlapi: Clarify av_pop This notes that the caller now has control of a reference count of the returned SV. Wording mostly suggested by Paul Evans --- av.c | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/av.c b/av.c index b251822..475496d 100644 --- a/av.c +++ b/av.c @@ -592,8 +592,9 @@ Perl_av_push(pTHX_ AV *av, SV *val) /* =for apidoc av_pop -Pops an SV off the end of the array. Returns C<&PL_sv_undef> if the array -is empty. +Removes one SV from the end of the array, reducing its size by one and +returning the SV (transferring control of one reference count) to the +caller. Returns C<&PL_sv_undef> if the array is empty. Perl equivalent: C -- 1.8.3.1