NAME

crossbow-upgrade — Upgrade to crossbow 2.x

SYNOPSIS

DESCRIPTION

This program is meant to be called once per user, when upgrading Crossbow from the 1.x series to the 2.x series.

Upon execution crossbow-upgrade will scan through configuration of Crossbow 1.x, extracting the settings of each monitored feed into the new configuration file. The file will be saved as ~/.crossbow.conf. At the same time, the feed bookmarks will be converted to the new persistence format, so that the feeds can tracked from where the old version left off. Individual persistence files will be stored in the ~/.crossbow directory.

The new configuration file can be manually moved, if the user prefers so, to one of the alternative sourced paths. Consistently, an alternative location for the ~/.crossbow directory can be specified in the configuration file. See crossbow.conf(5).

As the old persistence files are converted to the new format, a back up copy is taken in the ~/crossbow.backup directory. The backup copy is not taken if the old configuration was located into an alternative path, that is if the CROSSBOW_VAR environment variable is defined for the current user. If this is the case, the new persistence files will not take the place of the old ones. Please note that the use of the CROSSBOW_VAR environment variable is no longer supported with the 2.x series.

ENVIRONMENT

CROSSBOW_VAR

Defines an alternative file-system location for the persistence in Crossbow 1.x. This variable is still honored by crossbow-upgrade, but it is no longer in use in Crossbow 2.x.

EXIT STATUS

crossbow-upgrade exits with 0 on success and with 1 in case of failure.

SEE ALSO

crossbow(1), crossbow-format(5), crossbow.conf(5)

AUTHORS

Giovanni Simoni <dacav@fastmail.com>