Skip to content

Commit

Permalink
improve the GitHub link regular expression
Browse files Browse the repository at this point in the history
Also, move the "add pod links" part *before* the section
about checking POD.

(cherry picked from commit febfc89)
  • Loading branch information
book authored and steve-m-hay committed Dec 31, 2024
1 parent e06d1b3 commit 65da001
Showing 1 changed file with 4 additions and 4 deletions.
8 changes: 4 additions & 4 deletions Porting/release_managers_guide.pod
Original file line number Diff line number Diff line change
Expand Up @@ -806,6 +806,10 @@ For a MAINT release use something like this instead:
Ideally, also fill in a summary of the major changes to each module for which
an entry has been added by F<corelist-perldelta.pl>.

You should add pod links for GitHub issue references thusly:

$ perl -p -i -e'BEGIN{undef $/}; s{(?:GH|github)\s*#(\d+)}{L<GH #$1|https://github.com/Perl/perl5/issues/$2>}img' pod/perldelta.pod

Re-read the perldelta to try to find any embarrassing typos and thinkos;
remove any C<TODO> or C<XXX> flags; update the "Known Problems" section
with any serious issues for which fixes are not going to happen now; and
Expand All @@ -821,10 +825,6 @@ formatting, e.g.
$ ./perl -Ilib ext/Pod-Html/bin/pod2html pod/perldelta.pod > \
~/perldelta.html

You should add pod links for GitHub issue references thusly:

$ perl -p -i -e'BEGIN{undef $/}; s{((?:GH|github)\s*#)(\d+)}{L<$1$2|https://github.com/Perl/perl5/issues/$2>}img' pod/perldelta.pod

If you make changes, be sure to commit them.

=for checklist skip BLEAD-POINT MAINT RC
Expand Down

0 comments on commit 65da001

Please sign in to comment.