Re-attempt to clear the hash in S_hfreeentries if anything adds to it.
[p5sagit/p5-mst-13.2.git] / pod / perlapi.pod
index be9249b..e3dac62 100644 (file)
@@ -317,13 +317,24 @@ Sort an array. Here is an example:
 
     sortsv(AvARRAY(av), av_len(av)+1, Perl_sv_cmp_locale);
 
-See lib/sort.pm for details about controlling the sorting algorithm.
+Currently this always uses mergesort. See sortsv_flags for a more
+flexible routine.
 
        void    sortsv(SV** array, size_t num_elts, SVCOMPARE_t cmp)
 
 =for hackers
 Found in file pp_sort.c
 
+=item sortsv_flags
+X<sortsv_flags>
+
+Sort an array, with various options.
+
+       void    sortsv_flags(SV** array, size_t num_elts, SVCOMPARE_t cmp, U32 flags)
+
+=for hackers
+Found in file pp_sort.c
+
 
 =back
 
@@ -845,7 +856,7 @@ potentially warn under some level of strict-ness.
 
 "Superseded" by sv_nosharing().
 
-       void    sv_nolocking(SV *)
+       void    sv_nolocking(SV *sv)
 
 =for hackers
 Found in file mathoms.c
@@ -859,7 +870,7 @@ potentially warn under some level of strict-ness.
 
 "Superseded" by sv_nosharing().
 
-       void    sv_nounlocking(SV *)
+       void    sv_nounlocking(SV *sv)
 
 =for hackers
 Found in file mathoms.c
@@ -1108,6 +1119,19 @@ Return the SV from the GV.
 =for hackers
 Found in file gv.h
 
+=item gv_const_sv
+X<gv_const_sv>
+
+If C<gv> is a typeglob whose subroutine entry is a constant sub eligible for
+inlining, or C<gv> is a placeholder reference that would be promoted to such
+a typeglob, then returns the value returned by the sub.  Otherwise, returns
+NULL.
+
+       SV*     gv_const_sv(GV* gv)
+
+=for hackers
+Found in file gv.c
+
 =item gv_fetchmeth
 X<gv_fetchmeth>
 
@@ -2327,7 +2351,7 @@ Or "locks" it. Or "unlocks" it. In other words, ignores its single SV argument.
 Exists to avoid test for a NULL function pointer and because it could
 potentially warn under some level of strict-ness.
 
-       void    sv_nosharing(SV *)
+       void    sv_nosharing(SV *sv)
 
 =for hackers
 Found in file util.c
@@ -4543,6 +4567,7 @@ X<sv_2cv>
 
 Using various gambits, try to get a CV from an SV; in addition, try if
 possible to set C<*st> and C<*gvp> to the stash and GV associated with it.
+The flags in C<lref> are passed to sv_fetchsv.
 
        CV*     sv_2cv(SV* sv, HV** st, GV** gvp, I32 lref)