[ << Mise à jour avec convert-ly ][Racine][Table des matières][Index][ Association musique-texte avec lilypond-book >> ]
[ < Exécution de convert-ly ][Plus haut: Mise à jour avec convert-ly ][]

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, WARNING, 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.4).

-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
[ << Mise à jour avec convert-ly ][Racine][Table des matières][Index][ Association musique-texte avec lilypond-book >> ]
[ < Exécution de convert-ly ][Plus haut: Mise à jour avec convert-ly ][]

<< Retour à l'accueil de la documentation

LilyPond — Utilisation des programmes v2.25.4 (branche de développement).