In perl.git, the branch blead has been updated
<http://perl5.git.perl.org/perl.git/commitdiff/72d4186d0bdc8e5f58ebdef073e50de084a467f9?hp=8c805412635e3f5401139836431a9f9328eb75f5>
- Log -----------------------------------------------------------------
commit 72d4186d0bdc8e5f58ebdef073e50de084a467f9
Author: Karl Williamson <k...@cpan.org>
Date: Wed Oct 12 18:30:11 2016 -0600
autodoc.pl: Allow =item lists in perlapi
Such lists were silently ignored. This fixes things so no pod commands
are silently ignored, and hence lists are now accepted in a function's
pod. This fixes the entry for 'vverify', whose =item list was not
getting picked up.
M autodoc.pl
commit ef7ea7adea12b6588505816360b213a22231e87e
Author: Karl Williamson <k...@cpan.org>
Date: Wed Oct 12 18:27:26 2016 -0600
perlapi: Fix docs for 2 scope related macros
These 2 macros were using =item instead of =for apidoc, so they silently
were not included in perlapi. This commit also changes their
references to links.
M scope.h
-----------------------------------------------------------------------
Summary of changes:
autodoc.pl | 7 +++++--
scope.h | 12 ++++--------
2 files changed, 9 insertions(+), 10 deletions(-)
diff --git a/autodoc.pl b/autodoc.pl
index 161310d..ce4846e 100644
--- a/autodoc.pl
+++ b/autodoc.pl
@@ -110,11 +110,14 @@ HDR_DOC:
my $docs = "";
DOC:
while (defined($doc = $get_next_line->())) {
- last DOC if $doc =~ /^=\w+/;
+
+ # Other pod commands are considered part of the current
+ # function's docs, so can have lists, etc.
+ last DOC if $doc =~ /^=(cut|for\s+apidoc|head)/;
if ($doc =~ m:^\*/$:) {
warn "=cut missing? $file:$line:$doc";;
last DOC;
- }
+ }
$docs .= $doc;
}
$docs = "\n$docs" if $docs and $docs !~ /^\n/;
diff --git a/scope.h b/scope.h
index ad276a9..88c182d 100644
--- a/scope.h
+++ b/scope.h
@@ -167,20 +167,16 @@ Opening bracket on a callback. See C<L</LEAVE>> and
L<perlcall>.
=for apidoc Ams||LEAVE
Closing bracket on a callback. See C<L</ENTER>> and L<perlcall>.
-=over
+=for apidoc Ams||ENTER_with_name(name)
-=item ENTER_with_name(name)
-
-Same as C<ENTER>, but when debugging is enabled it also associates the
+Same as C<L</ENTER>>, but when debugging is enabled it also associates the
given literal string with the new scope.
-=item LEAVE_with_name(name)
+=for apidoc Ams||LEAVE_with_name(name)
-Same as C<LEAVE>, but when debugging is enabled it first checks that the
+Same as C<L</LEAVE>>, but when debugging is enabled it first checks that the
scope has the given name. C<name> must be a C<NUL>-terminated literal string.
-=back
-
=cut
*/
--
Perl5 Master Repository
