Make it so that the default Perl is always called perl5.

- Move Perl's man1 files along with its man3 files.
- Move where Perl installs its modules man1 pages.
- Convert the ports installing man1 pages.
- Make different Perl versions installable at the same time.
  Though you should note that only the default version can be used to
  install Perl modules, and the non default Perl versions cannot use the
  modules installed via ports if they contain .so as they are installed
  in a version specific directory.

Reviewed by:	bapt (the Mk bits)
Exp-run by:	antoine
Sponsored by:	Absolight
Differential Revision:	https://reviews.freebsd.org/D3542

1 files changed, 26 insertions, 0 deletions

diff --git a/UPDATING b/UPDATING
index 040e9c10aeca..febffd25f3d7 100644
--- a/UPDATING
+++ b/UPDATING
@@ -5,6 +5,32 @@ they are unavoidable.
 You should get into the habit of checking this file for changes each time
 you update your ports collection, before attempting any port upgrades.
 
+20150914:
+  AFFECTS: users of lang/perl5*
+  AUTHOR: mat@FreeBSD.org
+
+  Binary package users can ignore this.
+
+  The way lang/perl5* ports install themselves has changed.  From now on, only
+  the default Perl version will install /usr/local/bin/perl.
+
+  If you are NOT using the default version of Perl (as of right now, it is
+  5.20) you MUST add a line setting the version you are using to your
+  /etc/make.conf:
+
+  DEFAULT_VERSIONS+=	perl5=5.xx
+
+  Especially, after this date, to migrate from one Perl version to the other,
+  you must first put the DEFAULT_VERSIONS line in your make.conf, and then, for
+  example, if you want to move from 5.20 to 5.22, do:
+
+	pkg set -o lang/perl5.20:lang/perl5.22
+	portmaster `pkg shlib -qR libperl.so.5.20`
+
+  If you do not do that, you will replace your default Perl 5.20 installation
+  (one that has /usr/local/bin/perl) to an installation that does not have
+  /usr/local/bin/perl, and it will break everything.
+
 20150908:
   AFFECTS: users of print/texlive-base
   AUTHOR: hrs@FreeBSD.org