<?xml version="1.0" encoding="UTF-8"?>
<!--
        User Manual for Gramps - a GTK+/GNOME based genealogy program
        Copyright (C) 2003  Alexander Roitman
        Permission is granted to copy, distribute and/or modify this
        document under the terms of the GNU Free Documentation
        License (GFDL), Version 1.1 or any later version published
        by the Free Software Foundation with no Invariant Sections,
        no Front-Cover Texts, and no Back-Cover Texts.
          A copy of the license is included in the file COPYING-DOCS
          distributed with this manual.
-->
<!-- $Id$ -->
      <!-- =============== Appendices Subsection ================ -->
      <sect2 id="append-filtref">
      <title>Documentation de référence sur les règles de filtrage</title>
      <para>Cette annexe décrit les fonctions de filtrage actuellement définies
      dans &app;. Ces règles sont disponibles quand vous créez des filtres
      personnalisés. Elles sont ici présentées par catégories. 
      </para>

        <!-- =============== Appendices Sub-subsection ================ -->
    	<sect3 id="filtref-general">
        <title>Filtres généraux</title>
        <para>Cette catégorie comprend les fonctions les plus générales : </para>
        
          <variablelist>

          <varlistentry><term>A un enregistrement complet</term>
          <listitem><para> Cette règle accepte toutes les personnes
	  dont l'enregistrement est marqué comme complet. Pour le moment,
	  la complétude de l'enregistrement est marquée par le chercheur
	  dans le dialogue <guilabel>Modifie Personne</guilabel>. 
          </para></listitem>
          </varlistentry>

          <varlistentry><term>Tout le monde</term>
          <listitem><para> Cette fonction accepte toutes les personnes de la base de données. 
          Elle n'est pas très utile seule sauf pour tester. Par contre, elle
	  sert en combinaison avec d'autres fonctions. 
          </para></listitem>
          </varlistentry>

          <varlistentry><term>Noms qui contiennent une chaîne</term>
          <listitem><para> Cette fonction sélectionne toutes les personnes
	  dont l'identité contient la chaîne donnée. Par exemple, 
	  Jacques Dupont, Jean Dupond et seront sélectionnés par cette
	  fonction, utilisée avec la valeur "pon". 
          </para>

          <para> Des chaînes séparées peuvent être utilisées pour
	  le prénom, le nom de famille, le suffixe et le titre.
	  La fonction sélectionne un individu quand toutes les chaînes
	  non vides font partie du nom d'une personne. Si vous voulez
	  utiliser une seule valeur, laissez les autres vides.
          </para></listitem>
          </varlistentry>

          <varlistentry><term>A l'identifiant</term>
          <listitem><para> Cette fonction sélectionne la personne ayant
	  exactement l'identifiant &app; donné. 
          </para>

          <para> Vous pouvez entrer l'identifiant dans un champ texte,
	  ou bien sélectionner une personne dans la liste en cliquant le bouton
          <guibutton>Select...</guibutton>. Dans ce cas, l'identifiant apparaîtra
	  dans le champ de saisie de texte après la sélection. 
          </para></listitem>
          </varlistentry>

          <varlistentry><term>Est une femme</term>
          <listitem><para> Cette fonction sélectionne les femmes.
          </para></listitem>
          </varlistentry>

          <varlistentry><term>Est un homme</term>
          <listitem><para> Ce filtre sélectionne les hommes.
          </para></listitem>
          </varlistentry>

          </variablelist>

        </sect3>

        <!-- =============== Appendices Sub-subsection ================ -->
    	<sect3 id="filtref-event">
        <title>Fonctions sur évènements</title>
        <para>Cette catégorie regroupe les fonctions qui utilisent les évènements des personnes : </para>
          <variablelist>

          <varlistentry><term>A la naissance</term>
          <listitem><para>Cette fonction sélectionne les personnes dont
          la naissance correspond aux valeurs données pour Date, Lieu, et Description.
	  La correspondance est faite même quand l'évènement n'est que partiellement
	  identique. Les correspondances sont insensibles à la casse des caractères.
	  Par exemple, toute personne née en France sera sélectionnée par
	  la valeur "fr" pour le lieu.
          </para>

          <para> La règle sélectionne l'entrée si et seulement si toutes les
	  valeurs non vides correspondent (partiellement) à la naissance
	  de la personne. Si vous voulez sélectionner sur un seul champ,
	  laissez les autres champs vides.
          </para></listitem>
          </varlistentry>

          <varlistentry><term>A le décès</term>
          <listitem><para>Cette fonction sélectionne les personnes dont
          le décès correspond aux valeurs données pour Date, Lieu, et Description.
	  La correspondance est faite même quand l'évènement n'est que partiellement
	  identique. Les correspondances sont insensibles à la casse des caractères.
	  Par exemple, toute personne décédée en France sera sélectionnée par
	  la valeur "fr" pour le lieu.
          </para>

          <para> La règle sélectionne l'entrée si et seulement si toutes les
	  valeurs non vides correspondent (partiellement) à la naissance
	  de la personne. Si vous voulez sélectionner sur un seul champ,
	  laissez les autres champs vides.
          </para></listitem>
          </varlistentry>

          <varlistentry><term>A l'évènement personnel</term>
          <listitem><para>Cette fonction sélectionne les personnes dont
          un évènement personnel correspond aux valeurs données pour Date, Lieu, Type et Description.
	  La correspondance est faite même quand l'évènement n'est que partiellement
	  identique. Les correspondances sont insensibles à la casse des caractères.
	  Par exemple, toute personne ayant obtenu un diplômee en France sera sélectionnée par
	  la valeur "fr" pour le lieu.
          </para>

          <para> L'évènement personnel est sélectionné dans une liste déroulante.
	  La règle sélectionne l'entrée si et seulement si toutes les
	  valeurs non vides correspondent (partiellement) à un évènement
	  de la personne. Si vous voulez sélectionner sur un seul champ,
	  laissez les autres champs vides.
          </para></listitem>
          </varlistentry>

          <varlistentry><term>A l'évènement familial</term>
          <listitem><para>Cette fonction sélectionne les personnes dont
          un évènement familial correspond aux valeurs données pour Date, Lieu, Type et Description.
	  La correspondance est faite même quand l'évènement n'est que partiellement
	  identique. Les correspondances sont insensibles à la casse des caractères.
	  Par exemple, toute personne s'étant mariée en France sera sélectionnée par
	  la valeur Mariage pour l'évènement et "fr" pour le lieu.
          </para>

          <para> L'évènement familial est sélectionné dans une liste déroulante.
	  La règle sélectionne l'entrée si et seulement si toutes les
	  valeurs non vides correspondent (partiellement) à un évènement
	  de la famille de la personne. Si vous voulez sélectionner sur un seul champ,
	  laissez les autres champs vides.
          </para></listitem>
          </varlistentry>
          </variablelist>
	</sect3>

        <!-- =============== Appendices Sub-subsection ================ -->
    	<sect3 id="filtref-family">
        <title>Filtres Familiaux</title>
        <para>Cette catégorie comprend les règles suivantes qui sélectionnent
	les personnes d'après leurs relations familiales : </para>
          <variablelist>

          <varlistentry><term>A les relations</term>
          <listitem><para> Cette règle sélectionne les personnes
	  possédant un type de relation, sélectionné dans le menu.
	  On peut spécifier le nombre de relations et d'enfants en option.
          </para>

          <para> La règle sélectionne l'entrée si et seulement si toutes les
	  valeurs non vides correspondent (partiellement) à un évènement
	  de la famille de la personne. Si vous voulez sélectionner sur un seul champ,
	  laissez les autres champs vides.
          </para></listitem>
          </varlistentry>

          <varlistentry><term>Est l'époux(se) d'un individu résultant du filtrage</term>
          <listitem><para> Cette règle sélectionne les personnes mariées
	  à une personne choisie par un filtre.
	  Le filtre est choisi par son nom dans un menu.
          </para></listitem>
          </varlistentry>

          <varlistentry><term>Est l'enfant d'un individu résultant du filtrage</term>
          <listitem><para> Cette règle sélectionne les personnes enfant
	  d'une personne choisie par un filtre.
	  Le filtre est choisi par son nom dans un menu.
          </para></listitem>
          </varlistentry>

          <varlistentry><term>Est le parent d'un individu résultant du filtrage</term>
          <listitem><para> Cette règle sélectionne les personnes parentes
	  (père ou mère) d'une personne choisie par un filtre.
	  Le filtre est choisi par son nom dans un menu.
          </para></listitem>
          </varlistentry>

          </variablelist>
        </sect3> 

        <!-- =============== Appendices Sub-subsection ================ -->
    	<sect3 id="filtref-ancestral">
        <title>Filtres ascendants</title>
        <para>Cette catégorie comprend les règles suivantes qui sélectionnent
	les personnes d'après leurs relations d'ascendance avec d'autres personnes : </para>
          <variablelist>

          <varlistentry><term>Est l'ancêtre de</term>
          <listitem><para>Cette règle sélectionne les personnes ancêtres
	  de la personne désignée. L'option Inclusif précise
	  si la personne désignée est à considérer comme ancêtre
	  d'elle-même, ce qui est utile pour construire des éditions.
          </para>

          <para> Vous pouvez soit saisir l'identifiant dans une zone de saisie,
	  soit sélectionner une personne dans la liste en cochant le bouton
          <guibutton>Sélectionner...</guibutton>. Dans ce cas, son identifiant
	  apparaîtra dans la zone de saisie après la sélection.
          </para></listitem>
          </varlistentry>

          <varlistentry><term>Est l'ascendant d'un individu sur au moins N générations</term>
          <listitem><para>Cette règle sélectionne les personnes ancêtres
	  de la personne désignée à au moins N générations d'écart.
	  Par exemple, un écart de 2 sélectionnera les grands-parents, les
	  arrière-grands-parents..., mais pas les parents de la personnes
	  désignée.
          </para></listitem>
          </varlistentry>

          <varlistentry><term>Est l'ascendant d'un individu sur moins de N générations</term>
          <listitem><para>Cette règle sélectionne les personnes ancêtres
	  de la personne désignée à au plus N générations d'écart.
	  Par exemple, un écart de 2 sélectionnera les parents et les grands-parents,
	  mais pas les arrière-grands-parents... de la personnes
	  désignée.
          </para></listitem>
          </varlistentry>

          <varlistentry><term>A un ancêtre commun avec</term>
          <listitem><para> Cette règle sélectionne les personnes qui ont un ancêtre
	  commun avec la personne désignée.
          </para></listitem>
          </varlistentry>

          <varlistentry><term>A un ascendant commun avec les individus résultant du filtrage</term>
          <listitem><para> Cette règle sélectionne les personnes qui ont un ancêtre
	  commun avec les personnes sélectionnées par un filtre.
	  Le filtre est choisi par son nom dans un menu.
          </para></listitem>
          </varlistentry>

          <varlistentry><term>Est l'ascendant d'un individu résultant du filtrage</term>
          <listitem><para> Cette règle sélectionne les personnes qui sont ancêtres
	  d'une des personnes sélectionnées par un filtre.
	  Le filtre est choisi par son nom dans un menu.
	  </para></listitem>
          </varlistentry>

          </variablelist>
        </sect3>

        <!-- =============== Appendices Sub-subsection ================ -->
    	<sect3 id="filtref-descendant">
        <title>Filtres des Descendants</title>
        <para>Cette catégorie comprend les règles suivantes qui sélectionnent
	les personnes d'après leurs relations de descendance avec d'autres personnes : </para>
          <variablelist>

          <varlistentry><term>Est descendant(e) de</term>
          <listitem><para>Cette règle sélectionne les personnes qui descendent
	  de la personne désignée. L'option Inclusif précise
	  si la personne désignée est à considérer comme descendant
	  d'elle-même, ce qui est utile pour construire des éditions.
          </para>

          <para> Vous pouvez soit saisir l'identifiant dans une zone de saisie,
	  soit sélectionner une personne dans la liste en cochant le bouton
          <guibutton>Sélectionner...</guibutton>. Dans ce cas, son identifiant
	  apparaîtra dans la zone de saisie après la sélection.
          </para></listitem>
          </varlistentry>

          <varlistentry><term>Est descendant d'un individu sur au moins N générations</term>
          <listitem><para>Cette règle sélectionne les personnes qui descendent
	  de la personne désignée à au moins N générations d'écart.
	  Par exemple, un écart de 2 sélectionnera les petits-enfants, les
	  arrière-petits-enfants..., mais pas les enfants de la personnes
	  désignée.
          </para></listitem>
          </varlistentry>

          <varlistentry><term>Est descendant d'un individu sur moins de N générations</term>
          <listitem><para>Cette règle sélectionne les personnes qui descendent
	  de la personne désignée à au plus N générations d'écart.
	  Par exemple, un écart de 2 sélectionnera les enfants et les petits-enfants,
	  mais pas les arrière-petits-enfants... de la personnes
	  désignée.
          </para></listitem>
          </varlistentry>

          <varlistentry><term>Est descendant d'un individu résultant du filtrage</term>
          <listitem><para> Cette règle sélectionne les personnes qui descendent
	  d'une des personnes sélectionnées par un filtre.
	  Le filtre est choisi par son nom dans un menu.
	  </para></listitem>
          </varlistentry>

          <varlistentry><term>Est un membre de la famille descendante de</term>
          <listitem><para> Cette règle sélectione en plus des descendants directs
	  de la personne désignée, ceux des époux(ses) des descendants directs.
          </para></listitem>
          </varlistentry>

          </variablelist>
        </sect3> 

        <!-- =============== Appendices Sub-subsection ================ -->
        <sect3 id="filtref-relat">
        <title>Filtres relationnels</title>
        <para>Cette catégorie comprend les règles suivantes qui sélectionnent
	les personnes d'après leurs relations : </para>
          <variablelist>
          <varlistentry><term>Relation entre deux individus</term>
           <listitem><para> Cette règle sélectionne les ancêtres des deux personnes
	   jusqu'à leur ancêtre commun s'il existe. Ceci donne la
           &quot;liaison relationnelle&quot; entre ces individus à travers leur(s)
	   ancêtre(s) commun(s).
           </para>

          <para> Vous pouvez soit saisir l'identifiant des personnes dans une zone de saisie,
	  soit les sélectionner dans la liste en cochant leur bouton
          <guibutton>Sélectionner...</guibutton>. Dans ce cas, l'identifiant
	  apparaîtra dans la zone de saisie après la sélection.
          </para>
           </listitem>
           </varlistentry>

           </variablelist>
         </sect3>

        <!-- =============== Appendices Sub-subsection ================ -->
    	<sect3 id="filtref-misc">
        <title>Filtres divers</title>
        <para>Cette catégorie comprend les règles suivantes qui n'appartiennent
	pas à une autre catégorie : </para>
          <variablelist>

          <varlistentry><term>A l'attribut individuel</term>
          <listitem><para> Cette règle sélectionne les personnes
	  qui ont l'attribut individuel avec une valeur donnée.
	  L'attribut sur lequel porte la sélection est choisi dans un menu déroulant.
	  La valeur désirée pour cet attribut est saisie dans une zone de texte.
          </para></listitem>
          </varlistentry>

          <varlistentry><term>A l'attribut familial</term>
          <listitem><para> Cette règle sélectionne les personnes
	  qui ont l'attribut familial avec une valeur donnée.
	  L'attribut sur lequel porte la sélection est choisi dans un menu déroulant.
	  La valeur désirée pour cet attribut est saisie dans une zone de texte.
          </para></listitem>
          </varlistentry>

          <varlistentry><term>Correspond au filtre suivant</term>
          <listitem><para> Cette règle sélectionne les personnes par un filtre.
	  Le filtre est choisi par son nom dans un menu.
          </para></listitem>
          </varlistentry>

          </variablelist>
        </sect3>
        
      </sect2> 
