With the sup release 0.14 some major changes require some migration (and cautionary steps).
Prior to updating sup, please back up your index, and preferably the whole .sup directory.
Before 0.14, Sup used syck to store YAML documents (the format of Sup's configuration files). In version 0.14 and later, Sup uses the Psych format instead. When upgrading, please use the migration utility.
After upgrading, run
sup-psych-ify-config-files to update the format of the
.sup/sources.yaml file. If something goes wrong, you probably need to manually re-add the sources (make sure that the source IDs match the old configuration!).
Because later versions of Ruby drop support for the old syck format completely, the migration script will not run with Ruby >= 2.1 (#268), and will eventually be completely removed. There are several possible options:
sup-configto re-add your source(s). You must then manually edit
.sup/sources.yamland edit the Source IDs (
id) to match the old configuration. See below for detailed instructions.
~/.sup/sources.yamlin your favourite editor. Take careful note of the Source ID assigned to each configuration.
sup-dumpto back up the index.
~/.supdirectory (with config files and index)
sup-configand follow the prompts.
~/.sup/sources.yamlin your favourite editor. Find the newly added source, and modify the
idto match the old configuration.