2.3 Options en ligne de commande pour convert-ly
L’utilitaire convert-ly se lance de la manière suivante :
convert-ly [option]… fichier…
Vous pouvez utiliser les options :
-
-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 pour éditer directement le fichier d’origine. Le fichier originel est renommé en ‘monfichier.ly~’. 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
et, pour les utilisateurs de windows :
convert-ly.py monfichier.ly > monnouveaufichier.ly
-
-b, --backup-numbered combine à l’option ‘-e’, pour numéroter les sauvegardes de telle sorte qu’aucune version antérieure ne soit écrasée. Les fichiers de sauvegarde, selon le système d’exploitation, peuvent être « cachés ».
-
-f, --from=from-patchlevel pour définir le numéro de version à partir duquel vous voulez effectuer les conversions. Lorsque cette option n’est pas activée,
convert-lytentera de le déterminer sur la foi de la mention de\versioncontenue dans le fichier. Cette option s’utilise sous la forme :--from=2.10.25-
-h, --help visualiser l’aide et quitter.
-
-l loglevel, --loglevel=loglevel pour régler le degré de verbosité à loglevel. Les différentes valeurs sont
NONE,ERROR,WARNING,PROGRESS(par défaut) etDEBUG.-
-n, --no-version Normalement,
convert-lyajoutera une indication de\versionà votre fichier s’il n’en comporte pas. Cette option permet de passer outre.-
-s, --show-rules pour afficher les conversions applicables.
-
-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
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