<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kfilereplace "<application
>KFileReplace</application
>">
  <!ENTITY kappname "&kfilereplace;"
><!-- Do *not* replace kappname-->
  <!ENTITY package "kdewebdev"
><!-- kdebase, kdeadmin, etc -->
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % French "INCLUDE"
><!-- change language only here -->
  <!ENTITY bc "<application
>bc</application
>">
]>

<book id="kfilereplace" lang="&language;">

<bookinfo>
<title
>Manuel de &kfilereplace;</title>

<authorgroup>
<author
><firstname
>Emiliano</firstname
> <othername
></othername
> <surname
>Gulmini</surname
> <affiliation
> <address
><email
>emi_barbarossa&#64;yahoo&#46;it</email
></address>
</affiliation>
</author>

&traducteurLudovicGrossard; 
</authorgroup>

<copyright>
<year
>2004</year>
<holder
>Emiliano Gulmini</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>16/08/2011</date>
<releaseinfo
>0.1 (&kde; 4.7)</releaseinfo>

<!-- Abstract about this handbook -->

<abstract>
<para
>&kfilereplace; est un utilitaire pour chercher et remplacer des chaînes. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>KFileReplace</keyword>
<keyword
>remplacer</keyword>
<keyword
>chercher</keyword>
<keyword
>chaîne</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
 <title
>Introduction</title>
  <para
>&kfilereplace; est une application utilisée pour chercher et remplacer une liste de chaînes dans une arborescence de fichiers. Les chaînes peuvent être littérales, ou des expressions rationnelles de type &Qt;. Il y a également d'autres options pour affiner votre recherche. </para>
</chapter>

<chapter id="using-kfilereplace">
<title
>Utilisation de &kfilereplace;</title>

<para>
 <screenshot>
  <screeninfo
>&kfilereplace; en mode indépendant</screeninfo>
   <mediaobject>
    <imageobject>
     <imagedata fileref="kfr_standalone_main_window_1.png" format="PNG"/>
    </imageobject>
    <textobject>
     <phrase
>&kfilereplace; en mode indépendant</phrase>
    </textobject>
   </mediaobject>
 </screenshot>
</para>


<sect1 id="kfilereplace-the-toolbar">
<title
>La barre d'outils</title>

<para
>La barre d'outils de &kfilereplace; devrait ressembler à ceci :  <screenshot>
  <screeninfo
>Barre d'outils de &kfilereplace;</screeninfo>
   <mediaobject>
    <imageobject>
     <imagedata fileref="toolbar.png" format="PNG"/>
    </imageobject>
    <textobject>
     <phrase
>Barre d'outils de &kfilereplace;</phrase>
    </textobject>
   </mediaobject>
 </screenshot>
</para>

<para
>La barre d'outils vous montre les boutons des fonctionnalités principales. <variablelist>
  <title
>Icônes de barre d'outils</title>

   <varlistentry>
    <term>
       <inlinemediaobject>
        <imageobject>
         <imagedata fileref="project.png" format="PNG"/>
        </imageobject>
      </inlinemediaobject
><guiicon
>Personnaliser la session de recherche / remplacement</guiicon
></term>
    <listitem>
     <para
>Ce bouton montre une <link linkend="kfilereplace-the-project-dialog"
>boîte de dialogue de session</link
> dans laquelle vous pouvez régler plusieurs options simples. Si &kfilereplace; fonctionne comme application autonome, vous devriez commencer par cliquer sur ce bouton.</para>
    </listitem>
   </varlistentry>

   <varlistentry>
    <term>
     <inlinemediaobject>
       <imageobject>
        <imagedata fileref="filesearch.png" format="PNG"/>
       </imageobject>
     </inlinemediaobject
><guiicon
>Recherche</guiicon
></term>
    <listitem>
      <para
>Ce bouton démarre une boucle de recherche.</para>
    </listitem>
   </varlistentry>

   <varlistentry>
     <term>
      <inlinemediaobject>
       <imageobject>
        <imagedata fileref="filesimulate.png" format="PNG"/>
       </imageobject>
      </inlinemediaobject
><guiicon
>Simuler</guiicon
></term>
     <listitem>
       <para
>Ce bouton démarre une boucle de recherche simulée. Rien ne se passe réellement lorsque vous cliquez sur ce bouton.</para>
     </listitem>
   </varlistentry>

   <varlistentry>
    <term>
     <inlinemediaobject>
      <imageobject>
       <imagedata fileref="filereplace.png" format="PNG"/>
      </imageobject>
     </inlinemediaobject
><guiicon
>Remplacer</guiicon
></term>
    <listitem>
     <para
>Ce bouton démarre une boucle de recherche et de remplacement. Lorsqu'une chaîne est trouvée, &kfilereplace; la remplace par une autre chaîne.</para>
    </listitem>
   </varlistentry>

   <varlistentry>
     <term>
      <inlinemediaobject>
       <imageobject>
        <imagedata fileref="stop.png" format="PNG"/>
       </imageobject>
      </inlinemediaobject
><guiicon
>Arrêter</guiicon
></term>
     <listitem>
       <para
>Ce bouton arrête une opération.</para>
     </listitem>
   </varlistentry>

   <varlistentry>
     <term>
      <inlinemediaobject>
       <imageobject>
        <imagedata fileref="edit_add.png" format="PNG"/>
       </imageobject>
      </inlinemediaobject
><guiicon
>Ajouter une chaîne</guiicon
></term>
     <listitem>
       <para
>Ce bouton ouvre la boîte de dialogue <link linkend="kfilereplace-the-add-dialog"
>Insérer des chaînes de recherche / remplacement</link
> dans laquelle vous pouvez modifier votre liste de chaînes.</para>
     </listitem>
   </varlistentry>

   <varlistentry>
     <term>
      <inlinemediaobject>
       <imageobject>
        <imagedata fileref="edit_remove.png" format="PNG"/>
       </imageobject>
      </inlinemediaobject
><guiicon
>Effacer la chaîne</guiicon
></term>
     <listitem>
       <para
>Ce bouton efface de la liste la chaîne sélectionnée (ou l'actuelle s'il n'y a pas de sélection).</para>
     </listitem>
   </varlistentry>

   <varlistentry>
     <term>
           <inlinemediaobject>
             <imageobject>
               <imagedata fileref="edit.png" format="PNG"/>
             </imageobject>
           </inlinemediaobject
><guiicon
>Modifier la chaîne sélectionnée</guiicon
></term>
     <listitem>
       <para
>Ce bouton modifie la chaîne sélectionnée.</para>
     </listitem>
   </varlistentry>

   <varlistentry>
     <term>
      <inlinemediaobject>
       <imageobject>
        <imagedata fileref="eraser.png" format="PNG"/>
       </imageobject>
      </inlinemediaobject
><guiicon
>Vider la liste des chaînes</guiicon
></term>
     <listitem>
       <para
>Ce bouton supprime toutes les chaînes de la liste.</para>
     </listitem>
   </varlistentry>

   <varlistentry>
     <term>
      <inlinemediaobject>
       <imageobject>
        <imagedata fileref="invert.png" format="PNG"/>
       </imageobject>
      </inlinemediaobject
><guiicon
>Inverser la chaîne actuelle</guiicon
></term>
     <listitem>
       <para
>Ce bouton permute la chaîne cherchée avec la chaîne de remplacement, afin que vous puissiez annuler une opération de recherche et remplacement.</para>
     </listitem>
   </varlistentry>

   <varlistentry>
     <term>
      <inlinemediaobject>
       <imageobject>
        <imagedata fileref="unsortedList.png" format="PNG"/>
       </imageobject>
      </inlinemediaobject
><guiicon
>Charger la liste des chaînes à partir d'un fichier</guiicon
></term>
     <listitem>
       <para
>Ce bouton charge une <link linkend="kfilereplace-the-kfr-file"
>liste de chaînes</link
> enregistrée dans un fichier xml avec une extension <literal role="extension"
>kfr</literal
>.</para>
     </listitem>
   </varlistentry>

   <varlistentry>
     <term>
      <inlinemediaobject>
       <imageobject>
        <imagedata fileref="recursive_option.png" format="PNG"/>
       </imageobject>
      </inlinemediaobject
><guiicon
>Inclure les sous-dossiers</guiicon
></term>
     <listitem>
       <para
>Ce bouton vous permet de chercher / remplacer dans les sous-dossier de votre dossier de base.</para>
     </listitem>
   </varlistentry>

   <varlistentry>
     <term>
      <inlinemediaobject>
       <imageobject>
        <imagedata fileref="backup_option.png" format="PNG"/>
       </imageobject>
      </inlinemediaobject
><guiicon
>Créer des fichiers de sauvegarde</guiicon
></term>
     <listitem>
       <para
>Ce bouton permet la génération de fichiers de <link linkend="kfilereplace-backup-file"
>sauvegarde</link
>.</para>
     </listitem>
   </varlistentry>

   <varlistentry>
     <term>
      <inlinemediaobject>
       <imageobject>
        <imagedata fileref="casesensitive_option.png" format="PNG"/>
       </imageobject>
      </inlinemediaobject
><guiicon
>Tenir compte de la casse</guiicon
></term>
     <listitem>
       <para
>Ce bouton active la recherche sensible à la casse.</para>
     </listitem>
   </varlistentry>

   <varlistentry>
     <term>
      <inlinemediaobject>
       <imageobject>
        <imagedata fileref="command_option.png" format="PNG"/>
       </imageobject>
      </inlinemediaobject
><guiicon
>Activer les commandes dans la chaîne de remplacement</guiicon
></term>
     <listitem>
       <para
>Ce bouton active les commandes. Les commandes sont des chaînes spéciales. voyez <xref linkend="kfilereplace-commands"/>.</para>
     </listitem>
   </varlistentry>

   <varlistentry>
     <term>
      <inlinemediaobject>
       <imageobject>
        <imagedata fileref="regularexpression_option.png" format="PNG"/>
       </imageobject>
      </inlinemediaobject
><guiicon
>Activer les expressions rationnelles</guiicon
></term>
     <listitem>
       <para
>Ce bouton active les <link linkend="kfilereplace-QT-regexp"
>expressions rationnelles dans le style &Qt;</link
>.</para>
     </listitem>
   </varlistentry>

</variablelist>
</para>

</sect1>

<sect1 id="kfilereplace-the-results-view">
  <title
>La liste des résultats</title>
    <screenshot>
      <screeninfo
>Affichage des résultats de &kfilereplace;</screeninfo>
      <mediaobject>
        <imageobject>
          <imagedata fileref="results_view.png" format="PNG"/>
        </imageobject>
        <imageobject>
          <imagedata fileref="results_view.eps" format="EPS"/>
        </imageobject>
        <textobject>
          <phrase
>Affichage des résultats de &kfilereplace;</phrase>
        </textobject>
      </mediaobject>
    </screenshot>
  <para
>La vue des résultats affiche le nom des fichiers qui contiennent les chaînes que vous deviez trouver (et remplacer), leur emplacement, leur taille, le nombre de chaînes trouvées et l'identificateur de l'utilisateur des fichiers. La vue fournit également la position exacte de chaque correspondance. Vous pouvez également ouvrir un fichier en cliquant dessus avec le bouton droit de la souris sur un élément de la liste qui contient une position de ligne et de colonne.</para>

</sect1>

<sect1 id="kfilereplace-the-strings-view">
  <title
>La liste des chaînes</title>

  <para
>Ceci est la vus des chaînes : <screenshot>
      <screeninfo
>Vue des chaînes de &kfilereplace;</screeninfo>
      <mediaobject>
        <imageobject>
          <imagedata fileref="strings_view.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase
>Vue des chaînes de &kfilereplace;</phrase>
        </textobject>
      </mediaobject>
    </screenshot>
  </para>

  <para
>La vue des chaînes affiche la liste des chaînes que vous souhaitez chercher / remplacer. Notez qu'en mode recherche, la vue des résultats et la vue des chaînes ont des dispositions différentes.</para>

</sect1>

<sect1 id="kfilereplace-the-project-dialog">
 <title
>La boîte de dialogue « Trouver &amp; Remplacer dans des fichiers »</title>
 <para
>La boîte de dialogue « Trouver &amp; Remplacer dans des fichiers » est utilisée pour configurer les paramètres de base nécessaire au fonctionnement de &kfilereplace;. Elle est constituée de deux onglets, <guilabel
>Général</guilabel
> et <guilabel
>Avancé</guilabel
>. </para>
 
 <sect2 id="kfilereplace-the-project-dialog-general-page">
   <title
>L'onglet Général</title>
    <screenshot>
     <screeninfo
>L'onglet Général de &kfilereplace;</screeninfo>
     <mediaobject>
      <imageobject>
       <imagedata fileref="projectdialog_main_window_1.png" format="PNG"/>
      </imageobject>
      <textobject>
       <phrase
>L'onglet Général de &kfilereplace;</phrase>
      </textobject>
     </mediaobject>
    </screenshot>
   <para
>Lorsque vous souhaitez commencer une nouvelle session, la première étape consiste à cliquer sur le bouton <link linkend="kfilereplace-the-toolbar"
><guiicon
>Personnaliser la session de recherche / remplacement</guiicon
></link
>. Vous devez alors saisir l'emplacement de base et une séquence de caractères de remplacement (<foreignphrase
>wildcards</foreignphrase
>) de type shell.</para>
   <para
>Vous pouvez alors régler quelques options utiles, comme chercher dans les sous-dossiers, faire une recherche sensible à la casse, activer les commandes et / ou les expressions rationnelles<footnote id="performancewarning"
><para
>Notez que les expressions rationnelles et les commandes peuvent diminuer les performances</para
></footnote
>, faire des copies de sauvegarde de chaque fichier avant de remplacer.</para>
   <para
>Si vous souhaitez commencer à chercher, vous pouvez mettre une chaîne dans la boîte de recherche et appuyer sur <guibutton
>Rechercher maintenant</guibutton
>, sinon, laissez la boîte vide et appuyez sur <guibutton
>Rechercher plus tard</guibutton
>.</para>
 </sect2>

 <sect2 id="kfilereplace-the-project-dialog-advanced-page">
   <title
>L'onglet Avancé</title>
     <screenshot>
       <screeninfo
>L'onglet Avancé de &kfilereplace;</screeninfo>
       <mediaobject>
         <imageobject>
           <imagedata fileref="projectdialog_main_window_2.png" format="PNG"/>
         </imageobject>
         <textobject>
           <phrase
>L'onglet Avancé de &kfilereplace;</phrase>
         </textobject>
       </mediaobject>
     </screenshot>
   <para
>L'onglet <guilabel
>Avancé</guilabel
> vous permet de configurer certaines options utiles pour restreindre la recherche à un sous-ensemble de votre arborescence de fichiers cible. Si vous ne souhaitez lancer &kfilereplace; que sur des fichiers dont la taille est comprise entre 10 kio et 100 kio, alors vous pouvez utiliser les options de taille. Il y a également une option sur la date qui restreint la recherche dans un domaine temporel. Une dernière option vous permet de chercher lis fichiers appartenant (ou n'appartenant pas) à un utilisateur particulier (ceci est peut-être plus utile pour les administrateurs système).</para>
 </sect2>
</sect1>

<sect1 id="kfilereplace-the-options-dialog">
 <title
>La boîte de dialogue des options</title>
 <para
>Cette boîte de dialogue contient les options qui se trouvent dans la barre d'outils et des options supplémentaires qui sont utiles dans certaines situations. Vous pouvez les appeler en choisissant <menuchoice
><guimenu
>Configuration</guimenu
><guimenuitem
>Configurer KFileReplace...</guimenuitem
></menuchoice
> dans le menu principal. </para>
 <sect2 id="kfilereplace-the-options-dialog-general-page">
  <title
>Options générales</title>
  <para
>Ces options ont été présentées dans la section <link linkend="kfilereplace-the-toolbar"
>Barre d'outils</link
>. <screenshot>
       <screeninfo
>L'onglet Général de la fenêtre des options</screeninfo>
       <mediaobject>
         <imageobject>
           <imagedata fileref="optionsdialog_main_window_1.png" format="PNG"/>
         </imageobject>
         <textobject>
           <phrase
>L'onglet Général de la fenêtre des options</phrase>
         </textobject>
       </mediaobject>
     </screenshot>
  </para>
 </sect2>
 <sect2 id="kfilereplace-the-options-dialog-advanced-page">
  <title
>Options avancées</title>
  <para>
    <screenshot>
      <screeninfo
>L'onglet Avancé de la fenêtre des options</screeninfo>
      <mediaobject>
	<imageobject>
	  <imagedata fileref="optionsdialog_main_window_2.png" format="PNG"/>
	</imageobject>
	<textobject>
	  <phrase
>L'onglet Avancé de la fenêtre des options</phrase>
	</textobject>
      </mediaobject>
     </screenshot>
     <segmentedlist>
       <segtitle
>Ne pas afficher un fichier si aucune chaîne y est remplacée ou trouvée</segtitle>
       <segtitle
>Lors de la recherche, s'arrêter lorsque la première chaîne est trouvée</segtitle>
       <segtitle
>Suivre les liens symboliques</segtitle>
       <segtitle
>Ignorer les fichiers et dossiers cachés</segtitle>
       <seglistitem>
	 <seg
>n'affiche que les fichiers qui correspondent à certaines de vos chaînes. Ceci va accélérer la recherche</seg>
	 <seg
>&kfilereplace; s'arrêtera lorsqu'une chaîne est trouvée, et continuera à chercher d'autres chaînes, ou, si vous ne cherchez qu'une chaîne, il continuera avec le fichier suivant.</seg>
	 <seg
>Si un fichier est un lien vers un autre fichier, alors la recherche s'effectue sur le fichier réel.</seg>
	 <seg
>Si des fichiers ou des dossiers cachés sont rencontrés, ils seront ignorés.</seg>
       </seglistitem>
   </segmentedlist>
  </para>
 </sect2>
</sect1>
<sect1 id="kfilereplace-the-add-dialog">
 <title
>La boîte de dialogue « Insérer des chaînes de recherche / remplacement »</title>
    <screenshot>
      <screeninfo
>La boîte de dialogue « Insérer des chaînes de recherche / remplacement » de &kfilereplace;</screeninfo>
      <mediaobject>
	<imageobject>
	  <imagedata fileref="addstringsdialog_window.png" format="PNG"/>
	</imageobject>
	<textobject>
	  <phrase
>La boîte de dialogue « Insérer des chaînes de recherche / remplacement » de &kfilereplace;</phrase>
	</textobject>
      </mediaobject>
     </screenshot>
   <para
>Cette boîte de dialogue est utilisée pour insérer et modifier une liste de chaînes. Vous avez juste à insérer soit une liste de recherche uniquement, soit une liste de recherche / remplacement, puis, avec les deux mini-éditeurs, saisir votre texte. Les boutons fléchés vous permettent d'ajouter ou de supprimer des paires de chaînes. Lorsque vous avez terminé, cliquez sur <guibutton
>Ok</guibutton
>.</para>
</sect1>
</chapter>

<chapter id="kfilereplace-features">
 <title
>Caractéristiques de &kfilereplace;</title>
 <para
>Ce chapitre décrit quelques caractéristiques utiles de &kfilereplace;.</para>
 <sect1 id="kfilereplace-the-kfr-file">
  <title
>Comment enregistrer votre liste de chaînes</title>
  <para
>Lorsque vous souhaitez réutiliser une liste de chaînes, vous pouvez l'enregistrer dans un fichier <literal role="extension"
>xml</literal
>. Pour ceci, choisissez <menuchoice
><guimenu
>Chercher / Remplacer</guimenu
><guisubmenu
>Chaîne</guisubmenu
> <guimenuitem
>Enregistrer la liste des chaînes dans un fichier</guimenuitem
></menuchoice
> dans la barre de menus. Lorsque vous enregistrez une liste, un simple fichier <literal role="extension"
>xml</literal
> avec l'extension <literal role="extension"
>kfr</literal
> est créé. Pour charger un fichier <literal role="extension"
>kfr</literal
>, choisissez <menuchoice
><guimenu
>Chercher / Remplacer</guimenu
><guisubmenu
>Chaîne</guisubmenu
> <guimenuitem
>Charger la liste des chaînes à partir d'un fichier</guimenuitem
></menuchoice
> dans la barre de menus. Le fichier réel ressemble à ceci : </para>
  <screen
>&lt;?xml version="1.0" ?>
&lt;kfr>
        &lt;mode search="false"/>
        &lt;replacement>
                &lt;oldstring
>&lt;![CDATA[SEARCH_STRING_1]&#93; 
>&lt;/oldstring>
                &lt;newstring
>&lt;![CDATA[REPLACE_STRING_1]&#93;
>&lt;/newstring>
        &lt;/replacement>
        &lt;replacement>
                &lt;oldstring
>&lt;![CDATA[SEARCH_STRING_2]&#93;
>&lt;/oldstring>
                &lt;newstring
>&lt;![CDATA[REPLACE_STRING_2]&#93;
>&lt;/newstring>
        &lt;/replacement>
        
        
        &lt;replacement>
                &lt;oldstring
>&lt;![CDATA[SEARCH_STRING_N]&#93;
>&lt;/oldstring>
                &lt;newstring
>&lt;![CDATA[REPLACE_STRING_N]&#93;
>&lt;/newstring>
        &lt;/replacement>
        
&lt;/kfr
></screen>
  
  <para
>Si vous utilisez un format précédent, vous pouvez mettre à jour manuellement votre fichier simplement en le modifiant en suivant le schéma ci-dessus. Vous pouvez également le charger le fichier écrit dans l'ancien format et l'enregistrer de nouveau avec &kfilereplace; de la façon expliquée précédemment.</para>
</sect1>

<sect1 id="kfilereplace-the-report-file">
  <title
>Comment créer un rapport simple</title>
  <para
>Vous pouvez créer un rapport en choisissant <menuchoice
><guimenu
>Chercher / Remplacer</guimenu
> <guisubmenu
>Résultats</guisubmenu
><guimenuitem
>Créer un fichier de rapport</guimenuitem
></menuchoice
> depuis le menu principal. Un rapport est un dossier contenant un fichier <literal role="extension"
>xml</literal
> et un fichier <literal role="extension"
>css</literal
>. Les rapports peuvent être utiles pour maintenir un journal simple de vos opérations.  <screenshot>
      <screeninfo
>Les rapports de &kfilereplace;</screeninfo>
      <mediaobject>
	<imageobject>
	  <imagedata fileref="report_example.png" format="PNG"/>
	</imageobject>
	<imageobject>
	  <imagedata fileref="report_example.eps" format="EPS"/>
	</imageobject>
	<textobject>
	  <phrase
>Les rapports de &kfilereplace;</phrase>
	</textobject>
      </mediaobject>
    </screenshot>
  </para>
</sect1>

<sect1 id="kfilereplace-QT-regexp">
 <title
>Utilisation des expressions rationnelles</title>
  <para
>Si vous souhaitez chercher toutes les chaînes qui commencent par <quote
>x</quote
>, <quote
>ht</quote
> ou <quote
>u</quote
>, et qui se terminent par <quote
>ml</quote
>, vous pouvez utiliser une expression rationnelle comme ceci : <userinput
>(x|ht|u)ml</userinput
>. Insérez cette expression dans l'éditeur, cliquez sur <guibutton
>Ok</guibutton
>, et activez les expressions rationnelles en appuyant sur le <link linkend="kfilereplace-the-toolbar"
>bouton <guibutton
>Expressions rationnelles</guibutton
></link
>. Veuillez noter que l'utilisation des expressions rationnelles vous permettent de faire des recherches très compliquées, mais au prix d'une dégradation des performances. Les expressions rationnelles peuvent être très difficiles, et il est souvent vrai que <quote
>si vous souhaitez résoudre un problème, avec une expression rationnelle, alors vous avez deux problèmes</quote
>.</para>
</sect1>

<sect1 id="kfilereplace-backup-file">
  <title
>Protéger les fichiers d'origine</title>
  <para
>Si vous ne souhaitez pas perdre vos fichiers originaux, vous pouvez en faire une copie avant de remplacer les chaînes. Après avoir inséré les chaînes, et avant de commencer le processus de remplacement, vous devez basculer le <link linkend="kfilereplace-the-toolbar"
>bouton <guiicon
>Créer des fichiers de sauvegarde</guiicon
></link
>. Si vous voulez personnaliser l'extension des fichiers de sauvegarde, ouvrez la <link linkend="kfilereplace-the-options-dialog"
>boîte de dialogue des <guilabel
>options</guilabel
></link
> </para>
</sect1>

<sect1 id="kfilereplace-open-file">
  <title
>Comment ouvrir un fichier ? </title>
  <para
>si vous voulez ouvrir un fichier qui correspond à une ou plusieurs de vos chaînes, vous devez choisir une ligne dans la vue des résultats et cliquer dessus avec le bouton droit de la souris. Un menu contextuel apparaîtra, dans lequel vous pouvez ouvrir le fichier.</para>
</sect1>

<sect1 id="kfilereplace-commands">
 <title
>Commandes</title>
  <para
>Supposons que vous souhaitiez remplacer la phrase <quote
>Alice au pays des merveilles</quote
> par le <ulink url="http://www.textlibrary.com/download/alice-wo.txt"
>fichier entier qui contient la nouvelle de Carroll</ulink
>. Vous ne souhaitez probablement pas le faire à la main. Ce dont vous avez besoin est une commande qui le fasse à votre place. Cliquez sur le bouton <link linkend="kfilereplace-the-toolbar"
><guiicon
>Ajouter</guiicon
></link
>, choisissez <guilabel
>Mode recherche et remplacement</guilabel
> et insérez la chaîne suivante : <userinput
>Alice au pays des merveilles</userinput
> dans la zone de recherche et la chaîne <userinput
>[$loadfile:<replaceable
>/emplacement/de/mon/dossier/mon-fichier</replaceable
>$]</userinput
> dans la zone de remplacement. Cliquez sur <guibutton
>Ok</guibutton
>. Lorsque vous revenez dans la fenêtre principale de &kfilereplace;, activez le bouton <link linkend="kfilereplace-the-toolbar"
>Activer les variables dans les chaînes de remplacements</link
>, qui active les commandes, et démarrez le processus de remplacement. Il y a également d'autres commandes. Voyez <xref linkend="available-commands"/></para>
</sect1>
</chapter>

<chapter id="credits">
<title
>Remerciements et licence</title>

<para
>&kfilereplace;. Programme sous copyright 1999 par François Dupoux <email
>dupoux&#64;dupoux&#46;com</email
>, 2003 Andras Mantia <email
>amantia&#64;kde&#46;org</email
>, 2004 Emiliano Gulmini <email
>emi_barbarossa&#64;yahoo&#46;it</email
> </para>

<variablelist>
  <title
>Les auteurs et mainteneurs de &kfilereplace;</title>
  <varlistentry>
    <term
>François Dupoux <email
>dupoux&#64;dupoux&#46;com</email
></term>
    <listitem
><para
>Auteur Original</para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
>Andras Mantia <email
>amantia&#64;kde&#46;org</email
></term>
    <listitem
><para
>Auteur de la ligne de commande, créateur du module KPart, Co-mainteneur</para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
>Emiliano Gulmini <email
>emi_barbarossa&#64;yahoo&#46;it</email
></term>
    <listitem
><para
>Mainteneur actuel, nettoyeur et rédacteur de code</para
></listitem>
  </varlistentry>
</variablelist>

<para
>Documentation sous copyright 2004 Emiliano Gulmini <email
>emi_barbarossa&#64;yahoo&#46;it</email
> </para>

<para
>Traduction française par &LudovicGrossard;.</para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Compilation et installation</title>

&install.intro.documentation;

&install.compile.documentation;

<sect1 id="requirements">
 <title
>Prérequis</title>
  <para
>Afin d'utiliser la commande <link linkend="available-commands"
>[$mathexp:<replaceable
>expression_mathématique</replaceable
>$]</link
>, vous devez installer l'outil mathématique &bc; (version 1.06 ou plus récente) écrit par Philip A. Nelson (<email
>philnelson@acm.org</email
>).</para>
</sect1>

</appendix>

<appendix id="available-commands">
 <title
>Les commandes de &kfilereplace;</title>
 <para>
   <segmentedlist>
     <segtitle
>[$datetime:iso$]</segtitle>
     <segtitle
>[$datetime:local$]</segtitle>
     <segtitle
>[$user:uid$]</segtitle>
     <segtitle
>[$user:gid$]</segtitle>
     <segtitle
>[$user:loginname$]</segtitle>
     <segtitle
>[$user:fullname$]</segtitle>
     <segtitle
>[$user:homedir$]</segtitle>
     <segtitle
>[$user:shell$]</segtitle>
     <segtitle
>[$loadfile:<replaceable
>/mom-emplacement/mon-dossier/mon-fichier</replaceable
>$]</segtitle>
     <segtitle
>[$empty:$]</segtitle>
     <segtitle
>[$random:<replaceable
>UN_NOMBRE_ENTIER</replaceable
>$]</segtitle>
     <segtitle
>[$random:$]</segtitle>
     <segtitle
>[$mathexp:<replaceable
>bc-expression</replaceable
>$]</segtitle>
     <seglistitem>
       <seg
>Cette commande renvoie la date et l'heure actuelles au format ISO &Qt;.</seg>
       <seg
>comme ci-dessus, mais au format local.</seg>
       <seg
>renvoie l'UID de l'utilisateur actuel.</seg>
       <seg
>renvoie le GID de l'utilisateur actuel.</seg>
       <seg
>renvoie l'identifiant de l'utilisateur actuel.</seg>
       <seg
>renvoie le nom complet de l'utilisateur actuel.</seg>
       <seg
>renvoie le dossier personnel de l'utilisateur actuel.</seg>
       <seg
>renvoie le shell de l'utilisateur actuel.</seg>
       <seg
>renvoie le contenu lu fichier <emphasis
>mon-fichier</emphasis
>.</seg>
       <seg
>renvoie une chaîne vide.</seg>
       <seg
>renvoie une chaîne contenant des nombres aléatoires un utilisant <emphasis
>UN_NOMBRE_ENTIER</emphasis
> comme graine initiale.</seg>
       <seg
>comme ci-dessus, mais sans graine initiale.</seg>
       <seg
>renvoie le résultat d'une expression mathématique &bc; v1.06</seg>
     </seglistitem>
   </segmentedlist>
 </para>
</appendix>

&documentation.index;
</book>

