2.3 Command line options for convert-ly

The program is invoked as follows:

convert-ly [option]… filename

The following options can be given:

-d, --diff-version-update

increase the \version string only if the file has actually been changed. In that case, the version header will correspond to the version after the last actual change. An unstable version number will be rounded up to the next stable version number unless that would exceed the target version number. Without this option, the version will instead reflect the last attempted conversion.

-e, --edit

Apply the conversions direct to the input file, modifying it in-place. The original file is renamed as ‘myfile.ly~’. This backup file may be a hidden file on some operating systems. Alternatively, if you want to specify a different name for the upgraded file without using the -e options default ~ appended to the old input file, the output can be redirected instead;

convert-ly myfile.ly > mynewfile.ly

Windows user would use;

convert-ly.py myfile.ly > mynewfile.ly
-b, --backup-numbered

When used with the ‘-e’ option, number the backup files so that no previous version is overwritten. The backup files may be hidden on some operating systems.

-f, --from=from-patchlevel

Set the version to convert from. If this is not set, convert-ly will guess this, on the basis of \version strings in the file. E.g. ‘--from=2.10.25

-h, --help

Print usage help.

-l loglevel, --loglevel=loglevel

Set the output verbosity to loglevel. Possible values, in upper case, are PROGRESS (the default), NONE, WARNING, ERROR and DEBUG.

-n, --no-version

Normally, convert-ly adds a \version indicator to the output. Specifying this option suppresses this.

-s, --show-rules

Show all known conversions and exit.

-t, --to=to-patchlevel

Explicitly set which \version to convert to, otherwise the default is the most current value. It must be higher than the starting version.

convert-ly --to=2.14.1 myfile.ly

To upgrade LilyPond fragments in texinfo files, use

convert-ly --from=… --to=… --no-version *.itely

To see the changes in the LilyPond syntax between two versions, use

convert-ly --from=… --to=… -s

LilyPond — Usage v2.21.7 (development-branch).