Ajout de commentaires au fichier source de messages
Vous pouvez inclure un commentaire n'importe où dans un fichier source de messages, sauf dans le texte du message. Laissez au moins un espace ou une tabulation (en blanc) après le $ (signe dollar).
Exemple de commentaire :
$ This is a comment.
Les commentaires n'apparaissent pas dans le catalogue de messages généré à partir du fichier source de messages.
Les commentaires peuvent aider les développeurs dans le processus de gestion des fichiers source de messages, les traducteurs dans le processus de traduction et les rédacteurs dans le processus d'édition et de documentation des messages. Utilisez les commentaires pour identifier ce que les variables, telles que %s, %c et %d, représentent. Par exemple, créez une note indiquant si la variable fait référence à un utilisateur, un fichier, un répertoire ou un indicateur. Les commentaires doivent également être utilisés pour identifier les messages obsolètes.
Pour plus de clarté, vous devez placer une ligne de commentaire directement sous le message auquel elle fait référence, plutôt qu'au bas du catalogue de messages. Les commentaires globaux concernant tout un ensemble peuvent être placés directement sous la directive $set.