GNOME SlackBuild 2.30.0 for Slackware 13.1 Upgrade to 
  GNOME SlackBuild 3.0 for 13.37 <steve@gnomeslackbuild.org>

This document explains how to upgrade from earlier versions of GNOME
Slackbuild to GNOME SlackBuild 3.0 for Slackware 13.37.

----------------------------------------------------------------------------

For details of important changes from GNOME SlackBuild 2.32.0 for Slackware
13.1, see the file 'CHANGES_AND_HINTS.TXT'. 

Before you begin, I would strongly recommend making a backup of your system,
or, if not the entire system, at least the /etc directory.  You might find that
you need to refer to a few things after the upgrade process is complete. Back
it up, or take your chances.

You will first need to upgrade to Slackware 13.37, if you are not already
running it.  For the detailed instructions regarding this, please see Pat's own
UPGRADE.TXT.  Follow the directions there first and upgrade your system fully
to Slackware 13.37.  Once you have done that, then:


0.  Put your machine in single-user mode:
    telinit 1

    This is not strictly required, however, more things can go wrong in
multiuser, and some major libraries are upgrades and replaced (like glib2 and
gtk+2), so it's better if applications which use these libraries aren't
running.  

1.  Update slapt-getrc using a local mirror.

    The default method of upgrade is through slapt-get which can easily resolve
dependencies.  Consult the MIRRORS.TXT to find a local mirror, and update your
/etc/slapt-get/slapt-getrc file with a SOURCE= appropriately.  Be sure to add a
:CUSTOM tag to the end of the line so that packages are weighted properly.  If
you failed to add this, some required packages may not be updated
automatically.  If you wish to use a remote mirror when upgrading, make sure
that you can use networking even in single user mode. 
    If you are unable to access the internet when upgrading, it is still
possible to use slapt-get.  You will need to grab a full copy of the gsb or
gsb64 directory from a mirror.  You can then point your SOURCE= line in the
slapt-get file to file:///path/gsb.  This will then use a local copy in place
of a remote mirror. 
    Once you have updated this file, make sure to rerun:
   
    $ slapt-get --update

 
2.  Upgrade your previous GNOME SlackBuild installation and remove obsolete
packages.

    A lot of packages have been removed from the standard gsb tree with this
release, either due to having become obsolete or by being now included in the
official Slackware repositories.  First remove all packages from your system
which are listed in CHANGES_AND_HINTS.TXT either by using pkgtool or removepkg.
If you have slapt-get installed, you can use the '--remove-obsolete' option
when upgrading.

You may also wish to go into /var/log/packages and take a look at the package
list:

    ls -lt | less

    You may spot some old, obsolete, or discontinued packages.  If so, you can
remove these using 'removepkg'.

    Once you have done this, look at the list of required replacement packages
which are found in SLACKWARE_REPLACED_PACKAGES.TXT.  It is recommended that your
read this file to find out why certain standard Slackware packages need to be
replaced. This is most easily done using step 3 which follows.

    $ slapt-get --remove-obsolete --upgrade

slapt-get will upgrade all of your installed packages, and install any new
packages required as dependencies, and remove any discontinued packages.


3.  Fix your config files.  Some of the config files in /etc are going to 
    need your attention.  You'll find the new incoming config files on 
    your system with the ".new" extension.  You may need to fill these in 
    with information from your old config files and then move them over.

    This is important as some dbus, udev, and rc scripts are modified.  

4.  Return to multi-user mode:
    telinit 3

5.  Reboot to start using the any new services you may have installed, such as
    Avahi, or NetworkManager.  You may need to enable startup scripts in /etc/rc.d.


At this point you should be running GNOME SlackBuild 3.0 for Slackware 13.37.

---

The GNOME Slackbuild Team
<http://gnomeslackbuild.org>