User's Guide - 4. Upgrading Fink
This chapter covers the procedures used to update your Fink installation with the latest and greatest stuff.
4.1 Upgrading using Binary Packages
If you use the binary distribution exclusively, there is no separate upgrade procedure. Just ask the tool of your choice to get the latest package listing from the server and let it update all packages.
For dselect, it is sufficient to hit "[U]pdate", then "[I]nstall". Of course, you may want to run "[S]elect" in between to check the selections that were made and to find out about new packages.
For apt, run apt-get update
to get the latest package
list, then apt-get upgrade
to update all packages that
have new versions available.
For Fink Commander, select Binary->Update descriptions to update the package list, and then Binary->Dist-Upgrade packages to update to new versions.
For more information, see the Upgrade Matrix.
4.2 Upgrading the Source Distribution
If you use the source distribution the procedure consists of two steps. In the first step, you download the latest package descriptions to your computer. In the second step, these package descriptions are used to compile new packages; the actual source code is downloaded as needed.
The first step can be accomplished by
running fink selfupdate
.
That command will check with the Fink website to see if a new point
release is available, and will automatically download and install the
package descriptions in that case.
You also have the
option to pull package descriptions directly from Git or via rsync.
Git is a version-controlled repository where the package descriptions
are stored and managed.
Using Git has the advantage that it is updated continuously, but the disadvantage that there is a single Git server for Fink, and it can be unreliable if there is a lot of traffic. For this reason, it is recommended that general users go with rsync. There are multiple mirrors available for rsync, and the only disadvantage is that package descriptions take an hour or so to migrate to the rsync mirrors after they've been added to Git.
(If you are having trouble upgrading a source installation, consult these special instructions.)
Once you have updated your package descriptions (no matter which way),
you should update all packages at once with the command fink
update-all
.
To update the source distribution using Fink Commander, select Source->Selfupdate to download new package information files, and then Source->Update-all to update your outdated packages.
4.3 Mixing Binaries and Source
If you use precompiled binary packages for some packages and build
others from source, you'll have to follow both sets of instructions
above to upgrade your Fink installation.
That is, first use dselect
or apt-get
to get
the latest versions of the packages that are available as binaries,
then use fink selfupdate
and fink update-all
to get the current package descriptions and to update the remaining
packages.
You may use the UseBinaryDist option (settable via the
--use-binary-dist (or -b) option
or in the Fink configuration file) both source and
binary descriptions will be updated if you call fink selfupdate
.
In this case you don't need a separate apt-get
call anymore.
If you are using Fink Commander select Binary->Update descriptions to update the package list, and then Binary->Dist-Upgrade packages to update to new versions. After that do Source->Selfupdate to download new package information files, and then Source->Update-all (see previous sections for details).