git: c5fa554557 - main - Ports chapter - Upgrade references to stale packages

The branch main has been updated by carlavilla:

URL: https://cgit.FreeBSD.org/doc/commit/?id=c5fa554557e5cb07eec0446c7fcef05090065fb6

commit c5fa554557e5cb07eec0446c7fcef05090065fb6
Author:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
AuthorDate: 2023-01-19 20:16:08 +0000
Commit:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2023-01-19 20:16:08 +0000

    Ports chapter - Upgrade references to stale packages
---
 .../content/en/books/handbook/ports/_index.adoc     | 21 ++++++---------------
 1 file changed, 6 insertions(+), 15 deletions(-)

diff --git a/documentation/content/en/books/handbook/ports/_index.adoc b/documentation/content/en/books/handbook/ports/_index.adoc
index f7f351013c..79e5e97cc5 100644
--- a/documentation/content/en/books/handbook/ports/_index.adoc
+++ b/documentation/content/en/books/handbook/ports/_index.adoc
@@ -651,27 +651,20 @@ And to unlock `nginx-lite`:
 
 Software within the FreeBSD Ports Collection can undergo major version number changes.
 To address this, pkg has a built-in command to update package origins.
-This can be useful, for example, if package:lang/php5[] is renamed to package:lang/php53[] so that package:lang/php5[] can now represent version `5.4`.
+This can be useful, for example, if package:lang/python3[] is renamed to package:lang/python311[] so that package:lang/python3[] can now represent version `3.11`.
 
 To change the package origin for the above example, run:
 
 [source,shell]
 ....
-# pkg set -o lang/php5:lang/php53
+# pkg set -o lang/python3:lang/python311
 ....
 
-As another example, to update package:lang/ruby18[] to package:lang/ruby19[], run:
+As another example, to update package:lang/ruby31[] to package:lang/ruby32[], run:
 
 [source,shell]
 ....
-# pkg set -o lang/ruby18:lang/ruby19
-....
-
-As a final example, to change the origin of the `libglut` shared libraries from package:graphics/libglut[] to package:graphics/freeglut[], run:
-
-[source,shell]
-....
-# pkg set -o graphics/libglut:graphics/freeglut
+# pkg set -o lang/ruby31:lang/ruby32
 ....
 
 [NOTE]
@@ -681,12 +674,10 @@ To force a reinstallation of dependent packages, run:
 
 [source,shell]
 ....
-# pkg install -Rf graphics/freeglut
+# pkg install -Rf lang/ruby32
 ....
 ====
 
-
-
 [[ports-using]]
 == Using the Ports Collection
 
@@ -861,7 +852,7 @@ To save this extra step, instead use `make install clean` when compiling the por
 ==== Customizing Ports Installation
 
 Some ports provide build options which can be used to enable or disable application components, provide security options, or allow for other customizations.
-Examples include package:www/firefox[], package:security/gpgme[], and package:mail/sylpheed-claws[].
+Examples include package:www/firefox[] and package:security/gpgme[].
 If the port depends upon other ports which have configurable options,
 it may pause several times for user interaction as the default behavior is to prompt the user to select options from a menu.
 To avoid this and do all of the configuration in one batch, run `make config-recursive` within the port skeleton.