This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Revise perlintern’s descr of undocumented funcs
authorFather Chrysostomos <sprout@cpan.org>
Mon, 22 Aug 2011 16:33:00 +0000 (09:33 -0700)
committerFather Chrysostomos <sprout@cpan.org>
Mon, 22 Aug 2011 16:33:00 +0000 (09:33 -0700)
autodoc.pl

index 186ebd2..c1e2578 100644 (file)
@@ -271,7 +271,7 @@ _EOH_
 
     if (@$missing) {
         print $fh "\n=head1 Undocumented functions\n\n";
-    print $fh <<'_EOB_';
+    print $fh $podname eq 'perlapi' ? <<'_EOB_' : <<'_EOB_';
 The following functions have been flagged as part of the public API,
 but are currently undocumented. Use them at your own risk, as the
 interfaces are subject to change.
@@ -283,6 +283,13 @@ the interface is stable (unless it is explicitly marked otherwise).
 =over
 
 _EOB_
+The following functions are currently undocumented.  If you use one of
+them, you may wish to consider creating and submitting documentation for
+it.
+
+=over
+
+_EOB_
     for my $missing (sort @$missing) {
         print $fh "=item $missing\nX<$missing>\n\n";
     }