.\" -*- coding: UTF-8 -*- .\" Process this file with .\" groff -man -Tascii vorbiscomment.1 .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH VORBISCOMMENT 1 "30 décembre 2008" "Fondation Xiph.Org" "Outils Ogg Vorbis" .SH NOM vorbiscomment – Listage ou édition des commentaires inclus dans les fichiers Ogg Vorbis .SH SYNOPSIS \fBvorbiscomment\fP \fB[\-l]\fP [\fB\-R\fP] [\fB\-e\fP] \fIfichier.ogg\fP .br \fBvorbiscomment\fP \fB\-a\fP \fB[ \-c fichier_commentaire | \-t \*(lqbalise=valeur\*(rq | \-d \*(lqbalise=valeur\*(rq ]\fP [\fB\-q\fP] [\fB\-R\fP] [\fB\-e\fP] \fIfichier_entrée.ogg\fP \fI[fichier_sortie.ogg]\fP .br \fBvorbiscomment\fP \fB\-w\fP \fB[ \-c fichier_commentaire | \-t \*(lqbalise=valeur\*(rq ]\fP [\fB\-q\fP] [\fB\-R\fP] [\fB\-e\fP] \fIfichier_entrée.ogg\fP \fI[fichier_sortie.ogg]\fP .SH DESCRIPTION \fBvorbiscomment\fP lit, modifie et ajoute des balises de métadonnées dans un fichier audio Ogg Vorbis. .SH OPTIONS .IP "\fB\-a\fP, \fB\-\-append\fP" Mise à jour des commentaires. .IP "\fB\-c\fP \fIfichier_commentaire\fP, \fB\-\-commentfile\fP \fIfichier_commentaire\fP" Récupération des commentaires à partir d'un fichier. Le fichier est au même format que celui produit par l’option \fB\-l\fP ou donné à l’option \fB\-t\fP : un élément par ligne au format « balise=valeur ». Si le fichier est \fI/dev/null\fP et que l’option \fB\-w\fP est indiquée, les commentaires existants seront supprimés. .IP "\-h, \-\-help" Affiche une aide pour les commandes. .IP "\fB\-l\fP, \fB\-\-list\fP" Affichage des commentaires présents dans le fichier Ogg Vorbis. .IP "\-q, \-\-quiet" Mode silencieux. Aucun message n'est affiché. .IP "\fB\-t\fP \fI'balise=valeur'\fP, \fB\-\-tag\fP \fI'balise=valeur'\fP" Indication d’une nouvelle balise sur la ligne de commande. Chaque paire balise\-valeur doit être indiquée dans une seule chaîne de caractères. La partie avant le « = » est traitée comme le nom de balise alors que la partie située après est considérée comme étant la valeur. .IP "\fB\-d\fP \fI'balise[=valeur]'\fP, \fB\-\-rm\fP \fI'balise[=valeur]'\fP" Indication d’une balise à supprimer sur la ligne de commande. Chaque paire balise\-valeur doit être indiquée dans une seule chaîne de caractères. La partie avant le « = » est traitée comme le nom de balise alors que la partie située après est considérée comme étant la valeur. Si aucune valeur n’est indiquée, toutes les balises dont le nom est indiqué seront supprimées. Sinon, seules les balises dont les valeurs correspondent seront supprimées. .IP "\fB\-w\fP, \fB\-\-write\fP" Remplacement des commentaires par le nouvel ensemble donné soit sur la ligne de commande avec l’option \fB\-t\fP, soit à partir d’un fichier indiqué avec l’option \fB\-c\fP. Si aucune option \fB\-c\fP ou \fB\-t\fP n’est indiquée, le nouvel ensemble sera lu à partir de l’entrée standard. .IP "\fB\-R\fP, \fB\-\-raw\fP" Lecture et écriture des commentaires en UTF\-8 au lieu de les convertir dans le jeu de caractères de l'utilisateur. .IP "\fB\-e\fP, \fB\-\-escapes\fP" Ajout de caractères de nouvelle ligne ou de controbliques dans les commentaires. Cela permet de s’assurer que chaque commentaire est sur une seule ligne dans la sortie (ou l’entrée), permettant de les filtrer ou les importer ou exporter. Sans cela, il n’est possible d’écrire des commentaires multilignes qu’en utilisant l’option \fB\-t\fP et il n’est pas possible de les distinguer des commentaires unilignes. Les séquences d’échappement prises en charge sont « \en », « \er », « \e\e » et « \e0 ». Une controblique suivie de rien d’autre est une erreur. Remarque : actuellement, tout ce qui se trouve après le premier « \e0 » est rejeté lors de l’écriture. C’est un bogue. Le format Vorbis peut sans problème stocker des octets NULL finaux, mais la plupart des autres outils de toute façon ne les géreront pas. .IP "\-V, \-\-version" Afficher la version de \fBvorbiscomment\fP. .\" Examples go here .SH EXEMPLES Pour afficher simplement quelles sont les balises dans un fichier : vorbiscomment \-l fichier.ogg Pour éditer ces commentaires : vorbiscomment \-l fichier.ogg > fichier.txt [édition des commentaires dans fichier.txt selon votre bon vouloir] vorbiscomment \-w \-c fichier.txt fichier.ogg nouveau_fichier.ogg Pour ajouter simplement un commentaire : vorbiscomment \-a \-t 'ARTIST=Personne que vous connaissez' fichier.ogg nouveau_fichier.ogg Pour ajouter un ensemble de commentaires à partir de l’entrée standard : vorbiscomment \-a fichier.ogg ARTIST=Personne que vous connaissez ALBUM=L’album définitif .SH "FORMAT DE BALISE" Consulter https://xiph.org/vorbis/doc/v\-comment.html pour une documentation sur le format de balise Ogg Vorbis, incluant une liste de suggestions de noms canoniques de balise. .SH AUTEURS .TP Auteurs du programme : .br Michael Smith .br Ralph Giles .br .TP Auteur de la page de manuel : .br Christopher L Cheney .SH "VOIR AUSSI" .PP \fBoggenc\fP(1), \fBoggdec\fP(1), \fBogg123\fP(1), \fBogginfo\fP(1) .PP .SH TRADUCTION La traduction française de cette page de manuel a été créée par François Wendling et Jean-Paul Guillonneau . .PP Cette traduction est une documentation libre ; veuillez vous reporter à la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 .UE concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. .PP Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à .MT debian-l10n-french@lists.debian.org .ME .