summaryrefslogtreecommitdiff
path: root/regen
diff options
context:
space:
mode:
authorAaron Crane <arc@cpan.org>2018-06-25 15:42:33 +0100
committerAaron Crane <arc@cpan.org>2018-07-22 13:06:55 +0100
commit4bbd41f5cf100c72f174c530ef146ca94952a289 (patch)
tree9ecb6ee760e68a081a36d579c87c3d653d3f1eed /regen
parent2027d3658f4b767823e788e70ad97e67d3aa4ff2 (diff)
downloadperl-4bbd41f5cf100c72f174c530ef146ca94952a289.tar.gz
Ensure perlmodlib.pod contains all non-dual-life modules
The pod/perlmodlib.pod file is generated at build time by pod/perlmodlib.PL, which looks at the POD of library and pragma files to find "=head1 NAME" directives. It reads each file a paragraph at a time ($/ = ""), and considers each individual paragraph as potentially containing POD. However, if it finds no "=head1 NAME" entry in a module, it silently ignores it. That's reasonable for dual-life modules — there's often a good reason why a particular file has no POD — but for single-life modules, this could well indicate an issue. In particular, commit effd17dc012719d584aa712c6c7bd5dc142885b6, as part of rearranging the contents of lib/warnings.pm, inadvertently changed the context of its "=head1 NAME" line so that it's no longer the start of a paragraph. This had the effect of removing warnings.pm from perlmodlib; that gap was pointed out by pink_mist++ on IRC. The fix for that is trivial: add a blank in the appropriate place in regen/warnings.pl, and regen. The change to pod/perlmodlib.PL to die on missing "=head1 NAME" lines has also yielded a second module (Config::Extensions) that was missing from perlmodlib for the same reason; that's also fixed in this commit.
Diffstat (limited to 'regen')
-rw-r--r--regen/warnings.pl1
1 files changed, 1 insertions, 0 deletions
diff --git a/regen/warnings.pl b/regen/warnings.pl
index 69084239f1..8b7ac2c048 100644
--- a/regen/warnings.pl
+++ b/regen/warnings.pl
@@ -860,6 +860,7 @@ delete @warnings::{qw(NORMAL FATAL MESSAGE LEVEL)};
1;
__END__
+
=head1 NAME
warnings - Perl pragma to control optional warnings