1.3 Messages d’erreur

Différents messages d’erreur sont susceptibles d’apparaître au cours de la compilation d’un fichier :

Warning – Avertissement ¶

Ce type de message est émis lorsque LilyPond détecte quelque chose de suspect. Si vous avez demandé quelque chose qui sort de l’ordinaire, vous saurez probablement ce à quoi il est fait référence et ignorerez de tels messages sans remord. Néanmoins, les messages d’avertissement indiquent la plupart du temps une incohérence dans le fichier source.

Error – Erreur ¶

LilyPond a détecté une erreur. L’étape en cours, qu’il s’agisse de l’analyse, de l’interprétation des données ou bien du formatage, sera menée à son terme, puis LilyPond s’arrêtera.

Fatal error – Erreur fatale ¶

LilyPond est confronté à une anomalie bloquante. Ceci ne se produit que très rarement, et la plupart du temps en raison d’une installation défectueuse des fontes.

Scheme error – Erreur Scheme ¶

Les erreurs qui interviennent lors de l’exécution de code Scheme sont gérées par l’interpréteur Scheme. L’utilisation du mode verbeux (options -V ou --verbose) vous permettra de localiser l’appel de fonction délictueux.

Programming error – Erreur de programmation ¶

LilyPond est confronté à une incohérence interne. Ce type de message est destiné à venir en aide aux développeurs et débogueurs. En règle générale, vous pouvez tout simplement les ignorer. Parfois, il y en a tant qu’ils masquent ce qui pourrait vous intéresser…

Aborted (core dumped) – Abandon ¶

Ce type de message indique que LilyPond a planté en raison d’une grave erreur de programmation. La survenance d’un tel message est considérée comme de la plus haute importance. Si vous y étiez confronté, transmettez un rapport de bogue.

Lorsque l’avertissement ou l’erreur est directement lié au fichier source, le message est libellé sous la forme

fichier:ligne:colonne: message
contenu de la ligne litigieuse

Un saut de ligne est placé dans la ligne de code, indiquant l’endroit précis du problème, comme ici :

test.ly:2:19: erreur: n'est pas une durée: 5
  { c'4 e'
           5 g' }

Notez que ces coordonnées constituent l’approximation au mieux par LilyPond dans le code ayant déclenché l’avertissement ou l’erreur. En règle générale, erreurs et avertissements surviennent lorsque LilyPond rencontre quelque chose d’inattendu. Lorsque la ligne indiquée ne vous semble pas comporter d’élément litigieux, remontez de quelques lignes dans votre code.

Par ailleurs, des diagnostics peuvent être déclenchés à n’importe quel moment au cours des différentes étapes du traitement. Par exemple, lorsque certaines parties de la source sont traitées plusieurs fois – sortie MIDI et sortie imprimable – ou qu’une même variable musicale est utilisée dans plusieurs contextes, peut apparaître le même message à plusieurs reprises. Les diagnostics effectués à une étape avancée du traitement, tels que les contrôles de mesure, sont aussi susceptibles d’apparaître plusieurs fois.

Vous trouverez d’autres informations sur les erreurs au chapitre Quelques erreurs des plus courantes.