[Bugzilla-fr-cvs] docs/xml patches.xml

[Emmanuel S. <se...@us...>]

Update of /cvsroot/bugzilla-fr/docs/xml
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv8565

Modified Files:
      Tag: BUGZILLA-2_18-BRANCH
	patches.xml 
Log Message:
traduction de patches.xml

Index: patches.xml
===================================================================
RCS file: /cvsroot/bugzilla-fr/docs/xml/patches.xml,v
retrieving revision 1.1.1.1
retrieving revision 1.1.1.1.2.1
diff -C2 -d -r1.1.1.1 -r1.1.1.1.2.1
*** patches.xml	22 Jul 2005 21:08:40 -0000	1.1.1.1
--- patches.xml	20 Aug 2005 10:50:59 -0000	1.1.1.1.2.1
***************
*** 4,70 ****
  
    <para>
!     There are a number of unofficial Bugzilla add-ons in the 
!     <filename class="directory">$BUGZILLA_ROOT/contrib/</filename>
!     directory. This section documents them.
    </para>
  
    <section id="cmdline">
!     <title>Command-line Search Interface</title>
  
      <para>
!       There are a suite of Unix utilities for searching Bugzilla from the 
!       command line. They live in the 
!       <filename class="directory">contrib/cmdline</filename> directory.
!       There are three files - <filename>query.conf</filename>,
!       <filename>buglist</filename> and <filename>bugs</filename>.
      </para>
  
      <warning>
        <para>
!         These files pre-date the templatisation work done as part of the
!         2.16 release, and have not been updated.
        </para>
      </warning>
      
      <para>
!       <filename>query.conf</filename> contains the mapping from
!       options to field names and comparison types. Quoted option names
!       are <quote>grepped</quote> for, so it should be easy to edit this
!       file. Comments (#) have no effect; you must make sure these lines
!       do not contain any quoted <quote>option</quote>.
      </para>
  
      <para>
!       <filename>buglist</filename> is a shell script that submits a
!       Bugzilla query and writes the resulting HTML page to stdout.
!       It supports both short options, (such as <quote>-Afoo</quote>
!       or <quote>-Rbar</quote>) and long options (such
!       as <quote>--assignedto=foo</quote> or <quote>--reporter=bar</quote>).
!       If the first character of an option is not <quote>-</quote>, it is
!       treated as if it were prefixed with <quote>--default=</quote>.
      </para>
  
      <para>
!       The column list is taken from the COLUMNLIST environment variable.
!       This is equivalent to the <quote>Change Columns</quote> option
!       that is available when you list bugs in buglist.cgi. If you have
!       already used Bugzilla, grep for COLUMNLIST in your cookies file
!       to see your current COLUMNLIST setting.
      </para>
  
      <para>
!       <filename>bugs</filename> is a simple shell script which calls
!       <filename>buglist</filename> and extracts the
!       bug numbers from the output. Adding the prefix
        <quote>http://bugzilla.mozilla.org/buglist.cgi?bug_id=</quote>
!       turns the bug list into a working link if any bugs are found.
!       Counting bugs is easy. Pipe the results through 
!       <command>sed -e 's/,/ /g' | wc | awk '{printf $2 "\n"}'</command>
      </para>
  
      <para>
!       Akkana Peck says she has good results piping 
!       <filename>buglist</filename> output through 
!       <command>w3m -T text/html -dump</command>
      </para>
  
--- 4,70 ----
  
    <para>
!     Il existe un certain nombre d'add-ons non officiels pour Bugzilla dans le
!     répertoire <filename class="directory">$BUGZILLA_ROOT/contrib/</filename>.
!     Cette section leur tient lieu de documentation.
    </para>
  
    <section id="cmdline">
!     <title>L'interface de recherche en ligne de commande</title>
  
      <para>
!       Il existe une série d'utilitaires Unix pour faire des recherches dans Bugzilla depuis la
!       ligne de commande. On les trouve dans le répertoire
!       <filename class="directory">contrib/cmdline</filename>.
!       Il y a trois fichiers&#160;: <filename>query.conf</filename>,
!       <filename>buglist</filename> et <filename>bugs</filename>.
      </para>
  
      <warning>
        <para>
!         Ces fichiers datent d'avant le travail de création de modèles effectué
!         dans la version 2.16, et n'ont pas été mis à jour.
        </para>
      </warning>
      
      <para>
!       <filename>query.conf</filename> contient la correspondance entre les options de ligne
!       de commande et les noms de champs ainsi que les types de comparaison. Les noms d'option entre
!       guillemets sont rassemblés de telle manière qu'il soit facile d'éditer ce
!       fichier. Les commentaires (#) n'ont aucun effet ; assurez vous que ces lignes
!       ne contiennent pas <quote>d'option</quote> entre guillements.
      </para>
  
      <para>
!       <filename>buglist</filename> est un script shell dont le rôle est d'adresser une requête
!       à Bugzilla et d'écrire le résultat sous forme d'une page HTML sur la sortie standard.
!       Il prend en compte à la fois les options abbrégées (comme <quote>-Afoo</quote>
!       ou <quote>-Rbar</quote>) et les options en format long (comme
!       <quote>--assignedto=foo</quote> ou <quote>--reporter=bar</quote>).
!       Si le premier caractère d'une option n'est pas le signe <quote>-</quote>, elle est
!       considérée comme étant préfixée de <quote>--default=</quote>.
      </para>
  
      <para>
!       La liste en colonnes est extraite du contenu de la variable d'environnement COLUMNLIST.
!       C'est équivalent à l'option <quote>Change columns</quote>
!       lorsque vous inscrivez les bogues dans buglist.cgi. Si vous avez
!       déjà utilisé Bugzilla, lancez grep sur COLUMNLIST dans vos fichiers de cookies
!       pour voir le contenu actuel de COLUMNLIST.
      </para>
  
      <para>
!       <filename>bugs</filename> est un simple script qui appelle
!       <filename>buglist</filename> et extrait les
!       numéros de bogues à partir du résultat en sortie. Le fait d'ajouter le préfixe
        <quote>http://bugzilla.mozilla.org/buglist.cgi?bug_id=</quote>
!       transforme la liste de bogues en liens qui fonctionnent si des bogues sont trouvés.
!       Compter les bogues est une chose aisée. Récupérez le résultat avec un tube vers
!       <command>sed -e 's/,/ /g' | wc | awk '{printf $2 "\n"}'</command>.
      </para>
  
      <para>
!       Akkana Peck affirme avoir de bons résultats en plaçant un tube au niveau du
!        résultat de <filename>buglist</filename> vers
!        <command>w3m -T text/html -dump</command>
      </para>
  
***************
*** 72,107 ****
  
    <section id="cmdline-bugmail">
!     <title>Command-line 'Send Unsent Bug-mail' tool</title>
  
      <para>
!       Within the <filename class="directory">contrib</filename> directory
!       exists a utility with the descriptive (if compact) name
!       of <filename>sendunsentbugmail.pl</filename>. The purpose of this
!       script is, simply, to send out any bug-related mail that should
!       have been sent by now, but for one reason or another has not.
      </para>
  
      <para>
!       To accomplish this task, <filename>sendunsentbugmail.pl</filename> uses
!       the same mechanism as the <filename>sanitycheck.cgi</filename> script; it
!       it scans through the entire database looking for bugs with changes that
!       were made more than 30 minutes ago, but where there is no record of
!       anyone related to that bug having been sent mail. Having compiled a list,
!       it then uses the standard rules to determine who gets mail, and sends it
!       out.
      </para>
  
      <para>
!       As the script runs, it indicates the bug for which it is currently
!       sending mail; when it has finished, it gives a numerical count of how
!       many mails were sent and how many people were excluded. (Individual
!       user names are not recorded or displayed.) If the script produces
!       no output, that means no unsent mail was detected.
      </para>
  
      <para>
!       <emphasis>Usage</emphasis>: move the sendunsentbugmail.pl script
!       up into the main directory, ensure it has execute permission, and run it
!       from the command line (or from a cron job) with no parameters.
      </para>
    </section>
--- 72,107 ----
  
    <section id="cmdline-bugmail">
!     <title>L'outil « envoi de courriel de bogue non-envoyé » en ligne de commande</title>
  
      <para>
!       Au sein du répertoire <filename class="directory">contrib</filename>
!       existe un utilitaire portant le nom explicite (bien que compact)
!       de <filename>sendunsentbugmail.pl</filename>. Le but de ce
!       script est simplement d'émettre tout courriel relatif à un bogue qui aurait
!       déja dû être envoyé  mais qui, pour une raison ou une autre, ne l'a pas été.
      </para>
  
      <para>
!       Pour accomplir cette tâche, <filename>sendunsentbugmail.pl</filename> utilise
!       le même mécanisme que le script <filename>sanitycheck.cgi</filename>; il
!       parcourt entièrement la base de donnée en cherchant les bogues présentant des changemenents
!       effectués il y a plus de 30 minutes, là où il ne trouve aucune trace indiquant
!       qu'un courriel relatif à ce bogue ait été envoyé à qui que ce soit. Après avoir établi une liste,
!       il utilise ensuite les règles standard pour déterminer qui recevra le courriel, et
!       l'émet.
      </para>
  
      <para>
!       Lorsque le script s'exécute, il indique le bogue pour lequel il envoie le
!       présent courriel; lorsqu'il a fini, il fournit un total chiffré des
!       courriels envoyés et du nombre de personnes qui en ont été exclues. (Les noms
!       d'utilisateurs personnels ne sont pas enregistrés ni affichés.) Si le script ne produit
!       aucun résultat en sortie, cela signifie qu'aucun courriel non-envoyé n'a été détecté.
      </para>
  
      <para>
!       <emphasis>Mode d'emploi</emphasis>&#160;: faites remonter le sript sendunsentbugmail.pl
!       dans le répertoire principal, assurez vous qu'il possède les droits en exécution et lancez le
!       depuis la ligne de commande (ou depuis un utilitaire de tâches planifiées) sans aucun paramètre.
      </para>
    </section>