Branch: refs/heads/blead
  Home:   https://github.com/Perl/perl5
  Commit: ebb7a94b17bb2e45f958ffc5aabe0eae70625523
      
https://github.com/Perl/perl5/commit/ebb7a94b17bb2e45f958ffc5aabe0eae70625523
  Author: Karl Williamson <k...@cpan.org>
  Date:   2024-02-07 (Wed, 07 Feb 2024)

  Changed paths:
    M av.h

  Log Message:
  -----------
  perlapi, av.h: Need "apidoc_item"

Commit 0d564a3d013287cf0880fdc3264f30c20fe6188d added docs for
newAV_mortal, but it needed to use "apidoc_item", not plain "apidoc".

Not doing so resulted in this build time warning:

Empty pod for newAV (from av.h) at autodoc.pl line 1265.

and the resulting pod/perlapi.pod was incorrect.

Plain "apidoc" is used to begin a new entry.  "apidoc_item" is for
related subsidiary functions to the main entry.

Suggestions welcome as to how to make this relationship more obvious.
Perhaps it should be renamed "apidoc_sub_item"


Reply via email to