Upgrade Instructions for macOS 10.13

10.9/10/11/12 to 10.13

Before installing 10.13, use
```
fink selfupdate
```
(with rsync or git) to get the latest version of fink.
Update the OS.
Install Xcode 10.1 if you haven't already, or at least its Command Line Tools. If you already have Xcode 10.1, you will still need to reinstall the Command Line Tools, even if you had those installed already.
If you have Xcode 10.1, run
```
sudo xcodebuild -license
```
to accept the terms of the Xcode license. This is not required if you are using only the command-line tools.
Use
```
fink configure
```
to reactivate Fink's build user, since Apple wipes out our users (but not groups for some reason).
Use
```
fink reinstall fink
```
to point to the 10.13 distribution.
Optional:
Use
```
fink install perl5162-core
```
if you had any -pm5162 packages installed.

Use
```
fink list -it passwd | cut -f2 | xargs fink reinstall
```
if you had any passwd-* packages installed.

If you updated from 10.9/10/11/12 to 10.13 with a fink which doesn't know about 10.13, you won't be able to proceed. You can download a compatible pre-built fink and install it via the terminal by running

sudo dpkg -i fink_0.43.1-121_darwin-x86_64.deb

in the folder where you downloaded it.

10.8 and earlier to 10.13:

There is no supported upgrade path for Fink from 10.8 (or earlier) to 10.13.

The instructions here are an abridged version of those found in the Fink blog. The entries there provide a more detailed upgrade explanation.

This process collects the list of packages that you have installed on your current Fink and saves them for later use during the Fink install on 10.13

To collect the list of packages, follow the sequence below:

Use

grep -B1 "install ok installed" /sw/var/lib/dpkg/status | grep Package | cut -d: -f2 > fink_packages.txt

to dump your package information to a file.

Rename your Fink tree by using
```
sudo mv /sw /sw.old
```
, for example.
Install macOS 10.13, as well as Xcode 10.1, or the Command Line Tools at minimum.
Install Fink on your new 10.13 system.
Run the command:
```
cat fink_packages.txt | xargs fink install
```
to have your new Fink setup install as many of the packages that you previously had installed on 10.8 or earlier as are available.
Remove your /sw.old directory.

Not all of the packages available on 10.8 and earlier OS X versions are available on 10.13 due to several underlying changes in the system. Work is ongoing to make as many packages available as possible. If your favorite package is not available on 10.13, please contact the package maintainer and ask if it can be migrated.