1 files changed, 55 insertions, 0 deletions

diff --git a/UPDATING b/UPDATING
index 667da1e7d8e7..9d317b288b58 100644
--- a/UPDATING
+++ b/UPDATING
@@ -6,6 +6,61 @@ You should get into the habit of checking this file for changes each
 time you update your ports collection, before attempting any port
 upgrades.
 
+20060108:
+  AFFECTS: users of x11/kdelibs3, x11/kdebase3, deskutils/superkaramba,
+	            x11-themes/kde-windeco-smoothblend, irc/kvirc
+  AUTHOR: kde@FreeBSD.org
+
+  A number of files have been moved from kdebase to kdelibs between
+  KDE 3.4.3 and KDE 3.5.0 and some applications which used to be
+  distributed separately from KDE have been included in the release.
+
+  This means that you will have to take some precautions in order to
+  update your KDE installation without interruptions.
+
+  We recommend sticking to the following procedure. This procedure requires you
+  to have sysutils/portupgrade installed and to be the superuser (or using sudo).
+
+  1.) Delete installed packages which conflict with the updated KDE
+      ports.
+
+        pkg_deinstall -f kdebase-\[0-9\]\* superkaramba-\[0-9\]\* \
+	kde-windeco-smoothblend-\[0-9]\* kvirc-\[0-9\]\*
+
+  2.) Now update the remaining KDE ports.
+
+        portupgrade -O arts\* kde\* \*kde-i18n\*
+
+      or, if you want to update KDE along with other updated ports:
+
+        portupgrade -a
+
+  3.) Reinstall the KDE ports you deleted in step 1.
+
+        portinstall -O kdebase
+
+  Superkaramba is now included in misc/kdeutils3.
+  
+  The smoothblend window decoration is now included in x11-themes/kdeartwork3.
+
+  KNOWN ISSUES:
+  =============
+
+  Just like KDE 3.4, KDE 3.5 does not play nice with openssl-0.9.8. In
+  particular it breaks kwallet, some of the SSL handling in konqueror and
+  SSL/TLS support in kmail/kontact.
+
+  If you're using the openssl ports rather than the base-system openssl,
+  make sure to use security/openssl-stable.
+
+  You can put WITH_OPENSSL_STABLE=yes into /etc/make.conf to automatically
+  make ports depend on that rather than on security/openssl.
+
+  FreeBSD 4.x users MUST install openssl-stable even if the base openssl is
+  present for SSL/TLS support in kmail/kontact to work. Unfortunatly, the
+  kdepim3 port cannot depend on it automatically due to shortcomings/bugs in
+  ports-collection's openssl infrastructure.
+  
 20060106:
   AFFECTS: users of deskutils/kronolith <= 2.0.6 with MCAL backend
   AUTHOR: thierry@FreeBSD.org