]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/user/convert-ly.itexi
9d001f89b1391930f83847e091583496faec1ec8
[lilypond.git] / 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 [OPTION]... [FILE]...
15 @end example
16
17
18 @table @code
19 @item --assume-old
20     If version number cannot be determined, apply all conversions.
21 @item --edit
22     Do an inline edit of the input file. override @code{--output}
23 @item --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 --output
27     The output file to write.  
28 @item --show-rules
29     shows all known conversions, and exit
30 @item --to=@var{TO_PATCHLEVEL}
31     Set the goal version of the conversion. It defaults to the latest
32     available version.
33 @end table
34
35 Not all language changes are handled. Multiple output options won't
36 work.
37
38 @code{convert-ly} is written in @uref{http://www.python.org,Python}. It
39 was written by @email{hanwen@@cs.uu.nl, Han-Wen Nienhuys}.
40
41
42