2.4 Options en ligne de commande pour convert-ly

L’utilitaire convert-ly se lance de la manière suivante :

convert-ly [option]… fichier…

Par défaut, convert-ly écrit ses données sur la sortie standard.

Vous pouvez utiliser les options :

--version

Affiche le numéro de version et quitte.

-d, --diff-version-update

Actualise la valeur de \version, uniquement si le fichier a été effectivement modifié. Un numéro de version instable sera « arrondi » au niveau de la version stable suivante à moins que celui-ci ne soit supérieur à la version cible. En l’absence de cette option, ou bien si une conversion quelle qu’elle soit a modifié le fichier, la mention de version est porté à la valeur de la règle appliquée la plus récente.

-e, --edit

Édite directement le fichier d’origine. Le fichier originel est renommé en monfichier.ly~ – autrement dit, un tilde est ajouté à l’extension. Ce fichier de sauvegarde, selon le système d’exploitation, peut être « caché ».

Vous pouvez aussi affecter un autre nom au fichier mis à jour et conserver votre fichier original en l’état :

convert-ly monfichier.ly > monnouveaufichier.ly

Voir aussi l’option --backup-numbered.

-b, --backup-numbered

Combiné à l’option ‘-e’, numérote les sauvegardes de telle sorte qu’aucune version antérieure ne soit écrasée. Si le fichier à traîter est monfichier.ly, tente d’enregistrer la sauvegarde sous monfichier.ly.~1~. Si il existe déjà, essaie monfichier.ly.~2~, etc. Les fichiers de sauvegarde, selon le système d’exploitation, peuvent être « cachés ».

-f, --from=from-patchlevel

Définit le numéro de version à partir duquel vous voulez effectuer les conversions. Lorsque cette option n’est pas activée, convert-ly tentera de le déterminer sur la foi de la mention de \version contenue dans le fichier. Cette option s’utilise sous la forme : --from=2.10.25

-h, --help

Affiche l’aide et quitte.

-l loglevel, --loglevel=loglevel

Règle le degré de verbosité à loglevel. Les différentes valeurs sont PROGRESS (par défaut), NONE, WARN, ERROR et DEBUG.

-n, --no-version

Normalement, convert-ly ajoutera une indication de \version à votre fichier s’il n’en comporte pas. Cette option permet de passer outre.

-c, --current-version

Par défaut, convert-ly ajuste la valeur de \version au numéro de version minimal requis. L’activation de cette option lui affectera la version courante de LilyPond (2.25.30).

-s, --show-rules

Affiche les conversions applicables et quitte. Il est possible d’affiner l’information à l’aide des options --from et --to.

-t, --to=to-patchlevel

pour n’appliquer les conversions que jusqu’à une version déterminée. Il s’agit par défaut de la dernière version disponible. Le niveau demandé doit être supérieur à la version de départ.

convert-ly --to=2.14.1 monfichier.ly

-v, --verbose

Affiche une description des règles pendant la conversion.

-w, --warranty

Affiche les informations de garantie et de copyright et quitte.

Lorsqu’il s’agit de fragments inclus dans un fichier Texinfo, il vous faudra lancer

convert-ly --from=… --to=… --no-version *.itely

Lorsque vous désirez savoir quels changements de syntaxe sont intervenus entre deux versions de LilyPond, lancez

convert-ly --from=ancienne --to=récente -s