2.2 Invoking convert-ly

convert-ly uses \version statements in the input file to detect the old version number. In most cases, to upgrade your input file it is sufficient to run

convert-ly -e myfile.ly

in the directory containing the file. This will upgrade ‘myfile.ly’ in-place and preserve the original file in ‘myfile.ly~’.

Note: convert-ly always converts up to the last syntax change handled by it. This means that the version number left in the file is usually lower than the version of convert-ly itself.

To convert all the input files in a directory together use

convert-ly -e *.ly

Alternatively, if you want to specify a different name for the upgraded file, preserving the original file and name unchanged, use

convert-ly myfile.ly > mynewfile.ly

The program will list the version numbers for which conversions have been made. If no version numbers are listed the file is already up to date.

MacOS X users may execute these commands under the menu entry Compile > Update syntax.

Windows users should enter these commands in a Command Prompt window, which is usually found under Start > Accessories > Command Prompt.


Other languages: deutsch, español, français, magyar, italiano, 日本語.
About automatic language selection.

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