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>, F<bisect-runner.pl> and F<bisect.pl>
+=head2 F<bench.pl>
+
+Do performance analysis on the code snippets in F<t/perf/benchmarks>.
+
+=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>
+=head2 F<checkansi.pl>
-Checks that all the URLs in the Perl source are valid.
+Check source code for ANSI-C violations.
-=head2 F<checkVERSION.pl>
+=head2 F<checkAUTHORS.pl>
-Used by F<t/porting/cmp_version.t> to ensure changed modules have had their
-versions updated.
+Used by F<t/porting/authors.t> to ensure the F<AUTHORS> list is up to date.
-=head2 F<checkansi.pl>
+=head2 F<checkcfguse.pl>
-Check source code for ANSI-C violations.
+Check where the symbols defined in the various F<config.sh>-clones
+are being used. VMS is probably not handled properly here.
=head2 F<checkcfgvar.pl>
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
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<corelist.pl>
+
+Generates info for Module::CoreList from this perl tree.
+
+=head2 F<deparse-skips.txt>
+
+List of test files to ignore/skip for deparse tests.
+
=head2 F<epigraphs.pod>
List of Perl release epigraphs.
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<harness-timer-report.pl>
+
+For analyzing the output of "env HARNESS_TIMER=1 make test", to find
+outliers of test execution times.
+
=head2 F<how_to_write_a_perldelta.pod>
This file contains a specification as to 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>
This script outputs a list of files in F<MANIFEST> which don't exist and a
list of files that exist and aren't in F<MANIFEST>.
+=head2 F<manifest_lib.pl>
+
+This library provides functions used in checking and sorting the F<MANIFEST>.
+
=head2 F<manisort>
This script sorts the files in F<MANIFEST>.
+=head2 F<mksample>
+
+This script regenerates F<Porting/config.sh> and F<Porting/config_H>.
+
=head2 F<new-perldelta.pl>
This script automates the process for creating perldelta.pl.
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>
The y2038 implementation for perl. This is an implementation of POSIX time.h
which solves the year 2038 bug on systems where time_t is only 32 bits. It is
implemented in bog-standard ANSI C. The latest version can be found at
-L<http://y2038.googlecode.com/>.
+L<https://github.com/evalEmpire/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>
Shell script to list patches in RT.
+=head1 F<security_template.pod>
+
+Template to guide writers of a perl 5 security vulnerability
+announcement.
+
=head2 F<sort_perldiag.pl>
This is a script for sorting the warning and error messages in
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>
=head2 F<todo.pod>
This is a list of wishes for Perl. The most up-to-date version of this file is
-at L<http://perl5.git.perl.org/perl.git/blob_plain/HEAD:/Porting/todo.pod>.
+at L<https://github.com/Perl/perl5/blob/blead/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