# $MCom$

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.

# put zenity in the instructions

2013MONTHDAY:
  AFFECTS: Pulseaudio users
  AUTHOR: gnome@FreeBSD.org

  The pulseaudio port was updated to 2.0, this includes a shared library change.

  # portmaster -r pulseaudio 
  or
  # portupgrade -rf pulseaudio

2013MONTHDAY:
  AFFECTS: users of GNOME 2 desktop components, avahi, libgdata, libchamplain
           and vte
  AUTHOR: gnome@FreeBSD.org

  Please note that these instructions are based on gnome being installed via
  the x11/gnome2 meta port. So if you only a partial installation then some
  of these steps might not fully apply to your situation.

  GNOME 3.4 has been added to the ports tree.  GNOME 3 and GNOME 2 desktop
  components are mutual exclusive. There shouldn't be any issue running gtk2
  applications with GNOME 3 or the other way around.

  The following instuctions are for people wanting to keep using GNOME 2.32:

  # portmaster -o devel/libgdata06 devel/libgdata
  # portmaster -o net-im/folks04 net-im/folks
  # pkg_delete -f vte-0.\* clutter-\*  libchamplain-\*
    or  pkg delete -f vte clutter clutter-gtk libchamplain
  # portmaster graphics/libchamplain08 x11-toolkits/vte graphics/clutter
  # portmaster -a

  or

  # pkgdb -F
  # pkg_delete -f avahi-gtk-\* vte-\* clutter-\*
  # portinstall net/avahi-gtk
  # portinstall x11-toolkits/vte graphics/clutter
  # portupgrade -o net-im/folks04 net-im/folks
  # portupgrade -o devel/libgdata06 devel/libgdata
  # portupgrade -o graphics/libchamplain08 graphics/libchamplain
  # portupgrade -a

  or

  # pkg users here :>

  If you want to start using the GNOME 3 desktop. and you have currently
  GNOME 2 installed, or parts of it, please use the instructions below.

  Make a list of your installed ports.

  # pkg delete -xR "^gnome\-" libwnck vte at-spi seed libgnomekbd gtk-vnc \
	clutter farsight2

  # pkg_delete -fr gnome-\* libwnck-2.\* vte-0.\* at-spi-1.\* seed-2.\* \
	libgnomekbd-2.\* gtk-vnc-0.3.\* clutter-\* farsight2
  # portmaster -a
  # install x11/gnome3 or x11/gnome3-lite

  or

  # pkg_delete -fr gnome-\* libwnck-2.\* vte-0.\*  at-spi-1.\* seed-2.\* \
	libgnomekbd-2.\* gtk-vnc-0.3.\* clutter-\* farsight2-\*
  # portinstall x11-toolkits/vte graphics/clutter
  # pkgdb -Ff
  # portupgrade -a

  or

  # pkg users here :>