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’.