path: root/UPDATING

This file documents some of the problems you may encounter when
upgrading your ports.  We try our best to minimize these disruptions,
but sometimes 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.

20041205:
  AFFECTS: users of multimedia/ffmpeg
  AUTHOR: lioux@FreeBSD.org

  multimedia/ffmpeg will not work if previous versions of the port
  are installed. Also, there is a shared library version bump on
  this update. Therefore:

  1) Remove old ffmpeg 

  pkg_delete -f /var/db/pkg/ffmpeg*

  2) Install updated ffmpeg

  3) Rebuild all ports that depend on ffmpeg due to the shared
  library version bump

  cd /var/db/pkg && portupgrade -rf ffmpeg* -x ffmpeg*

20041202:
  AFFECTS: users of any ports which have dependency on lang/python
  AUTHOR: perky@FreeBSD.org

  After upgrading of lang/python, you must rebuild all its consumer
  ports to make them get ready to Python 2.4.

  To do this, you will need to:
    pkgdb -uf && cd /usr/ports/lang/python && make upgrade-site-packages

20041128:
  AFFECTS: users of mail/dspam and mail/dspam-devel
  AUTHOR: itetcu@people.tecnik93.com

  When upgradng from previous version, read mail/dspam/files/UPDATING
  and adjust your options.

20041121:
  AFFECTS: users of news/rawdog
  AUTHOR: tim@bishnet.net

  Rawdog 2.x changes the format of the state file used in 1.x. To
  upgrade from 1.x to 2.x the rawdog author recommends the following:

    cp -R ~/.rawdog ~/.rawdog-old
    rm ~/.rawdog/state
    rawdog -u
    rawdog --upgrade ~/.rawdog-old ~/.rawdog
    rawdog -w

  Once you're happy with the new version:
    rm -r ~/.rawdog-old

20041118:
  AFFECTS: users of sysutils/portupgrade
  AUTHOR: lofi@freebsd.org

  portsdb(1) is part of the portupgrade suite and is used to convert a ports
  INDEX file to a binary INDEX.db database. By default, it uses the
  libc-builtin berkeley db to do so, which has a buggy btree implementation.

  If you see errors like "[BUG] Segmentation fault" while a portsdb update is
  in progress, adjust the PORTS_DBDRIVER variable (in your environment or in
  pkgtools.conf) to either bdb1_hash or dbm_hash.

  This problem was fixed in 5.3-RELEASE, but users of 4.10-RELEASE and
  5.2.1-RELEASE (and older releases) will find fixes by updating to the
  latest (at least after Sep 20) of RELENG_4 or RELENG_5.

20041116:
  AFFECTS: users of www/bricolage
  AUTHOR: ports@rbt.ca

  Bricolage may now be run on mod_perl compiled as a DSO for Apache
  when following these guidelines:

  http://perl.apache.org/docs/1.0/guide/install.html#When_DSO_can_be_Used

  To do this, you will need to:
    pkg_delete -f apache-mod_perl
    pkg_delete -f p5-libapreq-static
    portupgrade -rR bricolage

  Bricolage will rebuild mod_perl, apache and libapreq using their standard
  versions.

20041115:
  AFFECTS: users of sysutils/portupgrade
  AUTHOR: lofi@FreeBSD.org

  Due to the recent removal of INDEX and INDEX-5 from FreeBSD's CVS,
  portupgrade with default configuration will run 'make index' if started
  after cvsup'ing the ports-collection. This may take an undesirably long
  time.

  There are several ways to work around this, for example:

  - Run 'make fetchindex' after cvsup'ing ports.

  or

  - Adjust the PORTS_INDEX variable in your environment or in
    pkgtools.conf (see portupgrade(1) or the default pkgtools.conf) to
    a different value than the default.

  Also remember that 'make index' is only supported on _complete_
  ports-trees. If you are currently refusing whole categories by means
  of a cvsup refuse file, use 'make fetchindex' instead (or consider
  keeping an extra machine/jail with a complete ports-tree around to
  do INDEX builds on).

20041111:
  AFFECTS: users of audio/faad, multimedia/mpeg4ip
  AUTHOR: lioux@FreeBSD.org

  mpeg4ip has been updated and broken down into 2 separate ports:
  mpeg4ip and mpeg4ip-libmp4v2. Furthermore, mpeg4ip now depends
  on faad. Moreover, faad now depends on mpeg4ip-libmp4v2 rather
  than on mpeg4ip which avoids a cyclic dependency (mpeg4ip depends
  on faad which depends on mpeg4ip).

  If any of the old ports are installed, mpeg4ip will not compile.
  Therefore,

  1) Remove old faad and mpeg4ip ports which conflict with new
  mpeg4ip

  pkg_delete -f /var/db/pkg/mpeg4ip*
  pkg_delete -f /var/db/pkg/faad*

  2) Install faad, mpeg4ip and mpeg4ip-libmp4v2 in the following
  order

  cd /usr/ports/multimedia/mpeg4ip-libmp4v2 && make install clean
  cd /usr/ports/audio/faad && make install clean
  cd /usr/ports/multimedia/mpeg4ip && make install clean

20041111:
  AFFECTS: users of java
  AUTHOR: glewis@FreeBSD.org

  javavmwrapper has been rewritten.  It now creates symbolic links for
  all executables of the Java VMs that have been registered with it.
  These symbolic links may impact which version of Java you are using,
  depending on your PATH, which may need to be adjusted.

  For example, if your path is:

	${LOCALBASE}/bin:${LOCALBASE}/jdk1.4.2/bin

  then previously "java" would resolve to ${LOCALBASE}/jdk1.4.2/bin/java.
  With the new javavmwrapper it will resolve to ${LOCALBASE}/bin/java.
  Depending upon the Java VMs that are registered and various environment
  variables, it may or may not be ${LOCALBASE}/jdk1.4.2/bin/java that is
  run by javavmwrapper via the symbolic link ${LOCALBASE}/bin/java.

20041107:
  AFFECTS: users of x11/kdebase3
  AUTHOR: kde@freebsd.org

  To use GMail in konqueror, you need to set the browser identification for
  gmail.google.com to 'Safari 1.2.3 on Mac OS X', otherwise you will not be
  able to click on any links in GMail after logging in.

  You can set site-specific browser identifications via the Settings menu in
  Konqueror (Configure Konqueror/Browser Identification) or in the KDE Control
  Center, Internet & Network/Web Browser/Browser Identification.

20041107:
  AFFECTS: all users who have any GNOME libraries installed
  AUTHOR: adamw@FreeBSD.org and the rest of the FreeBSD/GNOME crew

  Hey, 2.6! You don't have to be 2.6 anymore!
  Do NOT use portupgrade(1) to update your GNOME 2.6 desktop to 2.8:
  it won't work, and you'll have to recompile bunches of ports by hand
  as a result. Use the gnome_upgrade.sh script to automate the upgrade
  process. The script is available from
    http://www.FreeBSD.org/gnome/gnome_upgrade.sh

20041104:
  AFFECTS: users of security/clamav-devel
  AUTHOR: rob@debank.tv

  The configuration file was renamed from clamav.conf to clamd.conf,
  make sure to move your configuration before restarting the server.

20041104:
  AFFECTS: users of japanese/rskkserv
  AUTHOR: rushani@FreeBSD.org

  The format of PREFIX/etc/rskkserv.conf has changed in version 2.95.
  Please update your configuration file before restarting the server
  using PREFIX/share/examples/rskkserv/conf-o2n.rb and referring to
  PREFIX/etc/rskkserv.conf.sample.

20041031:
  AFFECTS: users of databases/mysql40-server
  AUTHOR: ale@FreeBSD.org

  The MySQL Daemon must now be enabled / disabled in rc.conf.
  See the script for details.

20041028:
  AFFECTS: users of net/netatalk
  AUTHOR: marcus@FreeBSD.org

  Please note that the handling of the default type/creator has changed with
  2.0.1. As a side effect, users upgrading from earlier versions, including
  2.0.0, will have to remove the default type/creator from the
  AppleVolumes.System file. The install process will not modify this file
  automatically. Please remove the line starting with '.         "????"'
  manually.

  This text was taken from the Netatalk 2.0.1 release notes at
  https://sourceforge.net/project/shownotes.php?release_id=278320.

20041027:
  AFFECTS: users of games/pcgen
  AUTHOR: hq@FreeBSD.org

  The launcher script for PCGen has been renamed to 'pcgen' (formerly
  'pcgen.sh').

20041024:
  AFFECTS: users of databases/mysql50-server
  AUTHOR: ale@FreeBSD.org

  The MySQL Daemon must now be enabled / disabled in rc.conf.
  See the script for details.

20041024:
  AFFECTS: users of mail/popfile
  AUTHOR: matusita@FreeBSD.org

  Since there is a known problem that popfile doesn't work with DBD::SQLite 1.x
  at this time, you'll be in trouble after upgrading databases/p5-DBD-SQLite
  to the latest one.  A workaround is commited to 0.22.0_1 which uses
  databases/p5-DBD-SQLite2 by default.  However, if already installed popfile,
  please check ${HOME}/.popfile/popfile.cfg, and change the line
  "bayes_dbconnect dbi:SQLite:dbname=$dbname" to
  "bayes_dbconnect dbi:SQLite2:dbname=$dbname" then restart popfile.

20041023:
  AFFECTS: users of mail/dbmail
  AUTHOR: seanc@FreeBSD.org

  When upgrading from 1.X to 2.X, read the upgrading instructions.
  The structure of the database has changed, please use the migration
  scripts provided.  Many of the programs have been renamed and arguments
  have been changed as well.

20041020:
  AFFECTS: users of security/antivir-milter
  AUTHOR: marius@FreeBSD.org

  When updating from previous versions of security/antivir-milter to
  antivir-milter-1.1 and you had changed PREFIX/etc/avmilter.conf you
  have to bring over your changes to PREFIX/etc/avmilter/avmilter.conf
  after installing the new version of this port. Note, however, that
  some variables have been renamed.
  If you used AntiVir Milter ignore, scan and/or warn files in /etc
  you can now move them to PREFIX/etc/avmilter.

20041019:
  AFFECTS: users of databases/mysql41-server
  AUTHOR: ale@FreeBSD.org

  The MySQL Daemon must now be enabled / disabled in rc.conf.
  See the script for details.

20041018:
  AFFECTS: users of mail/courier-imap
  AUTHOR: oliver@FreeBSD.org

  The courier-imap port must now be enabled / disabled in rc.conf.
  See the script for details.

20041015
  AFFECTS: users of www/apache2 with devel/apr
  AUTHOR: clement@FreeBSD.org

  WITH_APR_FROM_PORTS knob is no longer supported, since apr > 1.0
  doesn't conflict with apache2's one. If you use apr 0.9.x you
  won't be able to upgrade apache2 anymore.

20041014:
  AFFECTS: users of security/clamav
  AUTHOR: eik@FreeBSD.org

  The configruration file for the clamd daemon has changed from
  /usr/local/etc/clamav.conf to /usr/local/etc/clamd.conf.

20041013:
  AFFECTS: users of mail/getmail
  AUTHOR: question+fbsdports@closedsrc.org

  If you are using a version of mail/getmail earlier than 4.x and
  are planning to upgrade to 4.2.2, please note that the configuration file
  syntax has changed and the existing configuration file(s) will not work.
  Please refer to the online documentation available at:

    (http://www.qcc.ca/~charlesc/software/getmail-4/documentation.html)

  If you already upgraded to the latest version of getmail, you can refer
  to the installed documentation under:

    ${PREFIX}/share/docs/getmail

  The 4.x branch of getmail also requires Python 2.3.3 or newer.

  Some mail delivery agents require that the unixfrom parameter to be set to
  either "true" or "false" in the configuration file.

  A "quick and dirty" guide on setting up, configuring and using getmail is
  available at:

    (http://qnd-guides.net/qnd-getmail.html)

20041012:
  AFFECTS: users of devel/perforce
  AUTHOR: marshall@chezmarshall.com

  Upgrading from 2003.2 to 2004.2 is straightforward, it is highly
  recommended to checkpoint and backup your server as follows:
    p4 verify //...
    p4 verify -u //... # possibly redundant
    p4 admin checkpoint
    p4 admin stop
    <backup repository>

  If you are upgrading from a version earlier than 2003.2, you should
  consult the Perforce documentation
    (http://www.perforce.com/perforce/technical.html)
  before proceeding.

  Also, it looks as though Perforce has stopped updating the man pages,
  so they are no longer included in the port.

20041012:
  AFFECTS: users of www/firefox
  AUTHOR: freebsd-gnome@FreeBSD.org

  After upgrading to firefox-1.0.1.p, certain things such as extension/theme
  [de]installation, and "Find On Page" may no longer work.  You may also
  notice an infinite loop when starting Firefox.  If this happens, backup
  ~/.mozilla/firefox/*/bookmarks.html, and remove ~/.mozilla/firefox.
  Afterward, Firefox should start up.  You can then restore the bookmarks.html
  file to the new ~/.mozilla/firefox/*.default directory.

20041012:
  AFFECTS: users of net/netatalk
  AUTHOR: marcus@FreeBSD.org

  Netatalk has been upgraded to 2.0.0.  There are some important
  instructions for upgrading from 1.6.x.  Please see
  http://netatalk.sourceforge.net/2.0/htmldocs/upgrade.html on how
  to make the transition.

20041011:
  AFFECTS: users of www/linuxpluginwrapper who are running FreeBSD
	   5.3-BETA7 or later (including -current)
  AUTHOR: nork@freebsd.org

  According to UPDATING(20041001), /etc/libmap.conf should be fixed
  libm.so.2 to libm.so.3.

20041001:
  AFFECTS: users of ports that require several base system libraries who
	   are running FreeBSD 5.3-BETA7 or later (including -current)
  AUTHOR: kensmith@freebsd.org

  As part of the FreeBSD-5.3 release the following system libraries
  had their version number incremented:

	/lib/libm.so.2 -> libm.so.3
	/lib/libreadline.so.4 -> libreadline.so.5
	/usr/lib/libhistory.so.4 -> libhistory.so.5
	/usr/lib/libopie.so.2 -> libopie.so.3
	/usr/lib/libpcap.so.2 -> libpcap.so.3

  This should have no effect unless you are using FreeBSD 5.3-BETA7 or
  higher, or if you are a -current user who upgraded after this date.
  Assuming you did a from-source upgrade new versions of these libraries
  will be created but the old versions will be left behind (for example
  /lib/libm.so.2 will be the old one, /lib/libm.so.3 will be the new one).
  Any ports or pre-built packages you have currently installed will
  continue to use the old library, any ports you install after the upgrade
  will begin to use the new library.  You will need to have all your
  ports recompiled before the old library goes away.  To help with the
  migration you could also use /etc/libmap.conf to map libm.so.2 to
  libm.so.3.

20040903:
  AFFECTS: users of net/kdenetwork3
  AUTHOR: kde@freebsd.org

  The lanbrowsing facility of KDE has been removed from the main
  kdenetwork3 port and is now available via the net/lanbrowsing
  port.

20040901:
  AFFECTS: users of www/squid
  AUTHOR: tmseck@netcologne.de

  www/squid now installs an rcNG script by default. This means you
  need to explicitly enable squid by setting squid_enable=yes in
  /etc/rc.conf.
  The squid.sh script uses the following variables:
  squid_chdir
  squid_flags
  squid_user

  Please see the squid.sh script for further details.
  If you want to install an old style rc-script, build the port with
  "WITHOUT_SQUID_RCNG=YES" or by rerunning "make config" and disabling this
  option.

20040830:
  AFFECTS: users of x11/kde3, x11/kdelibs3, x11/kdebase3
  AUTHOR: kde@freebsd.org

  In KDE 3.3, a number of files were moved between ports and some ports
  were removed. This means that you will have to take some precautions
  to update your KDE installation. A simple portupgrade -a will not work.
  portupgrade -R kde can fail as well, depending on what parts of KDE you
  have currently installed. We therefore recommend sticking to the following
  procedure. The procedure requires you to have sysutils/portupgrade installed
  and you to be the superuser (or using sudo). We recommend not being logged in
  to a KDE session on the machine you're performing the upgrade on. If you
  choose to perform the update while being logged in to KDE, expect erratic
  behaviour and crashes from applications launched during the update.

  1.) First, make sure your ports index is up to date.

      	cd /usr/ports && make index

      or, if you're using the sysutils/portindex port

      	portindex

  2.) Delete installed packages which conflict with the updated KDE
      ports.

      	pkg_deinstall -f kdeaddons-kontact-plugins-\* \
      	kdeaddons-kaddressbook-plugins-\* kdepim-\* kdeutils-\* \
      	kdeaddons-\[0-9\]\* kde-\[0-9\]\*

      kdegraphics now conflicts with the kolourpaint package and kdeedu now
      conflicts with the kwordquiz package. If you have kwordquiz and/or
      kolourpaint installed on your system and you want to use the kdegraphics/
      kdeedu ports, you should first deinstall the conflicting packages:

      	pkg_deinstall -f kolourpaint\* kwordquiz\*


  3.) Now update the remaining KDE ports.

      	portupgrade arts\* kde\* quanta\*

      or, if you want to update KDE along with other updated ports:

      	portupgrade -a

      Note that the quanta port has been renamed to kdewebdev. The commands
      above will automatically replace quanta with kdewebdev, if you have
      quanta installed.

  4.) Reinstall any KDE ports you deleted in step 2. Note that the kdeaddons-
      kontact-plugins (net/kontact-plugins), kdepim-kpilot (palm/kpilot) and
      quanta (www/quanta) ports/packages do not exist anymore and cannot be
      reinstalled.

  Known post-updating issues:

  - If you're missing acoustic notifications (system sounds) after the update:

    	rm ~/.kde/share/config/knotifyrc

    Then log out of KDE and back in again.

  - KMail has been heavily modified since KDE 3.2.x. Testing shows that KMail
    can display erratic behaviour and crashes after the update. If you see any
    such behaviour, it is recommended to simply close KMail and start it again
    until it resumes normal operation.

    The integration of GnuPG and KMail for signing, encrypting and verifying
    PGP/MIME mail has also changed. A quick howto is available at
    http://freebsd.kde.org/howtos/gnupg-kmail.php.

  - kdm users might get warnings from kdm about obsolete lines in kdmrc.
    You can migrate your configuration while preserving your customizations
    by running

    	genkdmconf

    Make sure to backup your old kdmrc (usually found in
    /usr/local/share/config/kdm) beforehand in case the merge produces an
    invalid configuration.

  - Extensive information about changes from KDE 3.2.x can be found at
    http://www.kde.org/announcements/changelogs/changelog3_2_3to3_3.php

20040829:
  AFFECTS: users of mail/mutt-devel
  AUTHOR: udo.schweigert@siemens.com

  The defaults of the port have been changed from WITH_MUTT_NCURSES to
  WITH_MUTT_SLANG to be in sync with the mail/mutt port. If you really have
  problems with slang (which should be a very rare case) be sure to have set
  COLORTERM=yes and COLORFGBG="color1;color2" in your environment, or recompile
  the port with the WITH_MUTT_NCURSES knob set (e.g. by adding
  WITH_MUTT_NCURSES=yes to your /etc/make.conf).

20040828:
  AFFECTS: users of security/samba-vscan
  AUTHOR: jmelo@freebsdbrasil.com.br

  The default location of the configuration files has been changed
  from /etc/ to /usr/local/etc and from /etc/samba/ to
  /usr/local/etc/samba-vscan/; the default location of the data files
  has been changed from /var/run/clamd to /var/run/clamav/clamd and
  from /var/opt/f-secure/fsav/databases to /var/db/fsav/databases.

20040820:
  AFFECTS: users of japanese/ptex-tetex, japanese/xdvik, and japanese/dvipsk
  AUTHOR: hrs@FreeBSD.org

  japanese/ptex-tetex, japanese/xdvik, and japanese/dvipsk now
  look for the texmf.cnf file in $TEXMF/web2c-ptex/texmf.cnf first,
  while some utilities included in the original teTeX distribution
  such as kpsepath(1) look for the file in $TEXMF/web2c/texmf.cnf
  first.  This is for separating the pTeX's texmf.cnf and
  the original TeX's texmf.cnf, and you do not have to copy or
  link the file $TEXMF/web2c-ptex/texmf.cnf to $TEXMF/web2c/.
  To lookup pTeX path by using kpsepath(1) and so on, please
  set TEXMFCNF environment variable as described in
  $TEXMF/web2c-ptex/texmf.cnf.  For more detail, see
  $TEXMF/web2c-ptex/texmf.cnf and $TEXMF/web2c/texmf.cnf.

20040820:
  AFFECTS: users of japanese/platex209-*
  AUTHOR: hrs@FreeBSD.org

  japanese/platex209-* are renamed to japanese/platex209 and
  now depend on japanese/ptex-tetex.  While EUC-JP and JIS
  encoding can be used by default, but Shift JIS is no longer
  supported because it makes very difficult to maintain other
  pTeX related ports.  However, "ptex --kanji=sjis" still works,
  so it can be used if all of macro files under share/texmf are
  converted to Shift JIS encoding manually.

20040820:
  AFFECTS: users of japanese/dvipsk-vflib
  AUTHOR: hrs@FreeBSD.org

  japanese/dvipsk-vflib has been removed because it is not maintained
  for a long time.  While japanese/dvipsk itself has no support to
  rendering vector fonts, this and Ghostscript give almost the same
  functionality.

20040820:
  AFFECTS: users of japanese/xdvik-vflib
  AUTHOR: hrs@FreeBSD.org

  japanese/xdvik-vflib has been renamed to japanese/xdvik because
  it has nothing to do with VFLib now.  It depends on and uses
  FreeType2 to render vector fonts.

20040817:
  AFFECTS: users of www/apache2
  AUTHOR: clement@FreeBSD.org

  Summary of recent changes:
  - Access to filesystem is denied by default.
  - mod_proxy* are no longer built by default
  - Now ${PREFIX}/etc/apache2/Includes/*.conf can be used to store
    local configuration or sample configurations.
  - Makefile.modules.3rd contains modules selection for apache 2.x and 1.3.x

20040815:
  AFFECTS: users of net/openldap22{,-sasl}-server
  AUTHOR: eik@FreeBSD.org

  The start/stop script has moved to ${PREFIX}/etc/rc.d. Users on 5.x
  who want to start the daemon early can set WITH_RCORDER=yes.

  Setting WITH_ODBC_TYPE is not sufficient to enable SQL backend
  support, WITH_ODBC=yes is required.

20040813:
  AFFECTS: users of x11/kdebase3 (kdm)
  AUTHOR: kde@freebsd.org

  If you are unable to login to X via kdm after portupgrading to the latest
  kdebase port and you're getting these or similar messages on the console

  /kernel: Aug 13 17:12:10 kiste kdm: :0[447]: Can't execute
  "/usr/local/share/config/kdm/Xstartup": No such file or directory
  /kernel: Aug 13 17:12:10 kiste kdm: :0[432]: Cannot execute startup script
  "/usr/local/share/config/kdm/Xstartup"
  /kernel: Aug 13 17:12:10 kiste kdm: :0[448]: Can't execute
  "/usr/local/share/config/kdm/Xreset": No such file or directory
  /kernel: Aug 13 17:12:12 kiste kdm: :0[458]: Can't execute
  "/usr/local/share/config/kdm/Xsetup": No such file or directory

  please do the following:

  1.) Copy /usr/local/share/config/kdm/kdmrc away to a safe place, for example
  your home directory ( cp /usr/local/share/config/kdm/kdmrc ~/ )

  2.) Run, as root: genkdmconf --no-old

  3.) Put your copy of kdmrc back to /usr/local/share/config/kdm/kdmrc (cp
  ~/kdmrc /usr/local/share/config/kdm/ )

  Optional step 4.) Run, as root: genkdmconf (without any options) to update
  your kdmrc to the lastest configfile format

  Note for advanced users: Substitute /usr/local with your custom PREFIX if
  you're using one.

20040730:
  AFFECTS: users of lang/perl5.8
  AUTHOR: tobez@FreeBSD.org, mat@FreeBSD.org, marcus@FreeBSD.org

  lang/perl5.8 has been updated to 5.8.5. you should update everything
  depending on perl, that is:
    * first, upgrade your perl5.8 installation.
    * run "use.perl port", so that the system knows you have 5.8.5.
    * now, run some magic incantations to upgrade all ports depending on perl,
      that is run something like :
      portupgrade -f `(pkg_info -R perl-5.8.5 |tail +4; \
        find /usr/local/lib/perl5/site_perl/5.8.[124] -type f -print0 \
        | xargs -0 pkg_which -fv | sed -e '/: ?/d' -e 's/.*: //')|sort -u`
      This is likely to fail for a few ports, you'll have to upgrade them
      afterwards.
      Please note, that this last step is, strictly speaking, not necessary,
      if you are upgrading from 5.8.4.  But it is cleaner to do so anyway.

20040726:
  AFFECTS: users of devel/apache-ant
  AUTHOR: glewis@FreeBSD.org

  The update to Ant 1.6.2 introduces the following changes which may break
  older environments, according to the 1.6.2 release notes:

  . The import task used the canonical version of a file path. This
    has been changed to use the absolute path. Bugzilla 28505.
  . ant-xalan2.jar has been removed since the only class contained
    in it didn't depend on Xalan-J 2 at all. Its sole dependency has
    always been TraX and so it has been merged into ant-trax.jar.
  . All exceptions thrown by tasks are now wrapped in a buildexception
    giving the location in the buildfile of the task.
  . Nested elements for namespaced tasks and types may belong to
    the Ant default namespace as well as the task's or type's namespace.
  . <junitreport> will very likely no longer work with Xalan-J 1.

20040724:
  AFFECTS: users for xorg and GNOME
  AUTHOR: gnome@FreeBSD.org

  After migrating from XFree86 to X.Org, you must rebuild
  x11-toolkits/libwnck and x11/libxklavier for full GNOME functionality
  to be restored.

  If you receive an XKB initialization error when starting GNOME, edit
  your XF86Config or xorg.conf, and remove the line:

Option "XkbRules" "xfree86"

20040723:
  AFFECTS: users of FreeBSD-current, users of xorg
  AUTHOR: anholt@FreeBSD.org

  The XFREE86_VERSION variable is deprecated and has been replaced by the
  X_WINDOW_SYSTEM variable. X_WINDOW_SYSTEM may be set to xorg, xfree86-4, or
  xfree86-3.  X_WINDOW_SYSTEM defaults to xorg on FreeBSD-current.  If you are
  switching to xorg, you should follow this set of commands to cleanly upgrade:

  pkg_delete -f /var/db/pkg/imake-4* /var/db/pkg/XFree86-*
  cd /usr/ports/x11/xorg && make install
  pkgdb -F

  Users of -stable or older -current can switch to X.Org by setting
  X_WINDOW_SYSTEM=xorg in make.conf and following the same process.

  Alternately, FreeBSD 5.x and later users can use portupgrade with packages:
    cd /var/db/pkg
    portupgrade -o devel/imake-6  imake-4*
    portupgrade -o x11/xorg-libraries  XFree86-libraries
    portupgrade -o x11/xorg-clients  XFree86-clients
    portupgrade -o x11/xorg-manpages  XFree86-manuals
    portupgrade -o x11/xorg-documents  XFree86-documents
    portupgrade -o x11-fonts/xorg-fonts-truetype  XFree86-fontScalable
    portupgrade -o x11-fonts/xorg-fonts-100dpi  XFree86-font100dpi
    portupgrade -o x11-fonts/xorg-fonts-75dpi  XFree86-font75dpi
    portupgrade -o x11-fonts/xorg-fonts-type1  XFree86-fontDefaultBitmaps
    portupgrade -o x11-fonts/xorg-fonts-cyrillic  XFree86-fontCyrillic
    portupgrade -o x11-fonts/xorg-fonts-encodings  XFree86-fontEncodings
    portupgrade -o x11-servers/xorg-server  XFree86-Server
    portupgrade -o x11/xorg -f XFree86

20040719:
  AFFECTS: users of PHP
  AUTHOR: ale@FreeBSD.org

  The old lang/php4 and lang/php5 ports have been splitted into 'base' PHP,
  PEAR, and shared extensions to allow more flexibility and add new features.
  Upgrading your current PHP installation will result in a 'base' PHP
  installation (no PEAR and no extensions).
  PEAR can be found in the new devel/php4-pear and devel/php5-pear ports, while
  the set of PHP extensions to install can be choosen via the meta-ports
  lang/php4-extensions and lang/php5-extensions, or installing singular
  extensions individually.
  If you have a previous php.ini configuration file, be sure to comment out
  the extension_dir parameter, since the correct path is statically compiled
  into the PHP binary.
  For an overview of the modules used with the old PHP binary, use
  the command "php -m".

20040717:
  AFFECTS: users of net/openldap21{,-sasl}-client
  AUTHOR: eik@FreeBSD.org

  OpenLDAP version 2.2 is now the default. To upgrade all ports do
    portupgrade -rfo net/openldap22-client openldap-client
  (or a similar command for the SASL variant). If you do not want to
  upgrade, add the line `WANT_OPENLDAP_VER?=21' to /etc/make.conf

  Note that when you want to upgrade openldap21{,sasl}-server, you have
  to use slapcat/slapadd to migrate the database, since the internal
  format is not binary compatible. Simply upgrading the server without
  doing a slapcat first can corrupt your database.

20040717:
  AFFECTS: users of mail/exim on FreeBSD 5.x
  AUTHOR: eik@FreeBSD.org

  The default location of the startup script has been changed to
  ${PREFIX}/etc/rc.d. When you depend on the previous behaviour,
  build the port with WITH_RCORDER=yes.

  Setting WITH_OPENLDAP_VER and WITH_MYSQL_VER do not automatically
  imply the corresponding WITH_ varibale. The use of these options
  is discouraged, use the global settings (WANT_OPENLDAP_VER and
  DEFAULT_MYSQL_VER) to set system wide defaults.

20040709:
  AFFECTS: users of mail/sender-milter
  AUTHOR: vs@FreeBSD.org

  Milter-sender version 0.58 released.
  When updating to version 0.58, beware if you have a personalised
  configuration file (milter-sender.cf).  The meaning of the
  MxAcceptsAllAction variable has changed and its default has changed
  from 4 to 6.  If this variable is not updated, greylisting might be
  more aggressive than expected.

20040708:
  AFFECTS: users of www/opera
  AUTHOR: osa@FreeBSD.org

  Opera 7.52 released.
  The file search.ini has been changed to ensure correct default
  addresses for dictionary and encyclopedia searches.  Existing
  versions will be overwritten on upgrade.  Users who have a
  customized search.ini file that they would like to keep, should
  edit its version number to 4 before upgrading.  Note that you
  have to edit the search.ini file located in the /.opera folder.

  [Version]
  File Version=4

  Other changes you are may find in changelog, its
  available at http://www.opera.com/freebsd/changelogs/752/

20040706:
  AFFECTS: users of Python bindings for textproc/lib{xml2,xslt} libraries
  AUTHOR: gnome@FreeBSD.org

  Python bindings for libxml2 and libxslt libraries were moved out into
  separate slave ports. Please install textproc/py-libxml2 and
  textproc/py-libxslt to get bindings back to your system.

20040703:
  AFFECTS: users of net/netatalk-devel
  AUTHOR: marcus@FreeBSD.org

  Netatalk-devel has been converted to use RCng.  That means all of the
  netatalk daemons must be enabled in /etc/rc.conf before they will start
  (previously, all netatalk daemons would start by default).  The following
  variables are used by the new netatalk.sh script:

  atalkd_enable
  cnid_metad_enable
  papd_enable
  afpd_enable
  timelord_enable

  See the netatalk.sh script for more details.

20040701:
  AFFECTS: users of security/portaudit
  AUTHOR: eik@FreeBSD.org

  The preference file format, as well as the periodic(8)
  names have changed. If you use the default settings,
  no modifications are necessary.

  new settings in /usr/local/etc/portaudit.conf:
    portaudit_fetch_env="HTTP_PROXY="
    portaudit_fetch_cmd="fetch -1amp"
    portaudit_sites="http://www.FreeBSD.org/ports/"

  new settings in periodic.conf(5):
    daily_status_security_portaudit_enable="YES"
    daily_status_security_portaudit_expiry="2"
    daily_status_security_portaudit_user="nobody"

20040629:
  AFFECTS: users of net/daapd
  AUTHOR: lth@FreeBSD.org

  Daapd must now be enabled in rc.conf. Add this to your /etc/rc.conf:
  daapd_enable="YES"

20040626:
  AFFECTS: users of php4 and php5 with the PDFlib extension
  AUTHOR: ale@FreeBSD.org

  The PDFlib extension has been removed from the archive and moved to PECL.
  Consequently to enable it you have to install print/pecl-pdflib.
  Alternatively you may want to try the experimental print/pecl-panda.

20040625:
  AFFECTS: users of ftp/pure-ftpd
  AUTHOR: pav@FreeBSD.org

  Pure-ftpd must be enabled in rc.conf now. Add this to your /etc/rc.conf:
  pureftpd_enable="YES"

20040622:
  AFFECTS: users of net/openslp
  AUTHOR: kuriyama@FreeBSD.org

  The openslp port must now be enabled / disabled and configured in
  rc.conf.  See the script for details.

20040619:
  AFFECTS: users of sysutils/webmin and sysutils/usermin
  AUTHOR: olgeni@FreeBSD.org

  The webmin and usermin ports must now be enabled in rc.conf.
  See the pkg-message or script for details.

20040618:
  AFFECTS: users of japanese/ptex-tetex
  AUTHOR: hrs@FreeBSD.org

  The texmf.cnf file for pTeX is now installed in texmf/web2c-ptex.

20040618:
  AFFECTS: users of japanese/ptex-pkfonts*
  AUTHOR: hrs@FreeBSD.org

  The japanese/ptex-pkfonts* has been removed because pkfonts are
  already included in the teTeX distribution.

20040618:
  AFFECTS: users of japanese/xdvik-vflib*
  AUTHOR: hrs@FreeBSD.org

  The japanese/xdvik-vflib no longer supports VFlib2, and now depends on
  print/freetype2.  For the configuration details, see vfontmap file which
  installed as texmf/xdvi/vfontmap.  japanese/kochi-ttfonts is used for
  min and goth by default.

  xdvik-vflib-pk* variants has been removed because pkfonts are already included
  in the teTeX distribution.

20040618:
  AFFECTS: users of print/teTeX
  AUTHOR: hrs@FreeBSD.org

  The print/teTeX has been split into print/teTeX-base and print/teTeX-texmf,
  and print/teTeX is now a meta-port for the two and print/dvipsk-tetex and
  print/xdvik.  print/teTeX installs dvips and xdvi by default again (via
  print/dvipsk-tetex and print/xdvik).   For people who want to use teTeX,
  simply install print/teTeX with options set by default.

  print/teTeX-base has additional options for adding xdvi and dvips included
  in the teTeX distribution itself, but use of them are not recommended if
  you do not understand what you are trying to do.  Especially, when the
  options are set by yourself, do not install ports that match *xdvi* and
  *dvips* because they break the installed print/teTeX-base's dviware
  and such conflicts will not be detected.  In most cases, a combination
  of print/teTeX-base + print/dvipsk-tetex + print/xdvik (which are
  installed by print/teTeX by default) will be sufficient.

20040615:
  AFFECTS: users of www/firefox
  AUTHOR: gnome@FreeBSD.org

  The firefox-0.9 update has a special requirement before you can run it.
  You must first run firefox as root before running it as another user.
  The best way to do this is to su - to root or log
  in as root (i.e. do not su -m to root).  After becoming root, simply run
  ``firefox''.  You can then quit the browser, then run it as any other
  user.  If you do not run firefox as root first, the browser window will
  not appear.

20040608:
  AFFECTS: users of net/haproxy
  AUTHOR: clement@FreeBSD.org

  The haproxy port must now be enabled / disabled and configured in
  rc.conf.  See the pkg-message or script for details.

20040605:
  AFFECTS: users of www/apache2
  AUTHOR: clement@FreeBSD.org

  The apache2 port must now be enabled / disabled and configured in
  rc.conf.  See the pkg-message or script for details.

20040602:
  AFFECTS: users of sysutils/mkisofs and sysutils/mkisofs-devel
  AUTHOR: netchild@FreeBSD.org, marius@FreeBSD.org

  sysutils/mkisofs and sysutils/mkisofs-devel were merged into
  sysutils/cdrtools and sysutils/cdrtools-devel respectively.

  To update them generate ("make index") or fetch ("make fetchindex") a
  new INDEX/INDEX-5. Run "pkgdb -F" and unregister the mkisofs/-devel
  port. Then forcefully update the cdrtools port and all of its
  dependencies (e.g. "portupgrade -rf cdrtools"). After the update
  it may be necessary to rerun "pkgdb -F" and resolve a stale
  dependency to cdrtools.

20040531:
  AFFECTS: users of lang/perl5.8
  AUTHOR: mat@FreeBSD.org, marcus@FreeBSD.org

  lang/perl5.8 has been updated to 5.8.4. you should update everything
  depending on perl, that is :
    * first, upgrade your perl5.8 installation.
    * run "use.perl port", so that the system knows you have 5.8.4.
    * now, run some magic incantations to upgrade all ports depending on perl,
      that is run something like :
      portupgrade -f `(pkg_info -R perl-5.8.4 |tail +4; \
        find /usr/local/lib/perl5/site_perl/5.8.2 -type f -print0 \
        | xargs -0 pkg_which -fv | sed -e '/: ?/d' -e 's/.*: //')|sort -u`
      This is likely to fail for a few ports, you'll have to upgrade them
      afterward.

20040529:
  AFFECTS: users of mail/mailman and japanese/mailman
  AUTHOR: nork@FreeBSD.org

  In Mailman 2.1.5, some significant changes have been made to the
  file formats for qfiles and the pendings database.  See
  $PREFIX/share/doc/mailman/UPGRADING for details (if you define
  NOPORTDOCS, refer relevant file in an archive).

20040527:
  AFFECTS: users of net/openldap22-client
  AUTHOR: eik@FreeBSD.org

  The OpenLDAP library soname has changed, requiring a recompilation
  of all dependent ports:

  portupgrade -rf net/openldap22-client

20040525:
  AFFECTS: users of databases/postgresql-client
  AUTHOR: mat@FreeBSD.org

  This port was removed because of dependencies problem. If you still want to
  have it, install databases/postgresql7 with -DWITHOUT_SERVER

20040521:
  AFFECTS: users of irc/ircd-hybrid-ru
  AUTHOR: krion@FreeBSD.org

  UID/GID were changed from 6667 to 555, please manually delete
  old entries from /etc/passwd /etc/master.passwd and /etc/group

20040514:
  AFFECTS: users of audio/faad
  AUTHOR: pav@FreeBSD.org

  If the compilation of faad fails, please manually delete older
  installed version of faad and reinstall from port.

20040512:
  AFFECTS: users of print/teTeX
  AUTHOR: hrs@FreeBSD.org

  The print/teTeX no longer installs dvipsk by default.  To build and
  install dvipsk, you have to specify WITH_DVIPSK, or the dvipsk utility
  in the print/teTeX is also available print/dvipsk-tetex separately.
  This change is to resolve conflicts between various versions of dvips.

20040504:
  AFFECTS: users of mail/drac
  AUTHOR: nork@FreeBSD.org

  The "drac_flags" rc.conf(5) variable has been renamed to "dracd_flags".
  See the pkg-message or script for details.

20040501:
  AFFECTS: users of www/apache13
  AUTHOR: nork@FreeBSD.org

  The apache13 port must now be enabled / disabled and configured in
  rc.conf.  See the pkg-message or script for details.

20040429:
  AFFECTS: users of sysutils/smartmontools
  AUTHOR: nork@FreeBSD.org

  The smartmontools port must now be enabled / disabled and configured in
  rc.conf.  See the pkg-message or script for details.

20040420:
  AFFECTS: users of sysutils/cdrtools
  AUTHOR: netchild@FreeBSD.org

  The cdrecord program now uses ${PREFIX}/etc (e.g. /usr/local/etc) instead
  of /etc/default as the location of the global configuration file. If you
  created such a configuration file you need to copy it over to the new
  location.

20040420:
  AFFECTS: users of x11/kdebase3
  AUTHOR: kde@FreeBSD.org

  If you update KDE from version 3.2.1 or earlier to version 3.2.2 while
  running a KDE session, newly opened instances of Konqueror might hang
  or crash, depending on how far the update has progressed.

  If this happens, it is necessary to restart your KDE session in order to
  restore proper operations.

20040404:
  AFFECTS: GNOME desktop users
  AUTHOR: gnome@FreeBSD.org

  GNOME has been updated to 2.6.  Simply portupgrading will cause serious
  problems if you are using the desktop itself.  If you are a GNOME desktop
  user, you should carefully read the instructions at:

  http://www.freebsd.org/gnome/docs/faq26.html

  And use the gnome_upgrade.sh script to properly upgrade to GNOME 2.6.  If
  you are just a casual user of some of the GNOME libraries, portupgrade
  should be sufficient to update your ports.

20040316:
  AFFECTS: users of net/isc-dhcp3-*
  AUTHOR: des@FreeBSD.org

  The isc-dhcp3-* ports must now be enabled / disabled and configured in
  rc.conf.  See the pkg-message for details.

20040313:
  AFFECTS: users of textproc/expat2
  AUTHOR: marcus@FreeBSD.org

  Users of expat2 (and its many dependencies) should do the following to
  properly update expat2 and all of its dependencies:

  portupgrade -rf textproc/expat2

20040311:
  AFFECTS: users of databases/postgresql7
  AUTHOR: osa@FreeBSD.org

  PostgreSQL 7.4.2 Released and release notes available at
  http://www.postgresql.org/news/173.html

  NOTICE: unlike most minor versions, this version does require some
  updates to the pg_* system tables. Full instructions for how to do
  this are included in the full HISTORY file.

  DO NOT UPGRADE WITHOUT READING THESE INSTRUCTIONS.

20040309:
  AFFECTS: users of x11/kdelibs3 and x11/kdebase3
  AUTHOR: kde@FreeBSD.org

  If you update kdelibs from version 3.2.0 to version 3.2.1 while running
  a KDE 3.2.0 session, newly opened instances of Konqueror will silently
  crash as soon as the new version of kdelibs has been installed, due to
  mismatching linker symbols.

  It is recommended you quit your KDE session at that point and update
  kdebase to version 3.2.1, then restart KDE.

20040309:
  AFFECTS: users of audio/arts and x11/kdebase
  AUTHOR: kde@FreeBSD.org

  The arts port, PORTVERSION 1.2.1 does not include artswrapper anymore.
  Instead, artswrapper is now installed by a new port audio/artswrapper.

  Installation of artswrapper is optional, however:

  If you presently run KDE and you have "Run with the highest possible
  priority (realtime priority)" checked in Control Center/Sound & Multimedia/
  Sound System and you choose to NOT install audio/artswrapper, you need to

  - Uncheck "Run with the highest possible priority (realtime priority)"
    in Control Center/Sound & Multimedia/Sound System BEFORE updating arts

  OR

  - AFTER updating arts and kdebase, go to Control Center/Sound & Multimedia/
    Sound System, click on the unchecked "Run with the highest possible priority
    (realtime priority)", dismiss the message telling you that realtime is un-
    available or artswrapper is missing and then click Apply.

20040305:
  AFFECTS: users of security/antivir-milter
  AUTHOR: netchild@FreeBSD.org

  When updating from a previous version of security/antivir-milter you
  have to do the following after deinstalling the old port:
      rm <PREFIX>/AntiVir/antivir
      rm <PREFIX>/AntiVir/antivir.vdf
      chown root:wheel <PREFIX>/AntiVir
      chown root:smmsp <PREFIX>/AntiVir/hbedv.key
    In your SENDMAIL_MC change
      `S=unix:<PREFIX>/AntiVir/avmilter.sock, F=T, T=S:10m;R:10m;E:5m'
    to:
      `S=unix:/var/spool/avmilter/avmilter.sock, F=T, T=S:10m;R:10m;E:10m'
    and rebuild sendmail.cf.
    If /var/spool/avmilter exist you have to:
      chown -R smmsp:smmsp /var/spool/avmilter
    If you are using a customized <PREFIX>/etc/avmilter.conf the port
    won't remove it on deinstall and you have to manually change User
    and Group to smmsp there.
    Afterwards you can install the new version of this port. You then
    should run antivirupdater to get a current VDF.

20040226:
  AFFECTS: i386 users of ruby and portupgrade
  AUTHOR: knu@FreeBSD.org

  Change the default version of ruby to 1.8 for i386.

  If you are a ruby developer and want to keep ruby 1.6 as default,
  please add RUBY_DEFAULT_VER=1.6 to /etc/make.conf.

  Otherwise, please run the following series of commands to migrate to
  ruby 1.8:

  1) Reinstall portupgrade manually (and as a result ruby 1.8 will be
     installed):
	pkg_delete portupgrade-\*
	(cd /usr/ports/sysutils/portupgrade; make install clean)

  2) Reinstall everything that depends on ruby 1.6 to use ruby 1.8
     instead:
	portupgrade -fr lang/ruby16

  3) Reinstall ruby 1.8 (because the previous step kills symlinks):
	portupgrade -f lang/ruby18

  4) Deinstall ruby 1.6 stuff (if you are paranoia):
	pkg_deinstall -ri lang/ruby16

  5) If the above commands do now work somehow and portupgrade starts
     causing LoadError, please reinstall portupgrade manually again.
     Whenever you get confused, you can always deinstall portupgrade
     and all the ruby stuff (run "pkg_delete -r ruby-\*") and
     reinstall portupgrade as a last resort.

20040204:
  AFFECTS: 5.2-CURRENT users who started with a 5.2-RELEASE or older.
  AUTHOR: obrien@FreeBSD.org

  Change the default version of perl to 5.8.

  1) Force perl-5.6.1 to be upgraded with perl-5.8.
        portupgrade -o lang/perl5.8 -f perl-5.6.1_15

  2) Update all p5-* modules.
	portupgrade -f p5-\*

$FreeBSD$