Documentation/user/convert-ly.itexi

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