lilypond-usage: Invoking convert-ly
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’.