Add note about default Ruby

Submitted by:	freebsdcodereview@zofrex.com
Differential Revision:	https://reviews.freebsd.org/D14203

1 files changed, 35 insertions, 0 deletions

diff --git a/UPDATING b/UPDATING
index 7e14e9fb1434..91dd8141f9b8 100644
--- a/UPDATING
+++ b/UPDATING
@@ -5,6 +5,41 @@ 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.
 
+20180214:
+  AFFECTS: users of lang/ruby22
+  AUTHOR: swills@FreeBSD.org
+
+  The default ruby version has been updated from 2.3 to 2.4.
+
+  If you compile your own ports you may keep 2.3 as the default version by
+  adding the following lines to your /etc/make.conf file:
+
+  #
+  # Keep ruby 2.3 as default version
+  #
+  DEFAULT_VERSIONS+=ruby=2.3
+
+  If you wish to update to the new default version, you need to first stop any
+  software that uses ruby. Then, you will need to follow these steps, depending
+  upon how you manage your system.
+
+  If you use pkgng, simply upgrade:
+  # pkg upgrade
+
+  If you use portmaster, install new ruby, then rebuild all ports that depend
+  on ruby:
+  # portmaster -o lang/ruby24 lang/ruby23
+  # portmaster -R -r ruby-2.4
+
+  If you use portupgrade, install new ruby, then rebuild all ports that depend
+  on ruby:
+
+  # pkg delete -f ruby portupgrade
+  # make -C /usr/ports/ports-mgmt/portupgrade install clean
+  # pkg set -o lang/ruby23:lang/ruby24
+  # portupgrade -x ruby-2.4.\* -fr lang/ruby24
+
+
 20180209:
   AFFECTS: users of japanese/lookup
   AUTHOR: yasu@utahime.org