Fichiers de réadressage

Un deuxième mécanisme intervient en fait pour la configuration de l’exécution : LilyPond dépend fortement de programme ou bibloithèques externes, en particulier les bibliothèques FontConfig et Guile pour trouver respectivement les fontes du système et les traitement des fichiers Scheme, ainsi que le programme gs pour convertir les données PostScript en fichiers PDF. Tout ceci doit aussi être configuré pour retrouver ses propres fichiers de données. Pour y parvenir, le programme lilypond analyse tous les fichiers d’un répertoire dénommé relocate, s’il existe – voir ci-après les endroits où ce repertoire est recherché – afin de manipuler les variables d’environnement ce qui, en retour, contrôlera ces programmes et bibliothèques externes. Les format de ces fichiers de réadressage est simple, chaque ligne répondant à la syntaxe

commande clé=valeur

et les lignes vides y seront ignorées

La directive commande est l’une des suivantes :

set

Définit de manière inconditionnelle la variable d’environnement clé à valeur. Ceci écrase la valeur précédemment définie.

set?

Définit la variable d’environnement clé à valeur uniquement si clé n’est pas déjà définie. En d’autres termes, une valeur précédemment définie ne sera pas écrasée.

setdir

Lorsque valeur est un répertoire, définit inconditionnellement clé à valeur. Un message d’avertissement est émis dans le cas contraire.

setfile

Lorsque valeur est un fichier, définit inconditionnellement clé à valeur. Un message d’avertissement est émis dans le cas contraire.

prependdir

Ajoute le répertoire valeur à la liste des répertoires de la variable d’environnement clé. Dans le cas où clé n’existe pas, celle-ci sera créée.

Les variables d’environnement, identifiables au signe dollar qui les préfixe, sont permises en tant que valeur et seront expansées avant l’exécution de la directive.

Voici deux exemples d’entrée d’un fichier de réadresssage.

set? FONTCONFIG_FILE=$INSTALLER_PREFIX/etc/fonts/fonts.conf
prependdir GUILE_LOAD_PATH=$INSTALLER_PREFIX/share/guile/1.8

Dans la mesure où l’ordre d’analyse des fichiers du répertoire relocate est arbitraire, mieux vaut s’abstenir de définir une même variable d’environnement à de multiples lignes des fichiers de réadressage.