Documentation/user/convert-ly.itexi

   1 @c -*-texinfo-*-
   2
   3 @node convert-ly
   4 @section convert-ly
   5
   6
   7 Convert-ly sequentially applies different
   8 lilypond-conversions to upgrade a Lilypond input file.  It uses
   9 @code{\version} statements in the file to detect the old version
  10 number.
  11
  12 @subsection Invoking convert-ly
  13
  14 @example
  15         convert-ly [options] [files]
  16 @end example
  17
  18
  19 @table @samp
  20 @item --output
  21     The output file to write.
  22 @item --edit
  23     Do an inline edit of the input file. override @code{--output}
  24 @item --show-rules
  25     shows all known conversions, and exit
  26 @item --from=@var{FROM_PATCHLEVEL}
  27     Set the level to convert from. If this is not set, convert-ly will
  28     guess this, on the basis of @code{\version} strings in the file
  29 @item --to=@var{TO_PATCHLEVEL}
  30     Set the goal version of the conversion. It defaults to the latest
  31     available version.
  32 @end table
  33
  34 Not all language changes are handled. Multiple output options won't
  35 work.
  36
  37 convert-ly is written in python, so you have install
  38 @uref{http://www.python.org,python}.  It was written by
  39 @email{hanwen@@cs.uu.nl, Han-Wen Nienhuys}.
  40
  41
  42