lilypond-usage: Command line options for convert-ly

 
 2.3 Command line options for ‘convert-ly’
 =========================================
 
 The program is invoked as follows:
 
      convert-ly [OPTION]... FILENAME...
 
    The following options can be given:
 
 ‘-d, --diff-version-update’
      increase the ‘\version’ string only if the file has actually been
      changed.  In that case, the version header will correspond to the
      version after the last actual change.  An unstable version number
      will be rounded up to the next stable version number unless that
      would exceed the target version number.  Without this option, the
      version will instead reflect the last _attempted_ conversion.
 
 ‘-e, --edit’
      Apply the conversions direct to the input file, modifying it
      in-place.  The original file is renamed as ‘myfile.ly~’.  This
      backup file may be a hidden file on some operating systems.
 
 ‘-b, --backup-numbered’
      When used with the ‘-e’ option, number the backup files so that no
      previous version is overwritten.  The backup files may be hidden on
      some operating systems.
 
 ‘-f, --from=FROM-PATCHLEVEL’
      Set the version to convert from.  If this is not set, ‘convert-ly’
      will guess this, on the basis of ‘\version’ strings in the file.
      E.g.  ‘--from=2.10.25’
 
 ‘-h, --help’
      Print usage help.
 
 ‘-l LOGLEVEL, --loglevel=LOGLEVEL’
      Set the output verbosity to LOGLEVEL.  Possible values, in upper
      case, are ‘PROGRESS’ (the default), ‘NONE’, ‘WARNING’, ‘ERROR’ and
      ‘DEBUG’.
 
 ‘-n, --no-version’
      Normally, ‘convert-ly’ adds a ‘\version’ indicator to the output.
      Specifying this option suppresses this.
 
 ‘-s, --show-rules’
      Show all known conversions and exit.
 
 ‘-t, --to=TO-PATCHLEVEL’
      Explicitly set which ‘\version’ to convert to, otherwise the
      default is the most current value.  It must be higher than the
      starting version.
 
           convert-ly --to=2.14.1 myfile.ly
 
    To upgrade LilyPond fragments in texinfo files, use
 
      convert-ly --from=... --to=... --no-version *.itely
 
    To see the changes in the LilyPond syntax between two versions, use
 
      convert-ly --from=... --to=... -s