GNU LilyPond

-- --

Invoking convert-ly

Convert-ly sequentially applies different conversions to upgrade a Lilypond input file. It uses \version statements in the file to detect the old version number. For example, to upgrade all lilypond files in the current directory and its subdirectories, use

             convert-ly -e --to=1.3.150 `find . -name '*.ly' -print`
     

The program is invoked as follows:

             convert-ly [option]... file...
     

The following options can be given:

-a,--assume-old

If version number cannot be determined, apply all conversions.

-e,--edit

Do an inline edit of the input file. Overrides --output.

-f,--from=from-patchlevel

Set the level to convert from. If this is not set, convert-ly will guess this, on the basis of \version strings in the file.

-o,--output=file

Set the output file to write.

-n,--no-version

Normally, convert-ly adds a \version indicator to the output. Specifying this option suppresses this.

-s, --show-rules

Show all known conversions and exit.

--to=to-patchlevel

Set the goal version of the conversion. It defaults to the latest available version.

-h, --help

Print usage help

BUGS

Not all language changes are handled. Only one output options can be specified.

Please send GNU LilyPond questions and comments to lilypond-user@gnu.org.

Please send comments on these web pages to (address unknown)

Copyright (c) 1997--2002 Han-Wen Nienhuys and Jan Nieuwenhuizen.

Verbatim copying and distribution of this entire article is permitted in any medium, provided this notice is preserved.