convert-ly(1) · carta

Usage

convert-ly [OPTION] ... FILE

Overview

Update LilyPond input to newer version. By default, update from the version taken from the \version command, to the current LilyPond version. If FILE is `-', read from standard input.

Options

--version: show version number and exit

-h, --help: show this help and exit

-f, --from=VERSION: start from VERSION [default: \version found in file]

-e, --edit: edit in place

-l, --loglevel=LOGLEVEL: Print log messages according to LOGLEVEL (NONE, ERROR, WARN, PROGRESS (default), DEBUG)

-n, --no-version: do not add \version command if missing

-c, --current-version: force updating \version number to 2.26.0

-d, --diff-version-update: only update \version number if file is modified

-s, --show-rules: show rules [default: -f 0, -t 2.26.0]

-t, --to=VERSION: convert to VERSION [default: 2.26.0]

-b, --backup-numbered: make a numbered backup [default: filename.ext~]

-v, --verbose: print rule descriptions during conversion

-w, --warranty: show warranty and copyright

Examples

: $ convert-ly -e old.ly
$ convert-ly --from=2.3.28 --to=2.5.21 foobar.ly > foobar-new.ly

History

Arch Linux 2026-11-01: the text shown here
Debian 13 (Trixie)
Debian 12 (Bookworm)
Debian 11 (Bullseye)
Debian 10 (Buster)
Debian 8 (Jessie)
Debian 7 (Wheezy)
Debian 6.0 (Squeeze)
Debian 5.0 (Lenny)
Debian 4.0 (Etch)
Debian 3.1 (Sarge)
Debian 3.0 (Woody)

--backup-numbered since Debian 8 (Jessie); --current-version since Debian 6.0 (Squeeze); --diff-version-update since Debian 7 (Wheezy); --loglevel since Debian 8 (Jessie); --verbose since Arch Linux 2026-11-01; --warranty since Debian 6.0 (Squeeze); -b since Debian 8 (Jessie); -c since Debian 6.0 (Squeeze); -d since Debian 7 (Wheezy); -l since Debian 8 (Jessie); -v since Arch Linux 2026-11-01; -w since Debian 6.0 (Squeeze).

--assume-old until Debian 3.0 (Woody); -a until Debian 3.0 (Woody).