3.4 Updating files with convert-ly

The LilyPond input syntax is routinely changed to simplify it or improve it in different ways. As a side effect of this, the LilyPond interpreter often is no longer compatible with older input files. To remedy this, the program convert-ly can be used to deal with most of the syntax changes between LilyPond versions.

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

convert-ly -e myfile.ly

MacOS X users may execute this command under the menu entry Compile > Update syntax.

If there are no changes to myfile.ly and file called myfile.ly.NEW is created, then myfile.ly is already updated.


Other languages: espaƱol, deutsch.

Application Usage