git: 41146fe76cb2 - main - UPDATING: Fix reference to 20161103 entry

From: Muhammad Moinur Rahman <bofh_at_FreeBSD.org>
Date: Tue, 16 May 2023 15:47:05 UTC
The branch main has been updated by bofh:

URL: https://cgit.FreeBSD.org/ports/commit/?id=41146fe76cb2e8b2d8947325a85696744ec21769

commit 41146fe76cb2e8b2d8947325a85696744ec21769
Author:     Muhammad Moinur Rahman <bofh@FreeBSD.org>
AuthorDate: 2023-05-16 13:54:29 +0000
Commit:     Muhammad Moinur Rahman <bofh@FreeBSD.org>
CommitDate: 2023-05-16 15:46:52 +0000

    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)
---
 UPDATING | 44 ++++++++++++++++++++++++++++++++++++++++----
 1 file 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