diff options
author | Karl Williamson <khw@cpan.org> | 2019-08-29 16:28:33 -0600 |
---|---|---|
committer | Karl Williamson <khw@cpan.org> | 2019-09-02 21:52:10 -0600 |
commit | 6523e10866e3893ff5c1e43a5160cf3108653da8 (patch) | |
tree | 587392a5de8db5601293549704be3f3554fd348a /autodoc.pl | |
parent | 2d8eeddb93c080f250dbf8ea5dd5da40b90976d2 (diff) | |
download | perl-6523e10866e3893ff5c1e43a5160cf3108653da8.tar.gz |
autodoc.pl: Add h flag for hidden documentation
This is to be used when the documentation exists, but isn't the typical
sort in perlapi or perlintern.
Diffstat (limited to 'autodoc.pl')
-rw-r--r-- | autodoc.pl | 4 |
1 files changed, 4 insertions, 0 deletions
diff --git a/autodoc.pl b/autodoc.pl index c896b5381b..9175b00e9b 100644 --- a/autodoc.pl +++ b/autodoc.pl @@ -120,6 +120,8 @@ Expected: =for apidoc flags|returntype|name =for apidoc name EOS + next FUNC if $flags =~ /h/; + warn ("'$name' not \\w+ in '$proto_in_file' in $file") if $flags !~ /N/ && $name !~ / ^ [_[:alpha:]] \w* $ /x; my $docs = ""; @@ -146,6 +148,7 @@ DOC: $flags = $embed_docref->{'flags'}; warn "embed.fnc entry '$name' missing 'd' flag" unless $flags =~ /d/; + next FUNC if $flags =~ /h/; $ret = $embed_docref->{'retval'}; @args = @{$embed_docref->{args}}; } elsif ($flags !~ /m/) { # Not in embed.fnc, is missing if not a @@ -369,6 +372,7 @@ close $fh or die "Error whilst reading MANIFEST: $!"; for (sort keys %funcflags) { next unless $funcflags{$_}{flags} =~ /d/; + next if $funcflags{$_}{flags} =~ /h/; warn "no docs for $_\n" } |