Documentation/user/convert-ly.itexi

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