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 @unnumberedsubsec Invoking convert-ly
  12
  13 @example
  14         convert-ly [OPTION]... [FILE]...
  15 @end example
  16
  17
  18 @table @code
  19 @item -a,--assume-old
  20     If version number cannot be determined, apply all conversions.
  21 @item -e,--edit
  22     Do an inline edit of the input file. Overrides @code{--output}.
  23 @item -f,--from=@var{from-patchlevel}
  24     Set the level to convert from. If this is not set, convert-ly will
  25     guess this, on the basis of @code{\version} strings in the file.
  26 @item -o,--output=@var{file}
  27     Set the output file to write.
  28 @item -n,--no-version
  29     Normally, convert-ly adds a @code{\version} indicator
  30     to the output. Specifying this option suppresses this.
  31 @item -s, --show-rules
  32     Show all known conversions and exit.
  33 @item --to=@var{to-patchlevel}
  34     Set the goal version of the conversion. It defaults to the latest
  35     available version.
  36 @item -h, --help
  37     Print usage help
  38 @end table
  39
  40 @unnumberedsubsec Example
  41
  42 Upgrade all lilypond files to 1.3.150:
  43 @example
  44         convert-ly -e --to=1.3.150 `find -name '*.ly'`
  45 @end example
  46
  47 @unnumberedsubsec Bugs
  48
  49 Not all language changes are handled. Multiple output options won't
  50 work.
  51
  52 @unnumberedsubsec Authors
  53
  54 @code{convert-ly} is written in @uref{http://www.python.org,Python}. It
  55 was written by @email{hanwen@@cs.uu.nl, Han-Wen Nienhuys}. Report bugs
  56 to @code{bug-lilypond@@gnu.org}
  57
  58