#!/usr/bin/perl

=encoding ISO8859-1

=head1 NOM

.ddtcrc - fichier de configuration du script ddtc.


=head1 DESCRIPTION

C'est le fichier de configuration pour ddtc. S'il existe, il doit se trouver
dans votre répertoire personnel (F<$HOME>). Ce fichier est optionnel à moins
que vous ne vouliez pas utiliser les valeurs par défaut.

Les lignes commençant par un dièse («E<nbsp>B<#>E<nbsp>») et les lignes vides
sont ignorées. Les espaces au début et à la fin d'une ligne sont aussi ignorés
ainsi que les tabulations. Si vous avez besoin d'espaces à la fin ou au début
d'une valeur, vous pouvez utilisez des guillemets anglo-saxons
(«E<nbsp>B<">E<nbsp>»).  Une ligne d'option débute par le nom de l'option suivi
par sa valeur. Le signe égal est optionnel.  Un commentaire commence par un
dièse, il peut y avoir des espaces ou des tabulations devant le dièse.
Quelques exemplesE<nbsp>:

 # cette ligne est ignorée
 option   valeur
 option = valeur                               # ceci est un commentaire
 option        "valeur avec espaces à la fin   "

Vous devez protéger le caractère dièse avec une barre oblique inversée
(«E<nbsp>B<\>E<nbsp>») si vous voulez l'utiliser dans une valeur.

Les valeurs par défaut sont fournies entre crochets, elles devraient convenir
pour la plupart des configurations.

=head1 GÉNÉRALE

=over 4

=item I<base_dir>

répertoire de base, c'est un sous-répertoire de votre F<$HOME> à moins qu'un
chemin absolu (c'est-à-dire commençant par «E<nbsp>/E<nbsp>») ne soit fourni
[ddts]E<nbsp>;

=item I<comment>

chaîne introduisant les commentaires de relecture, un caractère espace lui sera
ajouté [>>]E<nbsp>;

=item I<clean_regex>

expression rationnelle pour supprimer les fichiers avec la commande I<clean>
[~\$|\.old\$|\.bak\$]E<nbsp>;

=item I<language>

extension de langue à utiliser pour demander de nouveaux documents à traduire
ou à relire [vide]E<nbsp>;

=item I<editor>

éditeur de texte [/usr/bin/sensible-editor]E<nbsp>;

=item I<ddtc_bug>

détermine si les relectures sont envoyées dans un format particulier pour
éviter que le ddts ne mette à jour les parties de traduction. [no]

AttentionE<nbsp>: si cette option est positionnée à «E<nbsp>B<yes>E<nbsp>» (oui), la
possibilité d'accepter les modifications d'un relecteur en répondant simplement
à un rapport de relecture ne fonctionne pas et toute équipe de traduction
devrait utiliser ddtc. Demandez au coordinateur de votre équipe de traduction
avant de positionner cette option.

Pour la traduction en français («E<nbsp>frE<nbsp>»), cette option doit être
positionnée à «E<nbsp>B<yes>E<nbsp>»E<nbsp>;

=back

=head1 COURRIEL

=over 4

=item I<mail_out>

votre adresse électronique [la première parmi $ENV{EMAIL}, $ENV{DEBEMAIL}, vide
sinon]E<nbsp>;

=item I<mail_in>

adresse électronique à laquelle vous voulez que le ddts réponde. C'est
l'adresse qu'utilise le ddts pour vous identifier, vous B<devez> donc utiliser
cette option si I<mail_out> a une valeur différente [I<mail_out>]E<nbsp>;

=item I<mail_server>

adresse électronique du serveur [desc@ddtp.debian.org]E<nbsp>;

=item I<mail_encoding>

codage du courriel pour MIME [8bit]E<nbsp>;

=item I<mail_charset>

jeu de caractères du courriel pour MIME [le jeu utilisé par le ddts s'il est
connu, à défaut ISO-8859-1].

=item I<mail_self>

positionner à «E<nbsp>B<yes>E<nbsp>» (oui), si vous voulez recevoir une copie
des courriels envoyés [yes]E<nbsp>;

=back

=head1 COULEURS DES MENUS

Définit les couleurs du texte pour une meilleure présentation.

Les couleurs reconnues sontE<nbsp>: B<clear> et B<reset> (normal), B<dark>
(sombre), B<bold> (gras), B<underline> et B<underscore> (souligné), B<blink>
(clignotant), B<reverse> (inversé), B<concealed> (caché), B<black> (noir),
B<red> (rouge), B<green> (vert), B<yellow> (jaune), B<blue> (bleu), B<magenta>
(mangenta), B<cyan> (cyan), B<white> (blanc), B<on_black> (sur noir), B<on_red>
(sur rouge), B<on_green> (sur vert), B<on_yellow> (sur jaune), B<on_blue> (sur
bleu), B<on_magenta> (sur magenta), B<on_cyan> (sur cyan), et B<on_white> (sur
blanc). La casse n'est pas significative. B<underline> et B<underscore> sont
équivalents, de même que B<clear> et B<reset>, utilisez celui qui vous semble
le plus intuitif. Les I<couleurs> seules définissent la couleur des caractères,
et les I<sur couleurs> définissent la couleur du fond.

Notez que toutes les couleurs ne sont pas supportées par tous les types de
terminaux, et certains terminaux peuvent ne supporter aucune de ces séquences.
B<dark>, B<blink> et B<concealed> en particulier sont souvent manquantes.

=over 4

=item menu_title_color

couleur utilisée pour le titre [bold cyan]

=item menu_letter_color

couleur utilisée pour la lettre à saisir [bold cyan]

=item menu_text_color

couleur utilisée pour la description [cyan]

=back

=head1 EXEMPLE

Le fichier F</usr/share/doc/ddtc/ddtcrc> est un exemple de fichier de
configuration pour ddtc.

=head1 VOIR AUSSI

ddtc(1).

=head1 AUTEUR

Nicolas Bertolissio <bertol@debian.org>
  
=cut
