[Perl/perl5] 2293fc: autodoc.pl: Generate missing pod for back-compat s...
[email protected] (Karl Williamson via perl5-changes)
| Newsgroups | perl.perl5.changes |
|---|---|
| Message-ID | <Perl/perl5/push/refs/heads/blead/[email protected]> |
Branch: refs/heads/blead
Home: https://github.com/Perl/perl5
Commit: 2293fca4af8be4e7d4d32c9a68608011b80bcd34
https://github.com/Perl/perl5/commit/2293fca4af8be4e7d4d32c9a68608011b80bcd34
Author: Karl Williamson <[email protected]>
Date: 2026-08-06 (Thu, 06 Aug 2026)
Changed paths:
M autodoc.pl
M perl.h
M regen/embed.pl
Log Message:
-----------
autodoc.pl: Generate missing pod for back-compat symbols
It's a pain to write documentation. That helps explain why We have >3K
undocumented symbols visible to the outside world.
With symbols that are retained just for backwards compatibility, that
may well be all that a module maintainer needs to know: Don't use it for
new code. And that pod can be automatically generated.
This commit adds that ability and uses it for 4 symbols. There are
dozens more that could benefit from this, but I'm starting with just
these to get people's reactions.
To unsubscribe from these emails, change your notification settings at https://github.com/Perl/perl5/settings/notifications