Documentation/user/convert-ly.itexi

   1 @c -*-texinfo-*-
   2
   3 @node Upgrading from older LilyPond versions
   4 @chapter Upgrading from older LilyPond versions
   5
   6
   7 Convert-ly sequentially applies different conversions to upgrade a
   8 Lilypond input file.  It uses @code{\version} statements in the file to
   9 detect the old version number.  For example, to upgrade all lilypond
  10 files in the current directory and its subdirectories, use
  11 @example
  12         convert-ly -e --to=1.3.150 `find . -name '*.ly' -print`
  13 @end example
  14
  15 The program is invoked as follows:
  16 @example
  17         convert-ly [@var{options}] @var{files}
  18 @end example
  19
  20
  21 The following options can be given:
  22
  23 @table @code
  24 @item -a,--assume-old
  25     If version number cannot be determined, apply all conversions.
  26 @item -e,--edit
  27     Do an inline edit of the input file. Overrides @code{--output}.
  28 @item -f,--from=@var{from-patchlevel}
  29     Set the level to convert from. If this is not set, convert-ly will
  30     guess this, on the basis of @code{\version} strings in the file.
  31 @item -o,--output=@var{file}
  32     Set the output file to write.
  33 @item -n,--no-version
  34     Normally, convert-ly adds a @code{\version} indicator
  35     to the output. Specifying this option suppresses this.
  36 @item -s, --show-rules
  37     Show all known conversions and exit.
  38 @item --to=@var{to-patchlevel}
  39     Set the goal version of the conversion. It defaults to the latest
  40     available version.
  41 @item -h, --help
  42     Print usage help
  43 @end table
  44
  45
  46
  47 @refbugs Bugs
  48
  49 Not all language changes are handled. Only one output options can be specified.