| 1 | For an overview of what's changed in this release, see pod/perldelta.pod. |
| 2 | |
| 3 | For the details of changes in previous releases, see the individual |
| 4 | perlNNNdelta.pod files. For example, pod/perl588delta.pod describes the |
| 5 | changes between versions 5.8.7 and 5.8.8. |
| 6 | |
| 7 | For a list of contributors to perl, see AUTHORS. |
| 8 | |
| 9 | If you need a detailed commit history (i.e. descriptions of each |
| 10 | individual commit), you can view the git version control history online |
| 11 | at http://perl5.git.perl.org/perl.git (follow the 'shortlog' link beside |
| 12 | the relevant tag). Or, you can download a copy of the git repository and |
| 13 | then run a command like |
| 14 | |
| 15 | git log --name-status v5.12.0..v5.14.0 |
| 16 | |
| 17 | to view all the changes between 5.12.0 and 5.14.0. |
| 18 | |
| 19 | See pod/perlgit.pod for more details on using git and accessing the |
| 20 | commit history. |
| 21 | |
| 22 | In perl releases prior to 2009, the source tarball included a collection |
| 23 | of Changes files that listed the individual commits that had gone into |
| 24 | each release. Since these files had become very large, and since the |
| 25 | same information is now freely available online, it was decided to remove |
| 26 | them from subsequent releases. |
| 27 | |
| 28 | If you need access to these removed files, then they can be be found most |
| 29 | recently in the 5.8.9 and 5.10.0 tarballs, at |
| 30 | |
| 31 | http://www.cpan.org/src/perl-5.8.9.tar.gz |
| 32 | http://www.cpan.org/src/5.0/perl-5.10.0.tar.gz |
| 33 | |
| 34 | The contents of the files in question can mostly be regenerated using git |
| 35 | commands. The following table shows the equivalents. Note that the files |
| 36 | prior to Changes5.005 were not simple lists of commits, so can't be |
| 37 | recreated just by running the git command. As it happens, even the latter |
| 38 | ones are not exact equivalents. This is due to a combination of errors in |
| 39 | the original Changes files, and "impedance mismatches" when the previous |
| 40 | version control data was imported into git in December 2008. |
| 41 | |
| 42 | For example, the Changes5.005 file includes 206 spurious entries from the |
| 43 | maint5.004 Perforce branch. |
| 44 | |
| 45 | Running the following command with the range argument shown in the table |
| 46 | will produce *approximately* the same list of changes in the specified |
| 47 | file 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 |