Updating old files - GNU LilyPond
Description: GNU LilyPond

Next: Troubleshooting (taking it all apart), Previous: Typesetting existing music, Up: Working on LilyPond projects

### 4.3 Updating old files

The LilyPond input syntax occasionally changes. As LilyPond itself improves, the syntax (input language) is modified accordingly. Sometimes these changes are made to make the input easier to read and write or sometimes the changes are made to accomodate new features of LilyPond.

LilyPond comes with a file that makes this updating easier: `convert-ly`. For details about how to run this program, see Updating files with convert-ly.

Unforunately, `convert-ly` cannot handle all input changes. It takes care of simple search-and-replace changes (such as `raggedright` becoming `ragged-right`), but some changes are too complicated. The syntax changes that `convert-ly` cannot handle are listed in Updating files with convert-ly.

For example, in LilyPond 2.4 and earlier, accents and non-English letters were entered using LaTeX – for example, "`No\"el`" (this would print the French word for `Christmas'). In LilyPond 2.6 and above, the special "`ë`" must be entered directly into the LilyPond file as an UTF-8 character. `convert-ly` cannot change all the LaTeX special characters into UTF-8 characters; you must manually update your old LilyPond files.

This page is for LilyPond-2.8.8 (stable-branch).

Other languages: English.
Using automatic language selection.