This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perldelta for #27010
[perl5.git] / Changes
diff --git a/Changes b/Changes
index 54043b4..9887fbb 100644 (file)
--- a/Changes
+++ b/Changes
@@ -1,51 +1,70 @@
-Please note: This file provides a complete, temporally ordered log of
-changes that went into every version of Perl.  If you'd like more
-detailed information, please consult the comments in the individual
-patches posted to the perl5-porters mailing list.  Patches for each
-individual change may also be obtained through ftp and rsync--see
-pod/perlhack.pod for the details.
-
-For information on what's new in this release, see pod/perldelta.pod.
-
-[The "CAST AND CREW" list has been moved to AUTHORS.]
-
-NOTE: Each change entry shows the change number; who checked it into the
-repository; when; description of the change; which branch the change
-happened in; and the affected files.  The file lists have a short symbolic
-indicator:
-
-           !       modified
-           +       added
-           -       deleted
-           +>      branched (from elsewhere)
-           !>      merged changes (from elsewhere)
-
-The Message-Ids in the change entries refer to the email messages sent
-to the perl5-porters mailing list.  You can retrieve the messages for
-example from http://www.xray.mpe.mpg.de/mailing-lists/perl5-porters/
-
---------------
-Version v5.9.X         Development release working toward v5.10
---------------
-____________________________________________________________________________
-[ 17641] By: jhi                                   on 2002/07/19  16:31:08
-        Log: Integrate perlio (no changes, but that's fine).
-     Branch: perl
-         !> embed.fnc perl.h
-____________________________________________________________________________
-[ 17640] By: nick                                  on 2002/07/19  07:09:37
-        Log: Integrate mainline@17638, apply couple
-             of whitespace edits so matches perl5.8.0 exactly.
-     Branch: perlio
-          ! embed.fnc perl.h
-         !> AUTHORS Changes Configure INSTALL NetWare/Makefile
-         !> NetWare/t/NWScripts.pl Porting/config.sh Porting/config_H
-         !> lib/File/stat.pm patchlevel.h pod/perldelta.pod
-         !> pod/perlfunc.pod pod/perlhist.pod pod/perlthrtut.pod
-         !> pod/perltoc.pod pod/perlvar.pod util.c
-____________________________________________________________________________
-[ 17639] By: jhi                                   on 2002/07/19  00:47:18
-        Log: It's all yours, Hugo.
-     Branch: perl
-          + Changes5.8
-          ! Changes MANIFEST
+For an overview of what's changed in this release, see pod/perldelta.pod.
+
+For the details of changes in previous releases, see the individual
+perlNNNdelta.pod files. For example, pod/perl588delta.pod describes the
+changes between versions 5.8.7 and 5.8.8.
+
+For a list of contributors to perl, see AUTHORS.
+
+If you need a detailed commit history (i.e. descriptions of each
+individual commit),  you can view the git version control history online
+at http://perl5.git.perl.org/perl.git (follow the 'shortlog' link beside
+the relevant tag). Or, you can download a copy of the git repository and
+then run a command like
+
+    git log --name-status v5.12.0..v5.14.0
+
+to view all the changes between 5.12.0 and 5.14.0.
+
+See pod/perlgit.pod for more details on using git and accessing the
+commit history.
+
+In perl releases prior to 2009, the source tarball included a collection
+of Changes files that listed the individual commits that had gone into
+each release. Since these files had become very large, and since the
+same information is now freely available online, it was decided to remove
+them from subsequent releases.
+
+If you need access to these removed files, then they can be be found most
+recently in the 5.8.9 and 5.10.0 tarballs, at
+
+    http://www.cpan.org/src/perl-5.8.9.tar.gz
+    http://www.cpan.org/src/5.0/perl-5.10.0.tar.gz
+
+The contents of the files in question can mostly be regenerated using git
+commands. The following table shows the equivalents. Note that the files
+prior to Changes5.005 were not simple lists of commits, so can't be
+recreated just by running the git command. As it happens, even the latter
+ones are not exact equivalents. This is due to a combination of errors in
+the original Changes files, and "impedance mismatches" when the previous
+version control data was imported into git in December 2008.
+
+For example, the Changes5.005 file includes 206 spurious entries from the
+maint5.004 Perforce branch.
+
+Running the following command with the range argument shown in the table
+will produce *approximately* the same list of changes in the specified
+file shown from the listed tarball.
+
+    git log --name-status <range>
+
+  file           tarball  <range> argument to 'git log'
+  ------------   ------   --------------------------------
+  Changes5.000   Either   N/A
+  Changes5.001   Either   perl-5.000..perl-5.001
+  Changes5.002   Either   perl-5.001..perl-5.002
+  Changes5.003   Either   perl-5.002..perl-5.003
+  Changes5.004   Either   perl-5.003..perl-5.004
+  Changes5.005   Either   perl-5.004..perl-5.005_03
+  Changes5.6     Either   perl-5.005_03..perl-5.6.0
+  Changes5.8     Either   perl-5.6.0..perl-5.8.0
+  Changes5.8.1   5.8.9    perl-5.8.0..perl-5.8.1 ^1ede746b
+  Changes5.8.2   5.8.9    perl-5.8.1..perl-5.8.2
+  Changes5.8.3   5.8.9    perl-5.8.2..perl-5.8.3
+  Changes5.8.4   5.8.9    perl-5.8.3..perl-5.8.4
+  Changes5.8.5   5.8.9    perl-5.8.4..perl-5.8.5 ^3a81978b
+  Changes5.8.6   5.8.9    perl-5.8.5..perl-5.8.6 ^498d59dd
+  Changes5.8.7   5.8.9    perl-5.8.6..perl-5.8.7
+  Changes5.8.8   5.8.9    perl-5.8.7..perl-5.8.8
+  Changes        5.8.9    perl-5.8.8..perl-5.8.9
+  Changes        5.10.0   perl-5.8.0..perl-5.10.0