This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Perl releases are tagged v5.XX.YY since v5.11.0. Updated the example
[perl5.git] / Changes
CommitLineData
9519d2ec
DM
1For an overview of what's changed in this release, see pod/perldelta.pod.
2
3For the details of changes in previous releases, see the individual
4perlNNNdelta.pod files. For example, pod/perl588delta.pod describes the
5changes between versions 5.8.7 and 5.8.8.
6
7For a list of contributors to perl, see AUTHORS.
8
9If you need a detailed commit history (i.e. descriptions of each
10individual commit), you can view the git version control history online
11at http://perl5.git.perl.org/perl.git (follow the 'shortlog' link beside
12the relevant tag). Or, you can download a copy of the git repository and
8c22ec1a 13then run a command like
9519d2ec 14
6a7d5ce2 15 git log --name-status v5.13.3..v5.13.4
9519d2ec 16
8c22ec1a 17to view all the changes between 5.13.3 and 5.13.4.
9519d2ec
DM
18
19See pod/perlrepository.pod for more details on using git and accessing the
20commit history.
21
22In perl releases prior to 2009, the source tarball included a collection
23of Changes files that listed the individual commits that had gone into
24each release. Since these files had become very large, and since the
25same information is now freely available online, it was decided to remove
26them from subsequent releases.
27
28If you need access to these removed files, then they can be be found most
29recently in the 5.8.9 and 5.10.0 tarballs, at
30
8c22ec1a 31 http://www.cpan.org/src/perl-5.8.9.tar.gz
9519d2ec
DM
32 http://www.cpan.org/src/perl-5.10.0.tar.gz
33
34The contents of the files in question can mostly be regenerated using git
35commands. The following table shows the equivalents. Note that the files
36prior to Changes5.005 were not simple lists of commits, so can't be
37recreated just by running the git command. As it happens, even the latter
38ones are not exact equivalents. This is due to a combination of errors in
39the original Changes files, and "impedance mismatches" when the previous
40version control data was imported into git in December 2008.
41
42For example, the Changes5.005 file includes 206 spurious entries from the
43maint5.004 Perforce branch.
44
45Running the following command with the range argument shown in the table
46will produce *approximately* the same list of changes in the specified
47file shown from the listed tarball.
48
49 git log --name-status <range>
50
51 file tarball <range> argument to 'git log'
52 ------------ ------ --------------------------------
53 Changes5.000 Either N/A
54 Changes5.001 Either perl-5.000..perl-5.001
55 Changes5.002 Either perl-5.001..perl-5.002
56 Changes5.003 Either perl-5.002..perl-5.003
57 Changes5.004 Either perl-5.003..perl-5.004
58 Changes5.005 Either perl-5.004..perl-5.005_03
59 Changes5.6 Either perl-5.005_03..perl-5.6.0
60 Changes5.8 Either perl-5.6.0..perl-5.8.0
61 Changes5.8.1 5.8.9 perl-5.8.0..perl-5.8.1 ^1ede746b
62 Changes5.8.2 5.8.9 perl-5.8.1..perl-5.8.2
63 Changes5.8.3 5.8.9 perl-5.8.2..perl-5.8.3
64 Changes5.8.4 5.8.9 perl-5.8.3..perl-5.8.4
65 Changes5.8.5 5.8.9 perl-5.8.4..perl-5.8.5 ^3a81978b
66 Changes5.8.6 5.8.9 perl-5.8.5..perl-5.8.6 ^498d59dd
67 Changes5.8.7 5.8.9 perl-5.8.6..perl-5.8.7
68 Changes5.8.8 5.8.9 perl-5.8.7..perl-5.8.8
69 Changes 5.8.9 perl-5.8.8..perl-5.8.9
70 Changes 5.10.0 perl-5.8.0..perl-5.10.0