migrate(1)

Synopsis

migrate [option…] [--] <pkg-top>…

migrate --clean-info [--] <pkg-top>…

migrate --help|-h|-?

Options:

-n|--dry-run

-q|--quiet

-v|--verbose

Description

migrate will convert a Cetbuildtools package to use Cetmodules 3.23, or refresh and annotate an existing cetmodules package.

Many changes to the CMake code and various configuration files of the specified packages will be made automatically. Other necessary or recommended changes will be flagged by means of inline comments ### MIGRATE-ACTION....

Arguments

<pkg-top>

Path to the top-level directory of a package using Cetbuildtools or Cetmodules.

Options

--help, -h, -?

Long-form help.

--clean-info

If specified, a “normal” migration will not be performed; instead, CMake files will be cleaned of any existing non-“ACTION” tags.

--flags-only

During a migration, only “ACTION” tags will be added to CMake files.

-n, --dry-run

Do not change, replace or remove files under <pkg-top>. Any proposed changes or annotations to a file will be written to a new file with .new appended to the name of the original.

-q, --quiet

Show fewer messages of type INFO.

-v, --verbose

Show messages of type VERBOSE.

Notes

• Any files to be removed or altered will be backed-up to <pkgtop>/migrate-backup-timestamp. New files will be created with a “.new” extension before being moved to replace their original unless B<-n> has been specified.

• Any line which has been flagged for action (### MIGRATE-ACTION-...) may be ignored on future invocations of migrate by replacing the annotation with, ### MIGRATE-NO-ACTION.

• In spite of the backup, it is recommended that the current state of the package be checked in to a repository or otherwise saved prior to invoking migrate for easy restoration in case of suboptimal results.