This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
fixup some AV API pod descriptions.
authorDavid Mitchell <davem@iabyn.com>
Tue, 27 Sep 2016 08:51:45 +0000 (09:51 +0100)
committerDavid Mitchell <davem@iabyn.com>
Tue, 27 Sep 2016 10:19:00 +0000 (11:19 +0100)
commit17b0bd7713345613d9d19e31a82f42fc48ddcfc5
tree9b9518f46b95e8c86e99ec64a7586c1b84304ca8
parent8944d2e9909e3336200cbf2ead2a819cc78f4986
fixup some AV API pod descriptions.

In particular:

* improve  some of the "perl equivalent" entries; for example
  av_store() is *not* like $myarray[$key] = $val, since it replaces the
  stored SV with a different SV, rather than just updating the current
  SV's value.

* Also change the "perl equivalent" variable names to match the function
  parameter names, e.g. $key rather than $idx.

* Don't use 'delete' as a perl equivalent, since delete is discouraged on
  arrays.

* You don't *have* to use av_store() to change undef values inserted by
  av_unshift; e.g. you could do av_fetch() then modify the returned
  undef SV; so just delete that sentence
av.c