xref: /openbsd/gnu/usr.bin/perl/Changes (revision b46d8ef2)
1df042708SmillertFor an overview of what's changed in this release, see pod/perldelta.pod.
279cd0b9aSmillert
3df042708SmillertFor the details of changes in previous releases, see the individual
4df042708SmillertperlNNNdelta.pod files. For example, pod/perl588delta.pod describes the
5df042708Smillertchanges between versions 5.8.7 and 5.8.8.
6ba47ec9dSmillert
7df042708SmillertFor a list of contributors to perl, see AUTHORS.
86345ca90Smillert
9df042708SmillertIf you need a detailed commit history (i.e. descriptions of each
10df042708Smillertindividual commit),  you can view the git version control history online
11*b46d8ef2Safresh1at https://github.com/Perl/perl5.  Or, you can download a copy of the git
12*b46d8ef2Safresh1repository and then run a command like
136345ca90Smillert
1448950c12Ssthen    git log --name-status v5.12.0..v5.14.0
156345ca90Smillert
1648950c12Ssthento view all the changes between 5.12.0 and 5.14.0.
17c5dcfd37Smillert
1848950c12SsthenSee pod/perlgit.pod for more details on using git and accessing the
19df042708Smillertcommit history.
207bfa9f44Smillert
21df042708SmillertIn perl releases prior to 2009, the source tarball included a collection
22df042708Smillertof Changes files that listed the individual commits that had gone into
23df042708Smillerteach release. Since these files had become very large, and since the
24df042708Smillertsame information is now freely available online, it was decided to remove
25df042708Smillertthem from subsequent releases.
267bfa9f44Smillert
27df042708SmillertIf you need access to these removed files, then they can be be found most
28df042708Smillertrecently in the 5.8.9 and 5.10.0 tarballs, at
297bfa9f44Smillert
30df042708Smillert    http://www.cpan.org/src/perl-5.8.9.tar.gz
3148950c12Ssthen    http://www.cpan.org/src/5.0/perl-5.10.0.tar.gz
327bfa9f44Smillert
33df042708SmillertThe contents of the files in question can mostly be regenerated using git
34df042708Smillertcommands. The following table shows the equivalents. Note that the files
35df042708Smillertprior to Changes5.005 were not simple lists of commits, so can't be
36df042708Smillertrecreated just by running the git command. As it happens, even the latter
37df042708Smillertones are not exact equivalents. This is due to a combination of errors in
38df042708Smillertthe original Changes files, and "impedance mismatches" when the previous
39df042708Smillertversion control data was imported into git in December 2008.
407bfa9f44Smillert
41df042708SmillertFor example, the Changes5.005 file includes 206 spurious entries from the
42df042708Smillertmaint5.004 Perforce branch.
437bfa9f44Smillert
44df042708SmillertRunning the following command with the range argument shown in the table
45df042708Smillertwill produce *approximately* the same list of changes in the specified
46df042708Smillertfile shown from the listed tarball.
477bfa9f44Smillert
48df042708Smillert    git log --name-status <range>
497bfa9f44Smillert
50df042708Smillert  file           tarball  <range> argument to 'git log'
51df042708Smillert  ------------   ------   --------------------------------
52df042708Smillert  Changes5.000   Either   N/A
53df042708Smillert  Changes5.001   Either   perl-5.000..perl-5.001
54df042708Smillert  Changes5.002   Either   perl-5.001..perl-5.002
55df042708Smillert  Changes5.003   Either   perl-5.002..perl-5.003
56df042708Smillert  Changes5.004   Either   perl-5.003..perl-5.004
57df042708Smillert  Changes5.005   Either   perl-5.004..perl-5.005_03
58df042708Smillert  Changes5.6     Either   perl-5.005_03..perl-5.6.0
59df042708Smillert  Changes5.8     Either   perl-5.6.0..perl-5.8.0
60df042708Smillert  Changes5.8.1   5.8.9    perl-5.8.0..perl-5.8.1 ^1ede746b
61df042708Smillert  Changes5.8.2   5.8.9    perl-5.8.1..perl-5.8.2
62df042708Smillert  Changes5.8.3   5.8.9    perl-5.8.2..perl-5.8.3
63df042708Smillert  Changes5.8.4   5.8.9    perl-5.8.3..perl-5.8.4
64df042708Smillert  Changes5.8.5   5.8.9    perl-5.8.4..perl-5.8.5 ^3a81978b
65df042708Smillert  Changes5.8.6   5.8.9    perl-5.8.5..perl-5.8.6 ^498d59dd
66df042708Smillert  Changes5.8.7   5.8.9    perl-5.8.6..perl-5.8.7
67df042708Smillert  Changes5.8.8   5.8.9    perl-5.8.7..perl-5.8.8
68df042708Smillert  Changes        5.8.9    perl-5.8.8..perl-5.8.9
69df042708Smillert  Changes        5.10.0   perl-5.8.0..perl-5.10.0
70