UPDATING: Fix reference to 20161103 entry

As part of the regular trimming of older information from MOVED and
UPDATING; an entry from 20161103 were trimmed which has been referenced
by other entries for upgrading the perl. Merge those information in the
current UPDATING file and also update the reference pointers.

Reported by:	herbert@gojira.at
Approved by:	portmgr (blanket)

1 files changed, 40 insertions, 4 deletions

diff --git a/UPDATING b/UPDATING
index de937c8f811b..af8d5c6223df 100644
--- a/UPDATING
+++ b/UPDATING
@@ -2848,7 +2848,7 @@ reinstall the new ones without using the pkg upgrade facility.
   The default Perl version has been switched to Perl 5.32.  If you are using
   binary packages to upgrade your system, you do not have anything to do, pkg
   upgrade will do the right thing.  For the other people, follow the
-  instructions in entry 20161103, it should still be the same.
+  instructions in entry 20181213, it should still be the same.
 
 20200726:
   AFFECTS: users of net-mgmt/librenms
@@ -3953,7 +3953,7 @@ leave you without networking.
   The default Perl version has been switched to Perl 5.30.  If you are using
   binary packages to upgrade your system, you do not have anything to do, pkg
   upgrade will do the right thing.  For the other people, follow the
-  instructions in entry 20161103, it should still be the same.
+  instructions in entry 20181213, it should still be the same.
 
 20190801:
   AFFECTS: users of www/ot-recorder
@@ -4758,8 +4758,44 @@ leave you without networking.
 
   The default Perl version has been switched to Perl 5.28.  If you are using
   binary packages to upgrade your system, you do not have anything to do, pkg
-  upgrade will do the right thing.  For the other people, follow the
-  instructions in entry 20161103, it should still be the same.
+  upgrade will do the right thing.  For the other people, assuming you are
+  migrating from 5.26 to 5.28, do:
+
+  First, add to /etc/make.conf:
+
+  DEFAULT_VERSIONS+=  perl5=5.28
+
+  Portupgrade users:
+	portupgrade -o lang/perl5.28 -f lang/perl5.26
+
+	  You can now remove the DEFAULT_VERSIONS line added earlier
+	  from /etc/make.conf
+
+	  Then you will need to rebuild everything that uses libperl.so, you
+	  can do so with:
+
+	portupgrade -f `pkg shlib -qR libperl.so.5.26`
+
+	  If, for some reason, this command fails at one point, it is safe to
+	  run it again, it will not rebuild what it already rebuilt, as the
+	  ports that have been rebuilt no longer depend on libperl.so.5.26 but
+	  on libperl.so.5.28.
+
+  Portmaster users:
+	portmaster -o lang/perl5.28 lang/perl5.26
+
+	  You can now remove the DEFAULT_VERSIONS line added earlier
+	  from /etc/make.conf
+
+	  Then you will need to rebuild everything that uses libperl.so, you
+	  can do so with:
+
+	portmaster -f `pkg shlib -qR libperl.so.5.26`
+
+	  If, for some reason, this command fails at one point, it is safe to
+	  run it again, it will not rebuild what it already rebuilt, as the
+	  ports that have been rebuilt no longer depend on libperl.so.5.26 but
+	  on libperl.so.5.28.
 
 20181212:
   AFFECTS: users of net-im/ejabberd