Program to prepare dual-life distributions for insertion into the Perl 5
F<lib/> and F<t/> directories. Now thought to be largely superseded.
-=head2 F<bisect-example.sh>
-
-=head2 F<bisect-runner.pl> and F<bisect.pl>
+=head2 F<bisect-example.sh>, F<bisect.pl> and F<bisect-runner.pl>
Use C<git bisect> to pinpoint changes.
Performs pathname portability checks, including whether there are naming
conflicts when names are truncated to the DOSish, case-ignoring 8.3 format.
-=head2 F<checkAUTHORS.pl>
-
-Used by F<t/porting/authors.t> to ensure the F<AUTHORS> list is up to date.
-
-=head2 F<checkURL.pl>
-
-Checks that all the URLs in the Perl source are valid.
-
-=head2 F<checkVERSION.pl>
-
-Used by F<t/porting/cmp_version.t> to ensure changed modules have had their
-versions updated.
-
=head2 F<checkansi.pl>
Check source code for ANSI-C violations.
+=head2 F<checkAUTHORS.pl>
+
+Used by F<t/porting/authors.t> to ensure the F<AUTHORS> list is up to date.
+
=head2 F<checkcfgvar.pl>
Check that the various F<config.sh>-clones have (at least) all the same
Check if POD files contain non-ASCII without specifying
encoding. Run it as: C<perl Porting/checkpodencoding.pl>.
+=head2 F<checkURL.pl>
+
+Checks that all the URLs in the Perl source are valid.
+
+=head2 F<checkVERSION.pl>
+
+Used by F<t/porting/cmp_version.t> to ensure changed modules have had their
+versions updated.
+
=head2 F<cherrymaint>
Command line tool to update cherrymaint; a tool for selecting commits from
=head2 F<config.sh>
-This file was produced by running the F<Configure> script. It holds all the
-definitions figured out by F<Configure>. Should you modify one of these
-values, do not forget to propagate your changes by running C<Configure -der>.
-You may instead choose to run each of the F<.SH> files by yourself, or
-C<Configure -S>.
+This file is a sample F<config.sh> file. F<config.sh> is normally
+produced by running the F<Configure> script. It holds all the definitions
+figured out by F<Configure>. If you are unable to successfully run
+F<Configure> on your system, copy this sample file to F<config.sh>
+at the top of the perl source tree and edit it to suit your system.
+Then propagate those values by running C<Configure -S>. This sample
+file is normally updated each time F<Configure> is updated.
=head2 F<core-cpan-diff>
Prints a table of differences between two Perl versions with respect to
modules included in the distribution.
-=head2 F<corelist.pl>
-
-Generates info for Module::CoreList from this perl tree.
-
=head2 F<corelist-perldelta.pl>
Generates a list of the module changes for the Perl you are currently
building. Also generates a diff between the corelist sections of two
F<perldelta*> files.
-=head2 F<curliff.pl>
+=head2 F<corelist.pl>
-Convert certain files in the Perl distribution that need to be in CR-LF format
-to CR-LF, or back to LF format (with the -r option). The CR-LF format is NOT
-to be used for checking in files to the Perforce repository, but it IS to be
-used when making Perl snapshots or releases.
+Generates info for Module::CoreList from this perl tree.
=head2 F<epigraphs.pod>
This script finds reentrant variants of functions used in an executable and
shared objects.
-=head2 F<GitUtils.pm>
-
-This script contains the subroutine to generate a F<.patch file> for a
-committish (the SHA1 checksum of a commit, a number made of 40 hexadecimal
-digits which acts the internal unique identifier for this commit
-(lilypond.org). Related file: F<make_dot_patch.pl>
-
=head2 F<git-deltatool>
This script, a rough draft, aids in generating a perldelta file
This script creates a tag for every p4raw-id.
+=head2 F<GitUtils.pm>
+
+This script contains the subroutine to generate a F<.patch file> for a
+committish (the SHA1 checksum of a commit, a number made of 40 hexadecimal
+digits which acts the internal unique identifier for this commit
+(lilypond.org). Related file: F<make_dot_patch.pl>
+
=head2 F<Glossary>
This file is built by F<metaconfig>. This file contains a description of all
the shell variables whose value is determined by the Configure script.
+It later gets incorporated into the pod for F<Config.pm>.
=head2 F<how_to_write_a_perldelta.pod>
A package to search and show information about which core files/modules are
associated with maintainers. Related files: F<Maintainers>, F<Maintainers.pl>
-=head2 F<make-rmg-checklist>
-
-This script creates a release checklist as a simple HTML document.
-
=head2 F<make_dot_patch.pl>
Generate a F<.patch> file to STDOUT for a commit ID specified on the
command-line.
+=head2 F<makemeta>
+
+This script creates F<META.yml> and F<META.json> files.
+
=head2 F<make_modlib_cpan.pl>
This script generates the list of registered CPAN sites in F<perlmodlib.PL>.
-=head2 F<make_snapshot.pl>
+=head2 F<makerel>
-This script is a quick and dirty snapshot generator for the perl5.git.perl.org
-web page to use to generate the snapshot files.
+This script builds a Perl release tarball.
-=head2 F<makemeta>
+=head2 F<make-rmg-checklist>
-This script creates F<META.yml> and F<META.json> files.
+This script creates a release checklist as a simple HTML document.
-=head2 F<makerel>
+=head2 F<make_snapshot.pl>
-This script builds a Perl release tarball.
+This script is a quick and dirty snapshot generator for the perl5.git.perl.org
+web page to use to generate the snapshot files.
=head2 F<manicheck>
=head2 F<pumpkin.pod>
Pumpkin - Notes on handling the Perl Patch Pumpkin And Porting Perl.
+Many of these are out of date or superseded by other documents in
+this directory.
+
+=head2 F<README.pod>
+
+This file. An exhaustive list of the contents of the F<Porting/>
+directory along with a description of each file.
+The test F<t/porting/readme.t> ensures that this lists every file
+and that every file is listed.
=head2 F<README.y2038>
=head2 F<release_announcement_template.txt>
-Release announcment for minor releasements of the 5.17 development series.
+Release announcement for minor releasements of the 5.19 development series.
=head2 F<release_managers_guide.pod>
F<perldiag.pod>. POD formatting, printf-style escapes, non-letter characters,
and case are ignored, as explained in L<perldiag>.
-=head2 F<testall.atom>
-
-Test suite profiling on Tru 64.
-
-=head2 F<thirdclean>
-
-Script for cleaning out the "known noise" from Third Degree reports: either
-noise caused by F<libc> itself, or F<Perl_yyparse> leaks.
-
-=head2 F<time>
+=head2 F<sync-with-cpan>
-A helper tool for perl's 2038 support. See F<Porting/README.y2038> for details.
+Script to help out with syncing cpan distros.
=head2 F<timecheck2.c>
at L<http://perl5.git.perl.org/perl.git/blob_plain/HEAD:/Porting/todo.pod>.
The tasks we think are smaller or easier are listed first. Anyone is welcome
to work on any of these, but it's a good idea to first contact
-
F<perl5-porters@perl.org> to avoid duplication of effort, and to learn from
+
I<perl5-porters@perl.org> to avoid duplication of effort, and to learn from
any previous attempts.
=head2 F<valgrindpp.pl>
https://perl5.git.perl.org / perl5.git / blobdiff