-.\" Relecture Gérard Delafond
-.TH ENEMIES-OF-CARLOTTA 1
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.TH ENEMIES\-OF\-CARLOTTA 1
.SH NOM
-enemies-of-carlotta \- un gestionnaire de listes de diffusion simple
+enemies\-of\-carlotta \- Gestionnaire simple de listes de diffusion
.SH SYNOPSIS
-.B enemies-of-carlotta
-.IR "" [ options "] [" adresses ]
-.SH "DESCRIPTION"
-.B enemies-of-carlotta
-est un gestionnaire de listes de diffusion simple.
-Si vous ne savez pas ce qu'est un gestionnaire de listes de diffusion, vous
-devez commencez par apprendre de quoi il s'agit avant de vouloir vous en
-servir.
+\fBenemies\-of\-carlotta\fP [\fIoptions\fP] [\fIadresses\fP]
+.SH DESCRIPTION
+\fBenemies\-of\-carlotta\fP est un gestionnaire simple de listes de diffusion.
.PP
-Enemies of Carlotta conserve toutes les données des listes dans le répertoire
-.I ~/.enemies-of-carlotta.
-Il sera créé automatiquement lorsque vous créerez votre première liste.
-Vous devez vous arranger manuellement pour que les courriels soient traités
-par le gestionnaire de liste de diffusion.
-Les détails peuvent varier d'un système à l'autre.
-Pour QMail et Postfix, regardez ci-dessous.
+Enemies of Carlotta conserve toutes les données des listes dans le
+répertoire \fI~/.enemies\-of\-carlotta\fP. Celui\-ci sera créé automatiquement
+lors de la création de la première liste. Le traitement des courriels par
+le gestionnaire de listes doit être configuré manuellement. Les détails
+peuvent varier d'un système à l'autre. Pour QMail et Postfix, voir
+ci\-dessous.
.PP
-Chaque liste possède un ou plusieurs propriétaires, qui modèrent également
-les inscriptions, ou bien certains messages, voire tous.
-Sur les listes non modérées, les propriétaires de la liste sont chargés de
-répondre aux questions au sujet de la liste.
-Sur les liste totalement modérées, ils doivent approuver chaque message
-avant qu'il ne soit envoyé sur la liste.
-Sur les liste où
-.IR posting=auto ,
-les messages des abonnés sont automatiquement envoyés à la liste, et les
-modérateurs n'ont pas besoin d'approuver que les messages qui ne
-proviennent pas des abonnés.
+Chaque liste possède un ou plusieurs propriétaires, qui modèrent également
+les inscriptions ou certains messages, voire tous. Sur les listes non
+modérées, les propriétaires de la liste sont chargés de répondre aux
+questions concernant la liste. Sur les listes totalement modérées, ils
+doivent approuver chaque message avant qu'il ne soit envoyé sur la liste.
+Sur les liste où \fIposting=auto\fP, les messages des abonnés sont
+automatiquement envoyés à la liste, et les modérateurs n'ont besoin
+d'approuver que les messages qui ne proviennent pas des abonnés.
.SH OPTIONS
-.\" ---------------------------------------------------------------
-.TP
-.BR --name= foo@example.com
-Précise la liste sur laquelle la commande doit être effectuée.
-La plupart des options restantes nécessitent que vous précisiez
-le nom de la liste avec cette option.
-Avec les options --edit, --subscribe, --unsubscribe, et --list,
-le nom peut être abrégé en enlevant le signe @ et le domaine.
-.\" ---------------------------------------------------------------
-.TP
-.BI --create
-Créer une nouvelle liste de diffusion
-Vous devez précisez au moins un propriétaire à l'aide de
-.BR --owner .
-.\" ---------------------------------------------------------------
-.TP
-.BI --owner= adresse
-Indique la liste des propriétaires lorsque la liste est créée.
-.\" ---------------------------------------------------------------
-.TP
-.B --cleaning-woman
-Règle les problèmes des messages qui n'ont pas pu être délivrés et
-nettoie également quelques autres éléments.
-Vous devez lancer
-.B "enemies-of-carlotta --cleaning-woman"
-périodiquement.
-Cela nettoiera l'ensemble de vos listes de diffusion.
-.\" ---------------------------------------------------------------
-.TP
-.BI --destroy
-Détruit la liste.
-.\" ---------------------------------------------------------------
-.TP
-.BI --edit
-Modifie la configuration de la liste.
-.\" ---------------------------------------------------------------
-.TP
-.BI --subscription= type
-Lors de la création d'une liste, définit le mode d'abonnement à
-.I free
-(libre) ou
-.IR moderated
-(modéré).
-Utilisez-le avec
-.BR --edit ,
-ou
-.BR --create .
-.\" ---------------------------------------------------------------
-.TP
-.BI --posting= type
-Lors de la création d'une liste, définit le mode d'envoi à
-.IR free ,
-(libre)
-.IR auto ,
-(automatique)
-ou
-.IR moderated
-(modéré).
-Utilisez-le avec
-.BR --edit ,
-ou
-.BR --create .
-.\" ---------------------------------------------------------------
-.TP
-.BI --archived= yes-ou-no
-Les messages à destination de la liste doivent-ils être archivés sous
-la forme d'une
-.B archive-box
-ou d'un répertoire dans le répertoire dans liste
-.B "~/.enemies-of-carlotta"
-.
-Utilisez
-.I yes
-(oui) ou
-.IR no
+.TP
+\fB\-\-name=\fPfoo@example.com
+préciser la liste sur laquelle la commande doit être effectuée. La plupart
+des options doivent être accompagnées du nom de la liste concernée. Avec les
+options \-\-edit, \-\-subscribe, \-\-unsubscribe et \-\-list, le nom peut être
+abrégé en enlevant le signe @ et le domaine.
+.TP
+\fB\-\-create\fP
+créer une nouvelle liste de diffusion. Au moins un propriétaire doit être
+précisé à l'aide de \fB\-\-owner\fP.
+.TP
+\fB\-\-owner=\fP\fIadresse\fP
+ajouter un propriétaire à la liste lors de sa création
+.TP
+\fB\-\-moderator=\fP\fIadresse\fP
+ajouter un modérateur à la liste lors de sa création ou de son édition
+.TP
+\fB\-\-language=\fP\fIcode\-de\-la\-langue\fP
+configurer le code de la langue utilisé pour récupérer les fichiers
+modèles. Le code peut être vide (l'anglais sera utilisé par défaut) ou
+composé de deux lettres comme \fBfr\fP ou \fBes\fP.
+.TP
+\fB\-\-cleaning\-woman\fP
+gérer les adresses invalides et nettoyer quelques autres éléments. La
+commande \fBenemies\-of\-carlotta \-\-cleaning\-woman\fP doit être lancée
+périodiquement, comme une fois par heure, pour nettoyer l'ensemble des
+listes de diffusion.
+.TP
+\fB\-\-destroy\fP
+détruire une liste
+.TP
+\fB\-\-edit\fP
+modifier la configuration d'une liste
+.TP
+\fB\-\-subscription=\fP\fItype\fP
+définir le mode d'abonnement à \fIfree\fP (libre) ou \fImoderated\fP (modéré) lors
+de la création de la liste. À utiliser en combinaison avec \fB\-\-edit\fP ou
+\fB\-\-create\fP.
+.TP
+\fB\-\-posting=\fP\fItype\fP
+définir le mode d'envoi à \fIfree\fP (libre), \fIauto\fP (automatique) ou
+\fImoderated\fP (modéré). À utiliser en combinaison avec \fB\-\-edit\fP ou
+\fB\-\-create\fP.
+.TP
+\fB\-\-archived=\fP\fIyes\-ou\-no\fP
+définir si les messages de la liste doivent être archivés dans le
+sous\-répertoire \fBarchive\-box\fP du répertoire de la liste, lui\-même présent
+dans le répertoire \fB~/.enemies\-of\-carlotta\fP. Utiliser \fIyes\fP (oui) ou \fIno\fP
(non).
-.\" ---------------------------------------------------------------
-.TP
-.BI --list
-Liste l'ensemble des abonnés à une liste de diffusion.
-.\" ---------------------------------------------------------------
-.TP
-.BI --subscribe
-Ajoute des abonnés à la liste.
-Les arguments qui ne sont pas des options sont les adresses qui doivent
-être abonnées. Notez que les adresses ajoutées de cette manière ne
-recevront pas de demande de confirmation d'abonnement.
-.\" ---------------------------------------------------------------
-.TP
-.BI --unsubscribe
-Enlève un abonné de la liste.
-Les arguments qui ne sont pas des options sont les adresses qui doivent
-être désabonnées. Notez que les adresses enlevées de cette manière ne
-recevront pas de demande de confirmation de désabonnement.
-.\" ---------------------------------------------------------------
-.TP
-.B --incoming
-Traite un message entrant sur l'entrée standard.
-L'enveloppe SMTP qui précise l'adresse de l'expéditeur doit être
-précisée par la variable d'environnement
-.I SENDER
-et l'enveloppe SMTP qui précise l'adresse du destinataire doit être
-précisée par la variable d'environnement
-.I RECIPIENT
-(QMail et Postfix traitent cela automatiquement.)
-.\" ---------------------------------------------------------------
-.TP
-.BI --skip-prefix= chaîne
-Avant d'analyser l'adresse de destination pour regarder à quelle liste
-le message est destiné, ce paramètre permet d'enlever
-.I chaîne
-depuis son début.
-C'est utilisé pour traiter les domaines virtuels dans QMail et Postfix,
-voyez ci-dessous.
-.\" ---------------------------------------------------------------
-.TP
-.BI --domain= nom.domaine
-Avant d'analyser l'adresse de destination pour voir à quelle liste le message
-est destiné, remplace le nom de domaine par
-.IR nom.domaine .
-C'est utilisé pour traiter les domaines virtuels dans QMail et Postfix.
-.\" ---------------------------------------------------------------
-.TP
-.BI --is-list
-L'adresse précisée par
-.B --name
-fait-elle référence à un nom de liste valide\ ?
-Cela retourne le code d'erreur zéro (succès) si c'est le cas, ou un (échec)
-dans le cas contraire.
-.\" ---------------------------------------------------------------
-.TP
-.BI --sendmail= chemin
-Utilise
-.I chemin
-au lieu de
-.B /usr/sbin/sendmail
-Pour envoyer des courriels via une interface en ligne de commande.
-Notez que la commande doit respecter l'interface de la ligne de commande
-sendmail.
-.\" ---------------------------------------------------------------
-.TP
-.BI --smtp-server= hôte
-Envoi les courriels en utilisant le serveur
-.I hôte
-(port 25).
-Le serveur doit être configuré pour permettre à la machine sur laquelle
-fonctionne la liste de l'utiliser pour relais.
-Notez que par défaut, c'est l'interface en ligne de commande qui est utilisée.
-L'envoi au moyen de SMTP n'est utilisé que si vous utilisez cette option.
-.\" ---------------------------------------------------------------
-.TP
-.BI --moderate
-Force un message entrant à être modéré, même s'il est envoyé à une liste
-où l'envoi est libre.
-Cela peut être utilisé pour filtrer le spam\ :
-Vos messages entrants peuvent être filtrés par n'importe quel système de
-filtrage des courriels, dès lors qu'un message semble être du spam,
-vous pouvez demander qu'il soit modéré par une personne humaine.
-.\" ---------------------------------------------------------------
-.TP
-.BI --quiet
-Par défaut, les messages de débogage des journaux sont envoyés sur
-l'erreur standard.
-Avec cette option, il ne le sont plus.
-.\" ---------------------------------------------------------------
+.TP
+\fB\-\-mail\-on\-subscription\-changes=\fP\fIyes\-ou\-no\fP
+définir si les propriétaires de la liste doivent être avertis lors d'un
+abonnement ou d'un désabonnement. Utiliser \fIyes\fP (oui) ou \fIno\fP (non). La
+valeur par défaut est no.
+.TP
+\fB\-\-mail\-on\-forced\-unsubscription=\fP\fIyes\-ou\-no\fP
+définir si les propriétaires de la liste doivent être avertis lorsque
+quelqu'un est retiré de la liste en raison d'une adresse trop souvent
+invalide. Utiliser \fIyes\fP (oui) ou \fIno\fP (non). La valeur par défaut est no.
+.TP
+\fB\-\-ignore\-bounce=\fP\fIyes\-ou\-no\fP
+définir si les renvois pour adresse invalide doivent être ignorés. Utiliser
+\fIyes\fP (oui) ou \fIno\fP (non). La valeur par défaut est no.
+.TP
+\fB\-\-list\fP
+lister l'ensemble des abonnés à une liste.
+.TP
+\fB\-\-subscribe\fP
+ajouter des abonnés à la liste. Les arguments qui ne sont pas des options
+sont les adresses à abonner. Les adresses ajoutées de cette façon ne
+recevront pas de demande de confirmation.
+.TP
+\fB\-\-unsubscribe\fP
+enlever des abonnés de la liste. Les arguments qui ne sont pas des options
+sont les adresses à désabonner. Les adresses enlevées de cette manière ne
+recevront pas de demande de confirmation.
+.TP
+\fB\-\-incoming\fP
+traiter un message entrant sur l'entrée standard. L'adresse de l'expéditeur
+de l'enveloppe SMTP doit être précisée par la variable d'environnement
+\fISENDER\fP et l'adresse du destinataire de l'enveloppe SMTP doit être
+précisée par la variable d'environnement \fIRECIPIENT\fP. (QMail et Postfix
+traitent cela automatiquement.)
+.TP
+\fB\-\-skip\-prefix=\fP\fIchaîne\fP
+retirer \fIchaîne\fP du début de l'adresse de destination avant de l'analyser
+pour déterminer à quelle liste le message est destiné. Ceci permet le
+traitement des domaines virtuels avec QMail et Postfix, voir ci\-dessous.
+.TP
+\fB\-\-domain=\fP\fInom.du.domaine\fP
+remplacer le nom de domaine par \fInom.du.domaine\fP dans l'adresse de
+destination pour déterminer à quelle liste le message est destiné. Ceci
+permet le traitement des domaines virtuels avec QMail et Postfix.
+.TP
+\fB\-\-is\-list\fP
+déterminer si l'adresse indiquée par \fB\-\-name\fP fait référence à une liste
+valide. Le code de sortie zéro (succès) est retourné si c'est le cas, un
+(échec) dans le cas contraire.
+.TP
+\fB\-\-sendmail=\fP\fIchemin\fP
+utiliser \fIchemin\fP au lieu de \fB/usr/sbin/sendmail\fP pour envoyer des
+courriels via une interface en ligne de commande. Cette commande doit
+respecter l'interface de la ligne de commande sendmail.
+.TP
+\fB\-\-smtp\-server=\fP\fIhôte\fP
+envoyer les courriels en utilisant le serveur SMTP sur \fIhôte\fP (port 25). Le
+serveur doit être configuré pour permettre à la machine sur laquelle
+fonctionne la liste de l'utiliser comme relais. Par défaut, l'interface en
+ligne de commande est utilisée. L'envoi par SMTP n'est utilisé qu'avec cette
+option.
+.TP
+\fB\-\-qmqp\-server=\fP\fIhôte\fP
+envoyer les courriels en utilisant le serveur QMQP sur \fIhôte\fP (port
+628). Le serveur doit être configuré pour permettre à la machine sur
+laquelle fonctionne la liste de l'utiliser comme relais. Par défaut,
+l'interface en ligne de commande est utilisée. L'envoi par QMQP n'est
+utilisé qu'avec cette option.
+.TP
+\fB\-\-moderate\fP
+forcer un message entrant à être modéré, même s'il est envoyé à une liste où
+l'envoi est libre. Cela peut être utilisé pour filtrer les courriers
+indésirables\ : les messages entrants peuvent être filtrés par n'importe
+quel système de filtrage des courriels\ ; dès lors qu'un message semble être
+indésirable, une modération par un humain peut être demandée.
+.TP
+\fB\-\-post\fP
+forcer un message entrant à être envoyé, même s'il est envoyé à une liste où
+l'envoi est modéré. Cela peut être utilisé lorsqu'une vérification externe a
+lieu pour définir si le courriel est acceptable sur la liste, par exemple en
+vérifiant les signatures électroniques.
+.TP
+\fB\-\-quiet\fP
+ne pas envoyer les messages de débogage des journaux sur la sortie d'erreur
+standard, contrairement au comportement par défaut.
+.TP
+\fB\-\-sender=\fP\fIfoo@example.com\fP
+.TP
+\fB\-\-recipient=\fP\fIfoo@example.com\fP
+écraser les variables d'environnement \fBSENDER\fP et \fBRECIPIENT\fP
+respectivement, à utiliser en combinaison avec \fB\-\-incoming\fP et
+\fB\-\-is\-list\fP.
+.TP
+\fB\-\-get\fP
+obtenir les valeurs d'une ou plusieurs variables de configuration. Le nom
+des variables est indiqué sur la ligne de commande après les options. Chaque
+valeur est affichée sur une ligne séparée.
+.TP
+\fB\-\-set\fP
+configurer les valeurs d'une ou plusieurs variables de configuration. Les
+noms et valeurs sont donnés sur la ligne de commande après les options et
+séparés par un signe d'égalité («\ =\ »). Par exemple, la commande suivante
+configurerait une liste en français\ : \fBenemies\-of\-carlotta \-\-name=foo@bar
+\-\-set language=fr\fP
+.TP
+\fB\-\-version\fP
+afficher la version du programme
+.TP
+\fB\-\-show\-lists\fP
+lister les listes connues de enemies\-of\-carlotta
.SH CONFIGURATION
-Chaque liste est représentée par un répertoire, nommé d'après le nom de
-la liste, sous le répertoire
-.IR ~/.enemies-of-carlotta .
-Ce répertoire contient plusieurs fichiers et répertoires, qui sont décrits
-ci-dessous.
-En général, il n'est pas nécessaire de toucher à ces répertoires.
-Cependant, certaines configurations ésotériques peuvent uniquement être
-faites en éditant le fichier de configuration de la liste.
-.TP
-.B config
-Le fichier de configuration de la liste.
-Le contenu est décrit ci-dessous.
-.TP
-.B subscribers
-La base de données des abonnés.
-Chaque ligne contient un groupe d'abonné, dont les cinq premiers
-espaces délimitent les champs qui sont les identifiants des groupes,
-le statut, le timestamp de la date de création du groupe, le timestamp
-pour les retours de courriel en cas d'échec, il peut varier de «\ ok\ »
-à «\ bonced\ », et l'identifiant du message de retour en cas d'échec.
-.TP
-.B archive-box
-Les messages archivés.
-.TP
-.B bounce-box
-Groupes de messages qui n'ont pu être délivrés et qui sont dans le
-statut «\ ok\ ».
-.TP
-.B moderation-box
+Chaque liste est représentée par un répertoire, nommé d'après le nom de la
+liste, sous le répertoire \fI~/.enemies\-of\-carlotta\fP. Ce répertoire contient
+plusieurs fichiers et répertoires décrits ci\-dessous. En général, il n'est
+pas nécessaire de toucher à ces répertoires. Cependant, certaines
+configurations ésotériques peuvent uniquement être faites en éditant le
+fichier de configuration de la liste.
+.TP
+\fBconfig\fP
+Fichier de configuration de la liste. Le contenu est décrit ci\-dessous.
+.TP
+\fBsubscribers\fP
+Base de données des abonnés. Chaque ligne contient un groupe d'abonnés, dont
+les cinq premiers espaces délimitent les champs qui sont l'identifiant du
+groupe, l'état, la date de création du groupe, la date du message de retour
+qui a fait passer l'état de la liste de «\ ok\ » à «\ bounced\ », et
+l'identifiant du message de retour.
+.TP
+\fBarchive\-box\fP
+Messages archivés.
+.TP
+\fBbounce\-box\fP
+Groupes des messages de retour qui ne sont pas dans l'état «\ ok\ ».
+.TP
+\fBheaders\-to\-add\fP
+En\-têtes à ajouter aux courriels envoyés à la liste. Ceux\-ci sont copiés aux
+débuts des en\-têtes existants exactement tels qu'ils sont dans ce fichier,
+après que les en\-têtes de la liste (comme «\ List\-ID\ ») ont été ajoutés et
+que ceux mentionnés dans \fBheaders\-to\-remove\fP ont été retirés.
+.TP
+\fBheaders\-to\-remove\fP
+En\-têtes à retirer des messages envoyés à la liste.
+.TP
+\fBmoderation\-box\fP
Messages en attente d'approbation du modérateur.
-.TP
-.B subscription-box
-Requêtes d'abonnement de désabonnement en attente de confirmation de la
+.TP
+\fBsubscription\-box\fP
+Requêtes d'abonnement et de désabonnement en attente de confirmation de la
part de l'utilisateur.
+.TP
+\fBtemplates\fP
+Répertoires qui contiennent les modèles spécifiques à une liste
+(optionnel). Les modèles seront recherchés d'abord dans ce répertoire, s'il
+existe, puis dans les répertoires du système. Un fichier vide signifie que
+le message correspondant ne doit pas être envoyé. Cela peut être utilisé par
+exemple pour activer uniquement pour certaines listes les messages du type
+«\ veuillez attendre la modération de votre message\ ».
+.TP
+\fBplugins\fP
+Répertoires contenant des grephons, à savoir des fichiers source en Python
+qui sont chargés automatiquement par EoC au démarrage. Ces grephons peuvent
+modifier le comportement d'EoC.
.PP
-le fichier
-.B config
-possède des
-.IR mot-clé = value
-format\ :
+Le fichier \fBconfig\fP possède un format de type \fImot\-clé\fP=\fIvaleur\fP\ :
.PP
.RS
.nf
archived = no
posting = free
subscription = free
-mail-on-subscription-changes = yes
-mail-on-forced-unsubscribe = yes
-language = fi
+mail\-on\-subscription\-changes = yes
+mail\-on\-forced\-unsubscribe = yes
+language = fr
.fi
.RE
.PP
-Les mots clés
-.BR archived ,
-.BR posting ,
-et
-.B subscription
-correspondent aux options qui portent les mêmes noms.
-Les autres mots-clés sont\ :
-.TP
-.B owners
-Liste les adresses des propriétaires. Définissez-la à l'aide de
-l'option
-.I --owner.
-.TP
-.B mail-on-subscription-changes
-Les propriétaires doivent-ils recevoir un avertissement lorsqu'un utilisateur
-s'abonne ou se désabonne\ ?
-.TP
-.B mail-on-forced-unsubscribe
-Les propriétaires doivent-ils recevoir un avertissement lorsqu'une personne
-est enlevée de la liste car trop de courriels ne lui sont pas parvenus\ ?
-.TP
-.B language
-Suffixe pour les templates, pour permettre le support de plusieurs
-langues
-(Si
-.I language
-est défini à «\ fr\ », alors la template nommée «\ foo\ » est d'abord
-recherchée comme «\ foo.fr\ ».)
-.\" ---------------------------------------------------------------
+Les mots clés \fBarchived\fP, \fBposting\fP, et \fBsubscription\fP correspondent aux
+options qui portent les mêmes noms. Les autres mots\-clés sont\ :
+.TP
+\fBowners\fP
+Liste des adresses des propriétaires, définie avec l'option \fI\-\-owner\fP.
+.TP
+\fBmoderators\fP
+Liste des adresses des modérateurs, définie avec l'option \fI\-\-moderator\fP.
+.TP
+\fBmail\-on\-subscription\-changes\fP
+Valeur définissant si les propriétaires doivent être avertis lorsqu'un
+utilisateur s'abonne ou se désabonne.
+.TP
+\fBmail\-on\-forced\-unsubscribe\fP
+Valeur définissant si les propriétaires doivent être avertis si quelqu'un
+est retiré d'une liste suite à une adresse trop souvent invalide.
+.TP
+\fBignore_bounce\fP
+Valeur définissant si les messages de retour sont ignorés sur la
+liste. Utilisé par exemple lorsque la liste devrait avoir un nombre stable
+d'abonnés.
+.TP
+\fBlanguage\fP
+Suffixe pour les modèles, pour permettre la gestion de plusieurs
+langues. (Si \fIlanguage\fP est défini à «\ fr\ », alors le modèle «\ foo\ »
+est d'abord recherché en tant que modèle «\ foo.fr\ ».)
+.TP
+\fBpristine\-headers\fP
+Valeur définissant si les en\-têtes doivent être encodés au format MIME. Si
+la valeur vaut «\ yes\ », l'encodage aura lieu.
.SH EXEMPLES
-Pour créer une liste nommée
-.IR moviefans@example.com ,
-dont le propriétaire est
-.IR ding@example.com ,
-utilisez la commande suivante (tout sur la même ligne)\ :
+Créer une liste nommée \fImoviefans@example.com\fP, dont le propriétaire est
+\fIding@example.com\fP (tout sur la même ligne)\ :
.sp 1
+.nf
.RS
-enemies-of-carlotta --name=ding@example.com --create
+enemies\-of\-carlotta \-\-name=moviefans@example.com
+\-\-owner=ding@example.com \-\-create
.RE
+.fi
.PP
-Pour voir la liste de tous les abonnés à cette liste\ :
+Le système de messagerie doit être configuré pour que ces messages arrivent
+sur la liste (et à ses adresses de commande). Pour Qmail et Postfix, voir
+ci\-dessous.
+.PP
+Afficher la liste de tous les abonnés à cette liste\ :
.sp 1
+.nf
.RS
-enemies-of-carlotta --name=moviefans@example.com --list
+enemies\-of\-carlotta \-\-name=moviefans@example.com \-\-list
.RE
+.fi
.PP
-Les personnes qui souhaitent être abonnées à la liste doivent
-envoyer un courriel à
+Les personnes voulant s'abonner à la liste doivent envoyer un courriel à
.sp 1
+.nf
.RS
-moviefans-subscribe@example.com
+moviefans\-subscribe@example.com
.RE
+.fi
.SH QMAIL
-Dans Qmail, pour faire en sorte que le courrier entrant soit traité
-par Enemies of Carlotta, vous avez besoin de créer quelques fichiers
-.I .qmail-extension
-par liste.
-Par exemple, si votre nom d'utilisateur est joe et que vous souhaitez
-utiliser la liste de diffusion joe-fans, vous devrez créer les
-fichiers
-.I .qmail-fans
-et
-.IR .qmail-fans-default ,
-qui contiennent
+Avec Qmail, pour faire en sorte que les courriels entrants soient traités
+par Enemies of Carlotta, quelques fichiers \fI.qmail\-extension\fP sont
+nécessaires pour chaque liste. Par exemple, si joe est un nom
+d'utilisateur, pour initialiser la liste de diffusion joe\-fans, deux
+fichiers doivent être créés\ : \fI.qmail\-fans\fP et \fI.qmail\-fans\-default\fP, qui
+contiendront
.sp 1
.RS
-|"enemies-of-carlotta --incoming"
+|enemies\-of\-carlotta \-\-incoming
.RE
.PP
-Si vous utilisez un domaine virtuel, example.com, et que les
-courriels sont délivrés via
-.I /var/qmail/control/virtualdomains à joe-exampledotcom,
-les fichiers seront nommés
-.I .qmail-exampledotcom-fans
-et
-.I .qmail-exampledotcom-fans-default
-et ils contiendront
+Si les messages à destination d'un domaine virtuel, example.com, délivrés
+via \fI/var/qmail/control/virtualdomains\fP à \fIjoe\-exampledotcom\fP, les
+fichiers seront nommés \fI.qmail\-exampledotcom\-fans\fP et
+\&\fI.qmail\-exampledotcom\-fans\-default\fP et contiendront
.sp 1
.RS
-|"enemies-of-carlotta --incoming
-.br
---skip-prefix=joe-exampledotcom-"
+|enemies\-of\-carlotta \-\-incoming \-\-skip\-prefix=joe\-exampledotcom\-
.RE
.sp 1
-(l'ensemble sur la même ligne, il va de soi).
+(tout sur la même ligne).
.SH POSTFIX
-Avec Postfix, vous devrez configurer un fichier
-.I .forward
-contenant
+Avec Postfix, un fichier \fI.forward\fP contenant
.sp 1
.RS
-"|procmail -p"
+"|procmail \-p"
.RE
.sp 1
-et un fichier
-.I .procmailrc
-contenant
+sera nécessaire, ainsi qu'un fichier \fI.procmailrc\fP contenant
.sp 1
.RS
:0
.br
-* ? enemies-of-carlotta --name=$RECIPIENT --is-list
+* ? enemies\-of\-carlotta \-\-name=$RECIPIENT \-\-is\-list
.br
-| enemies-of-carlotta --incoming
+| enemies\-of\-carlotta \-\-incoming
.RE
.PP
-Pour utiliser Enemies of Carlotta avec un domaine virtuel Postfix,
-vous devrez mettre en place une
-.I «\ carte virtuelle d'expressions rationnelles\ »,
-généralement
-.I /etc/postfix/virtual_regexp
-(ajoutez
-.I "virtual_maps = regexp:/etc/postfix/virtual_regexp"
-dans votre fichier
-.I /etc/postfix/main.cf
-pour l'activer).
-Le fichier d'expressions rationnelles a besoin de faire des choses
-horribles pour conserver l'adresse de destination.
-Ajoutez ce qui suit dans le fichier d'expressions rationnelles\ :
+Pour utiliser Enemies of Carlotta avec un domaine virtuel Postfix, une
+\fIcarte virtuelle d'expressions rationnelles\fP généralement appelée
+\fI/etc/postfix/virtual_regexp\fP devra être créée (pour l'activer, ajouter
+\fIvirtual_maps = regexp:/etc/postfix/virtual_regexp\fP dans le fichier
+\fI/etc/postfix/main.cf\fP). Le fichier d'expressions rationnelles doit faire
+des choses horribles pour conserver l'adresse de destination. Il faut donc
+ajouter\ :
.sp 1
.RS
-/^your\.virtual\.domain$/ dummy
+/^your.virtual.domain$/ dummy
.br
-/^(yourlist|yourlist-.*)@(your\.virtual\.domain)$/ joe-virtual-$1
+/^(yourlist|yourlist\-.*)@(your.virtual.domain)$/ joe+virtual\-$1
.RE
.sp 1
-(Ça fait deux lignes.)
-Ensuite dans votre fichier,
-.I .procmailrc,
-ajoutez les options
-.I "--skip-prefix=joe-virtual-"
-et
-.I --domain=your.virtual.domain
-pour les deux appels à
-.BR enemies-of-carlotta .
+Soit deux lignes. Si \fIrecipient_delimiter\fP pour Postfix est configuré avec
+un moins au lieu d'un plus, utiliser \fBjoe\-virtual\fP. Ensuite dans le fichier
+\&\fI.procmailrc\fP, ajouter les options \fI\-\-skip\-prefix=joe\-virtual\-\fP et
+\fI\-\-domain=your.virtual.domain\fP pour les deux appels à
+\fBenemies\-of\-carlotta\fP.
+.PP
+Ces manipulations restent complexes.
+.SH "COMMANDES PAR MESSAGE"
+Les utilisateurs et propriétaires utilisent Enemies of Carlotta par courriel
+en utilisant des adresses de commande comme
+\fBfoo\-subscribe@example.com\fP. Voici une liste de toutes les adresses de
+commande accessibles aux utilisateurs et propriétaires. Dans tous ces
+exemples, le nom de la liste de diffusion sera \fBfoo@example.com\fP.
+.SS "Commandes par message accessibles à tout le monde"
+Ces commandes peuvent servir à tout le monde et ne demandent aucun privilège
+spécial.
+.TP
+\fBfoo@example.com\fP
+Envoie un courriel à tous les abonnés. Le message peut avoir à être approuvé
+d'abord par les modérateurs de la liste, qui ont aussi le pouvoir de le
+rejeter.
+.TP
+\fBfoo\-owner@example.com\fP
+Envoie un courriel au(x) propriétaire(s) de la liste.
+.TP
+\fBfoo\-help@example.com\fP
+Retourne en réponse à ce courriel un message contenant l'aide de la liste.
+.TP
+\fBfoo\-subscribe@example.com\fP
+Inscrit l'auteur du courriel à la liste. Le gestionnaire de listes répondra
+en demandant une confirmation. L'inscription n'aura lieu qu'en cas de
+réponse à cette demande. De cette manière, les personnes malveillantes ne
+peuvent ajouter votre adresse sur une ou beaucoup de listes de diffusion.
+.TP
+\fBfoo\-subscribe\-joe=example.com@example.com\fP
+Inscrit joe@example.com à la liste. Pour inscrire une adresse différente de
+celle utilisée pour la demande d'abonnement, utiliser cette forme. La
+demande de confirmation sera envoyée à joe@example.com puisque cette adresse
+seulement sera abonnée à la liste.
+.TP
+\fBfoo\-unsubscribe@example.com\fP
+Désinscrit l'auteur du courriel de la liste. Encore une fois, une demande de
+confirmation sera envoyée pour éviter que des personnes malveillantes
+désinscrivent d'autres personnes.
+.TP
+\fBfoo\-unsubscribe\-joe=example.com@example.com\fP
+Désinscrit joe@example.com de la liste. Encore une fois, cette dernière
+adresse recevra la demande de confirmation.
+.SS "Commandes par message pour les propriétaires de la liste."
+Les commandes suivantes peuvent être utilisées pour administrer la liste.
+.TP
+\fBfoo\-subscribe\-joe=example.com@example.com\fP
+Si un propriétaire envoie un courriel de ce type, il recevra la demande de
+confirmation à la place de joe@example.com. Il est souvent préférable de
+laisser les gens s'inscrire eux\-mêmes, mais parfois cela peut être utile que
+le propriétaire s'en occupe.
+.TP
+\fBfoo\-unsubscribe\-joe=example.com@example.com\fP
+Les propriétaires peuvent également désinscrire d'autres personnes.
+.TP
+\fBfoo\-list@example.com\fP
+Retourne la liste des abonnés à la liste. Cela ne marche que si l'adresse de
+l'expéditeur est celle de l'un des propriétaires. L'adresse de l'expéditeur
+est celle utilisée au niveau SMTP et non celle dans l'en\-tête From:.
+.TP
+\fBfoo\-setlist@example.com\fP
+Permet à un propriétaire de configurer la liste des abonnés en un seul
+coup. Cela correspond à une suite de commandes \-subscribe et \-unsubscribe,
+mais en plus simple. Tous ceux qui seront ajoutés à la liste recevront un
+message de bienvenue, alors que ceux qui seront retirés recevront un message
+d'adieu.
+.TP
+\fBfoo\-setlistsilently@example.com\fP
+Commande similaire à \-setlist, sans les envois des messages de bienvenue et
+d'adieu.
+.SH GREPHONS
+Enemies of Carlotta accepte des grephons. Des connaissances en Python sont
+nécessaires pour comprendre cette section.
+.PP
+Un grephon est un module Python (un fichier avec un suffixe \fB.py\fP), placé
+dans le répertoire \fB~/.enemies\-of\-carlotta/plugins\fP. Les grephons sont
+chargés automatiquement au démarrage, si la version déclarée de l'interface
+correspond à celle utilisée par Enemies of Carlotta. La version de
+l'interface est déclarée par la variable globale \fBPLUGIN_INTERFACE_VERSION\fP
+du module.
.PP
-(Oui, je aussi trouve que ces choses là sont trop compliquées)
+Les grephons peuvent définir des fonctions d'ancrage appelées au bon endroit
+dans le code d'EoC. Pour le moment, la seule fonction d'ancrage est
+\fBsend_mail_to_subscribers_hook\fP, qui peut modifier un courriel avant qu'il
+ne soit envoyé aux abonnés. La fonction devrait ressembler à\ :
+.PP
+.ti +5
+def send_mail_to_subscribers_hook(list, text):
+.PP
+L'argument \fIlist\fP est une référence à l'objet \fIMailingList\fP qui correspond
+à la liste concernée, et \fItext\fP est le texte complet du courriel tel qu'il
+existe actuellement. La fonction devrait retourner le nouveau contenu de ce
+courriel.
.SH FICHIERS
-.TP
-.I ~/.enemies-of-carlotta
-L'ensemble des fichiers en rapports avec vos listes de diffusion.
-.TP
-.I ~/.enemies-of-carlotta/secret
-Les mots de passe secrets utilisés pour générer des adresses signées pour
-le contrôle des couriels d'échec et la validation de l'abonnement.
-.TP
-.I ~/.enemies-of-carlotta/foo@example.com
-Le répertoire contient les données appartenant à la liste de diffusion
-foo@example.com.
-À l'exception du fichier de
-.I config
-qui se trouve dans ce répertoire, vous ne devriez pas éditer autre chose
-à la main
-.TP
-.I ~/.enemies-of-carlotta/foo@example.com/config
-Fichier de configuration pour la liste de diffusion.
-Vous aurez peut-être besoin de l'éditer à la main si vous souhaitez
-apporter des changement en ce qui concerne la modération ou bien les
-propriétaires de la liste.
+.TP
+\fI~/.enemies\-of\-carlotta\fP
+Ensemble des fichiers en rapport avec les listes de diffusion.
+.TP
+\fI~/.enemies\-of\-carlotta/secret\fP
+Mots de passe secrets utilisés pour générer des adresses signées pour le
+contrôle des messages de retour et la validation des abonnements.
+.TP
+\fI~/.enemies\-of\-carlotta/foo@example.com\fP
+Répertoire contenant les données appartenant à la liste de diffusion
+foo@example.com. À l'exception du fichier de \fIconfig\fP qui se trouve dans
+ce répertoire, rien ne devrait être à modifier.
+.TP
+\fI~/.enemies\-of\-carlotta/foo@example.com/config\fP
+Fichier de configuration pour la liste de diffusion. Ce fichier devra être
+édité pour modifier les options de modération ou les propriétaires de la
+liste.
.SH "VOIR AUSSI"
-Vous serez peut-être intéressé de visiter
-la page d'accueil d'
-.I «\ Enemies of Carlotta\ »
-à l'adresse
-.IR http://www.iki.fi/liw/eoc/ .
+Page web d'\fI«\ Enemies of Carlotta\ »\fP\ : \fIhttp://www.iki.fi/liw/eoc/\fP.
.SH "TRADUCTION"
Pierre Machard <pmachard@tuxfamily.org>, 2003
+.br
+Thomas Huriaux <thomas.huriaux@gmail.com>, 2005
projects / eoc.git / blobdiff