<?xml version="1.0" encoding="UTF-8"?>
<chapter id="firsttime">
<chapterinfo>
  <authorgroup>
    <author
>&Michael.T.Edwardes; &Michael.T.Edwardes.mail; </author>
  </authorgroup>
  <date
>25/07/2010</date>
  <releaseinfo
>4.5</releaseinfo>
</chapterinfo>

<title
>Utiliser &kappname; pour la première fois</title>

<sect1 id="firstime-1">
<title
>Lancer &kappname; pour la première fois</title>

<para
>Une fois &kappname; lancé avec succès, deux fenêtres seront ouvertes. La fenêtre au premier plan, <quote
>Astuce du jour</quote
> propose une série d'informations utiles ou importantes à propos de l'application. <screenshot>
	<screeninfo
>Astuce du Jour</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="tipofday.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Astuce du Jour</phrase>
	</textobject>
	</mediaobject>
  </screenshot>
</para>

<para
>Il est recommendé de lire rapidement ces astuces en cliquant sur les bouttons <guibutton
>Précédent</guibutton
> et <guibutton
>Suivant</guibutton
> en bas de la fenêtre. </para>

<para
>Une fois que vous aurez lu les astuces, la fenêtre peut être fermée ; elle sera réouverte à chaque fois que &kappname; sera lancé. Pour changer ce comportement par défaut, décochez l'option en question sur la fenêtre Astuce du Jour. </para>

<note>
  <para
>Les astuces peuvent être lues à tout moment en sélectionnant <guimenuitem
>Afficher l'astuce du jour</guimenuitem
> dans le menu <guimenu
>Aide</guimenu
> de &kappname;. </para>
</note>

<para
>Toutes les astuces ont été extraites de la Foire Aux Questions (FAQ) qui fournit une aide plus détaillée et qui peut être trouvée sur le <ulink url="http://kmymoney2.sourceforge.net/faq.html"
>site web</ulink
> du projet et dans son manuel. </para>

<para
>Veuillez cliquez sur le boutton <guibutton
>Fermer</guibutton
> pour fermer la fenêtre Astuce du Jour. </para>
</sect1>

<sect1 id="firsttime.mainwindow">
<title
>La fenêtre principale</title>

<para>
	<screenshot>
	<screeninfo
>La fenêtre principale</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="mainwindow_numbered.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>La fenêtre principale</phrase>
	</textobject>
	</mediaobject>
	</screenshot>
</para>

<para
>La fenêtre principale de &kappname; comporte quatre parties principales </para>

<itemizedlist>
  <listitem
><para
>A. La barre de menu</para
></listitem>
  <listitem
><para
>B. La barre d'outils</para
></listitem>
  <listitem
><para
>C. Le sélectionneur de vues</para
></listitem>
  <listitem
><para
>D. La vue</para
></listitem>
</itemizedlist>

<para
>Le menu et les barres d'outils fournissent un accès aux fonctionnalités de &kappname; et vous permettent de <link linkend="firsttime.3"
>Créer</link
> des fichiers ou de configurer comment &kappname; fonctionne. </para>

<para
>Le sélectionneur de vues consiste en au moins 11 icônes du côté gauche de la fenêtre principale, en fonction des logiciels disponibles sur votre système. Plus d'icônes pourraient être ajoutées par différents modules. En cliquant sur une icône, la vue appropriée de vos données financières est chargée sur la fenêtre de vue du côté droit. Chaque vue propose une représentation unique de votre situation financière et vous permet de voir ou d'éditer l'information affichée. </para>

<para
>Le sélectionneur de vues contient les icônes suivantes </para>

<itemizedlist>
  <listitem>
    <para
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="home_view.png" format="PNG"/></imageobject
><textobject
><phrase
>Accueil</phrase
></textobject
></inlinemediaobject
></guiicon
> Accueil : un aperçu configurable de votre situation financière actuelle (ou une page d'introduction quand aucun fichier de données n'est ouvert). </para>
  </listitem>

  <listitem>
    <para
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="institutions_view.png" format="PNG"/></imageobject
><textobject
><phrase
>Etablissements</phrase
></textobject
></inlinemediaobject
></guiicon
>Etablissements : tous vos établissements financiers et comptes sont affichés dans une hiérarchie. </para>
  </listitem>

  <listitem>
    <para
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="accounts_view.png" format="PNG"/></imageobject
><textobject
><phrase
>Comptes</phrase
></textobject
></inlinemediaobject
></guiicon
>Comptes : tous vos comptes sont affichés dans une hiérarchie. </para>
  </listitem>

  <listitem>
    <para
><guiicon
> <inlinemediaobject
> <imageobject
> <imagedata fileref="schedule_view.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Opérations récurrentes</phrase
> </textobject
> </inlinemediaobject
> </guiicon
> Opérations récurrentes : vos factures et virements récurrents. </para>
  </listitem>

  <listitem>
    <para
><guiicon
> <inlinemediaobject
> <imageobject
> <imagedata fileref="categories_view.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Catégories</phrase
> </textobject
> </inlinemediaobject
> </guiicon
> Catégories : les comptes spéciaux qui vous permettent de grouper des opérations liées. </para>
  </listitem>

  <listitem>
    <para
><guiicon
> <inlinemediaobject
> <imageobject
> <imagedata fileref="payees_view.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Bénéficiaires</phrase
> </textobject
> </inlinemediaobject
> </guiicon
> Bénéficiaires : tous les bénéficiaires utilisés par &kappname;. </para>
  </listitem>

  <listitem>
    <para
><guiicon
> <inlinemediaobject
> <imageobject
> <imagedata fileref="ledgers_view.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Registres</phrase
> </textobject
> </inlinemediaobject
> </guiicon
> Registres : vos opérations </para>
  </listitem>

  <listitem>
    <para
><guiicon
> <inlinemediaobject
> <imageobject
> <imagedata fileref="investments_view.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Investissements</phrase
> </textobject
> </inlinemediaobject
> </guiicon
> Investissements : l'aperçu de votre portefeuille. </para>
  </listitem>

  <listitem>
    <para
><guiicon
> <inlinemediaobject
> <imageobject
> <imagedata fileref="reports_view.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Rapports</phrase
> </textobject
> </inlinemediaobject
> </guiicon
> Rapports : une collection de rapports utiles, vous fournissant des vues alternatives pour vos données financières. </para>
  </listitem>

  <listitem>
    <para
><guiicon
> <inlinemediaobject
> <imageobject
> <imagedata fileref="budgets_view.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Budgets</phrase
> </textobject
> </inlinemediaobject
> </guiicon
> Budgets : vos budgets </para>
  </listitem>

  <listitem>
    <para
><guiicon
> <inlinemediaobject
> <imageobject
> <imagedata fileref="forecast_view.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Prévisions</phrase
> </textobject
> </inlinemediaobject
> </guiicon
> Prévisions : cette vue vous fournit des prévisions pour vos comptes et catégories </para>
  </listitem>

  <listitem>
    <para
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="outbox_view.png" format="PNG"/></imageobject
><textobject
><phrase
>Boîte d'envoi</phrase
></textobject
></inlinemediaobject
></guiicon
> Boîte d'envoi : utilisée par le module de banque en ligne pour vous fournir un retour sur le processus en cours. Cette vue est fournie par le module KBanking et peut ne pas être présente sur votre système. </para>
  </listitem>
</itemizedlist>
</sect1>

<sect1 id="firsttime.3">
<title
>Créer un nouveau fichier</title>

<para
>&kappname; enregistre toutes les données sur vos finances dans un fichier. Comme nous l'expliquons dans <link linkend="makingmostof.basicaccounting.personalaccounts"
>Définir les comptes</link
>, vous pouvez conserver plus d'un groupe de comptes, mais les données pour chacun d'entre eux seront conservées dans un fichier différent, et &kappname; ne peut avoir qu'un fichier ouvert à la fois. Consultez le chapître sur les <link linkend="details.formats"
>Formats de Fichiers</link
> pour plus de détails sur les fichiers de données de &kappname;. </para>

<para
>Pour créer un nouveau fichier vous pouvez soit sélectionner <menuchoice
><guimenu
>Fichier</guimenu
><guimenuitem
>Nouveau</guimenuitem
></menuchoice
> dans le menu ou choisir l'icône <inlinemediaobject
><imageobject
><imagedata fileref="new.png"/></imageobject
><textobject
><phrase
>Nouveau</phrase
></textobject
></inlinemediaobject
> depuis la barre d'outils. </para>

<para
>&kappname; ouvrira <quote
>L'assistant à la Création d'un Nouveau Fichier</quote
> qui vous guidera à travers le processus de création du fichier. </para>

<para>
	<screenshot>
	<screeninfo
>Données Personnelles</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="newfile.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Données Personnelles</phrase>
	</textobject>
	</mediaobject>
	</screenshot>
</para>

<para
>Tous les champs sont optionnels, vous pouvez utiliser &kappname; sans saisir aucune information dans l'immédiat. Les informations saisies ici ne seront utilisées que pour personnaliser votre fichier. Dans le futur, elles pourraient être utilisées dans certains rapports ou pour la banque en ligne. Si &kappname; a besoin d'informations personnelles dans les prochaines versions et ne les trouve pas, elles vous seront demandées à ce moment là. </para>

<para
>Veuillez saisir votre nom et adresse (ou pas) et cliquer sur <guibutton
>Suivant</guibutton
>. </para>

<para
>Au cas ou vous auriez stocké votre adresse dans le &kaddressbook;, le boutton <guibutton
>Charger à partir du Carnet d'Adresses</guibutton
> sera activé et vous pourrez cliquer dessus pour importer toutes vos informations vers &kappname;. </para>

<para
>&kappname; gère plusieurs devises. Pour définir votre devise par défaut (la devise que vous utilisez tous les jours et qui doit être utilisée dans vos rapports), sélectionnez le choix adapté dans la liste et cliquez sur <guibutton
>Suivant</guibutton
>. Une devise par défaut sera sélectionnée par &kappname; en fonction de vos paramètres régionaux et linguistiques. </para>

<para>
	<screenshot>
	<screeninfo
>Page de choix de la devise de base</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="newfile-2.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Page de choix de la devise de base</phrase>
	</textobject>
	</mediaobject>
	</screenshot>
</para>

<para
>La page suivante vous permet de créer un compte initial. Pour la majorité des utilisateurs de &kappname;, c'est un compte courrant. </para>

<para>
	<screenshot>
	<screeninfo
>Page de création du compte courrant</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="newfile-3.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Page de création du compte courrant</phrase>
	</textobject>
	</mediaobject>
	</screenshot>
</para>

<para
>Saisissez le nom du compte et un numéro de référence assigné par l'établissement gérant le compte. Saisissez la date d'ouverture et le solde initial du compte. Par example, si vous voulez que &kappname; gère vos finances depuis le 1er Janvier 2008, saisissez le solde de votre compte à ce jour. Ce chiffre peut être obtenu à partir des relevés papier. Saisissez aussi le nom et le numéro de routage de votre établissement, même si cette information est optionnelle et n'est nécessaire que pour les fonctionnalités de banque en ligne. </para>

<para
>Au cas où vous ne voudriez pas configurer un compte initial, décochez la case. </para>

<para
>Une fois terminé, cliquez sur <guibutton
>Suivant</guibutton
> pour avancer. </para>

<para>
	<screenshot>
	<screeninfo
>Page de sélection du modèle de compte</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="newfile-4.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Page de sélection du modèle de compte</phrase>
	</textobject>
	</mediaobject>
	</screenshot>
</para>


<para
>Choisissez le pays et le modèle de compte adéquat. Plusieurs modèles, mêmes de pays différents peuvent être sélectionnés en utilisant la combinaison de &Ctrl;, &Maj; et du bouton gauche de la souris. La hiérarchie de comptes qui sera déployée est affichée dans la partie aperçu de l'assistant. Si vous ne pouvez pas trouver un modèle correspondant à vos besoins, n'en sélectionnez pas. </para>

<para
>Une fois la sélection du modèle terminée, cliquez sur <guibutton
>Suivant</guibutton
> pour continuer. </para>

<para
>La page suivante de l'assistant vous permet de configurer les préférences utilisateur. Cliquez sur <guibutton
>Suivant</guibutton
> quand vous avez terminé et souhaitez continuer. </para>

<para>
	<screenshot>
	<screeninfo
>Page de Préférences</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="newfile-5.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Page de Préférences</phrase>
	</textobject>
	</mediaobject>
	</screenshot>
</para>

<para
>La dernière page de l'assistant vous permet de choisir le nom de fichier qui sera utilisé pour stocker vos données financières. Un nom de fichier initial sera construit à partir de votre dossier personnel et de votre nom d'utilisateur. Au cas où le fichier existe déjà, un avertissement sera affiché vous appelant à sélectionner le nom d'un fichier non-existant. </para>

<para>
	<screenshot>
	<screeninfo
>Page de sélection du nom de fichier</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="newfile-6.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Page de sélection du nom de fichier</phrase>
	</textobject>
	</mediaobject>
	</screenshot>
</para>

<para
>Vous avez maintenant saisi toutes les informations utiles à la création du fichier. Cliquez sur <guibutton
>Terminer</guibutton
> et &kappname; créera le fichier pour vous et l'ouvrira. </para>

<!--
<para
>After &kappname; has finished loading the default accounts your financial
summary will be displayed.  As you have defined no accounts to hold your
transactions this is currently empty.</para>
-->
</sect1>

<sect1 id="firsttime.4">
<title
>Créer les comptes</title>

<para
>Vous pouvez créer un compte de deux façons différentes décrites ci-après : </para>

<variablelist>
  <varlistentry>
    <term
>En utilisant le menu</term>
    <listitem>
      <para
>Pour créer un compte en utilisant le menu sélectionner <menuchoice
><guimenu
>Compte</guimenu
><guimenuitem
>Nouveau Compte</guimenuitem
></menuchoice
>. </para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
>En utilisant la vue Comptes</term>
    <listitem>
      <para
>Pour créer un compte en utilisant la vue comptes cliquez sur l'icône Comptes dans le sélecteur de vues puis faites un clic droit sur la ligne Actif de l'arborescence et sélectionnez <guimenuitem
>Nouveau Compte</guimenuitem
> dans le menu contextuel. La notion d'Actif /Passif et tous les autres types de comptes seront étudiés plus en détail dans ce manuel. </para>
    </listitem>
  </varlistentry>
</variablelist>

<tip>
  <para
>Notez que &kappname; utilise beaucoup les menus contextuels à travers toute l'application. Si vous ne parvenez pas à savoir comment effectuer une opération, essayez de faire un clic droit là où vous vous attendez à voir une fonctionnalité. </para>
</tip>

<para
>Quelle que soit la méthode utilisée, créer un compte ouvre l'<emphasis
>Assistant de Paramétrage d'un Nouveau Compte</emphasis
>. Cet assistant vous accompagnera étape par étape dans le processus de création d'un compte, récoltant les informations nécessaires à chaque étape. Pour naviguer à travers les pages cliquez sur les boutons <guibutton
>Précédent</guibutton
> et <guibutton
>Suivant</guibutton
>. </para>

<para
>Créez un compte en utilisant une des deux méthodes précedemment mentionnées pour continuer. Une description complète de la création des comptes peut être trouvée dans la section <link linkend="details.accounts"
>Comptes</link
>. </para>

<para
>Maintenant qu'un ou plusieurs comptes existent dans &kappname;, le résumé de ces comptes est affiché sur la vue d'Accueil. Vous pouvez créer des opérations manuellement dans la vue <link linkend="details.ledgers"
>Registres</link
> ou mettre en place des opérations automatiques à travers la vue <link linkend="details.schedules"
>Opérations Récurentes</link
>. </para>
</sect1>

<sect1 id="firsttime.schedules">
<title
>Opérations récurrentes</title>

<para
>Une <link linkend="details.schedules"
>opération récurrente</link
> est une opération qui a lieu une ou plusieurs fois dans un certain laps de temps. Par exemple si vous recevez votre salaire chaque mois ou chaque semaine. Au lieu d'avoir à saisir les détails de l'opération à chaque fois que vous êtes payé, vous pouvez demander à &kappname; de créer une opération récurrente qui saisira l'opération à votre place à chaque fois que vous êtes payé. </para>

<para
>Pour mettre à jour les <link linkend="details.schedules"
>Opérations récurrentes</link
> cliquez sur l'icône <guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="schedule_view.png"/></imageobject
></inlinemediaobject
>Opérations récurrentes</guiicon
> dans le sélectionneur de vues. </para>
</sect1>

<sect1 id="firsttime.categories">
<title
>Catégories</title>

<para
>Pour mettre à jour les <link linkend="details.categories"
>Catégories</link
> cliquez sur l'icône <guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="categories_view.png"/></imageobject
></inlinemediaobject
>Catégories</guiicon
> du sélectionneur de vues. </para>

<para
>Une description complète de ce sujet peut être consultée dans la section <link linkend="details.categories"
>Catégories</link
>. </para>
</sect1>

<sect1 id="firsttime.payees">
<title
>Bénéficiaires</title>

<para
>Pour mettre à jour votre liste de bénéficiaires cliquez sur l'icône <guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="payees_view.png"/></imageobject
></inlinemediaobject
>Bénéficiaires</guiicon
> du sélectionneur de vues. </para>

<para
>Une description complète de ce sujet peut être consultée dans la section <link linkend="details.payees"
>Bénéficiaires</link
>. </para>
</sect1>

<sect1 id="firsttime.import">
<title
>Importation depuis un fichier Quicken Interchange Format (QIF)</title>

<para
>Si vous utilisez déjà une application de gestion financière, &kappname; peut importer les opérations d'un compte à partir du moment où elles sont dans le Format Quicken Interchange (QIF). La majorité des programmes de gestion financière peut exporter vers ce format et nous ne discuterons pas des différentes méthodes d'exportation au format QIF ici, par souci de concision. </para>

<para
>Une description complète de ce sujet peut être consultée dans la section <link linkend="details.impexp.qifimp"
>Importation QIF</link
>. </para>
</sect1>

<sect1 id="firsttime.find">
<title
>Chercher des opérations</title>

<para
>&kappname; fournit un outil de recherche de opérations puissant et utile sous la forme d'une fenêtre de recherche. </para>

<para
>La fenêtre de recherche peut être ouverte à partir de la barre d'outils en utilisant l'icône <guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="opération_find.png"/></imageobject
></inlinemediaobject
>Trouver</guiicon
> ou en sélectionnant <guimenuitem
>Trouver l'opération</guimenuitem
> depuis le menu <guimenu
>Edition</guimenu
>. </para>

<para
>Une description complète de ce sujet peut être consultée dans la section <link linkend="details.search"
>Recherche</link
>. </para>

</sect1>

<sect1 id="firsttime.reconcile">
<title
>Réconciliation</title>

<para
>A un certain point, vous aurez besoin de réconcilier les opération que vous avez saisies avec celles listées dans un relevé, que ce soit celui de votre compte en banque, de votre carte de crédit, de votre prêt ou autres. La réconciliation implique la mise en correspondance de ce que vous avez saisi et de ce qui est listé par le relevé. Si des incohérences sont trouvées c'est que vous ou la personne ayant généré le relevé a fait une erreur. </para>

<para
>Pour réconcilier un compte, sélectionnez tout d'abord le compte, soit depuis la vue <guiicon
>Comptes</guiicon
>, soit depuis la vue <guiicon
>Registres</guiicon
>. Puis, cliquez sur l'icône <guiicon
>Réconcilier</guiicon
> de la barre d'outils ou sélectionnez <guimenuitem
>Réconcilier</guimenuitem
> depuis le menu <guimenu
>Compte</guimenu
>. </para>

<para
>Une description complète de ce sujet peut être trouvée dans la section <link linkend="details.reconcile"
>Réconciliation</link
>. </para>

</sect1>

<sect1 id="firsttime.backup">
<title
>Effectuer des copies de secours</title>

<para
>Maintenant que vous avez créé quelques comptes et saisi des opérations il serait bon de faire une sauvegarde. Le fichier utilisé par &kappname; étant un fichier Unix standard, vous pouvez tout simplement le copier vers un autre endroit pour le sauvegarder ou utiliser la fenêtre fournie par &kappname;. Il vaut mieux utiliser la fenêtre, car si un jour &kappname; utilise un autre format de fichier, comme une base SQL, alors il sera beaucoup plus difficile de copier le fichier manuellement. </para>

<para
>Pour effectuer une copie de secours de votre fichier à travers &kappname;, sélectionnez <guimenuitem
>Sauvegarde</guimenuitem
> dans le menu <guimenu
>Fichier</guimenu
> et saisissez le dossier où vous souhaiteriez que le fichier soit copié. Si le dossier à besoin d'être monté en premier lieu, vous devrez avoir les privilèges suffisants et cocher la case <guilabel
>Monter ce dossier avant de sauvegarder</guilabel
> puis cliquer sur OK. </para>

<para
>Le fichier sera copié dans le dossier spécifié avec la date actuelle concaténée à la fin du nom du fichier pour qu'il vous soit facile de voir à quelle date le fichier a été enregistré. </para>
</sect1>

<sect1 id="firsttime.launch">
<title
>Lancer &kappname;</title>

<para
>De manière générale, vous lancerez &kappname; depuis une icône ou le menu de démarrage de votre environnement de bureau. Dans ce cas, le comportement par défaut de &kappname; est d'ouvrir le dernier fichier ouvert. Néanmoins, dans certains cas, vous aurez envie ou besoin de lancer &kappname; depuis la ligne de commande. </para>

<para
>Pour une description complète de toutes les options disponibles en ligne de commande, consultez la page man de &kappname;. Néanmoins, nous décrirons deux cas particuliers ici. </para>

<formalpara
><title
><command
>kmymoney -n</command
></title>
  <para
>L'option -n indique à &kappname; de ne pas ouvrir le dernier fichier ouvert. Ca peut être utile si le programme plante au démarrage. </para>
</formalpara>

<formalpara
><title
><command
>kmymoney &lt;emplacement du fichier&gt;</command
></title>
  <para
>Donner à &kappname; un nom de fichier via la ligne de commande lui indique d'ouvrir ce fichier et non le dernier fichier ouvert. Vous pouvez utiliser le nom de n'importe quel fichier &kappname; valable, comme décrit dans le chapitre sur les <link linkend="details.formats"
>formats de fichiers</link
>. De plus, cette fonctionnalité peut être utilisée pour importer un fichier <link linkend="details.impexp.gnucash"
>GnuCash</link
>. </para>
</formalpara>

</sect1>

<sect1 id="firsttime.contact">
<title
>Contacter les Développeurs / Signaler des Bogues</title>

<sect2>
<title
>Contacter les Développeurs</title>

<para
>Vous pouvez contacter les développeurs à travers leur liste de discussion &devlist;. </para>

<para
>Nous sommes heureux d'avoir votre retour d'expérience sur &kappname;. </para>
</sect2>

<sect2>
<title
>Signaler des Bogues</title>

<para
>Pour signaler un bogue, veuillez utiliser l'interface fournie par &kappname; en sélectionnant<menuchoice
><guimenu
>Aide</guimenu
><guimenuitem
>Rapport de Bug</guimenuitem
></menuchoice
> et en remplissant les informations utiles. Néanmoins, au cas où vous auriez des difficultés à utiliser cette méthode, vous pouvez signaler un bug (ou faire une demande d'amélioration) directement sur la <ulink url="http://bugs.kde.org"
>page web des bogues de &kde;</ulink
>. Les rapports doivent être soumis par rapport au produit <quote
>kmymoney4</quote
>. <quote
>kmymoney2</quote
> est spécifique aux bogues des versions 1.0.x de l'application. </para>

<para
>Dans tous les cas, avant de signaler un bogue, veuillez lire les règles ci-dessous. Les suivre augmentera les chances des développeurs d'identifier rapidement le problème sans avoir besoin de vous demander plus d'informations. </para>

<sect3 id="firsttime.bugs.quality">
<title
>Ecrire des Raports de Bogues de Bonne Qualité</title>

<para
>Nous encourageons les utilisateurs à prendre du temps supplémentaire pour écrire des raports de bogues de bonne qualité lorsqu'ils les soumettent. Cela réduit les efforts inutiles des deux côtés, étant donné que la personne à l'origine du rapport et le développeur qui règlera le bogue devront le cas échéant échanger des mails jusqu'à ce que cette information soit bien déterminée. </para>

<para
>Eli Goldberg a écrit les règles d'écriture de rapports de bogues, disponibles sur <ulink url="http://issues.apache.org/bugwritinghelp.html"
>http://issues.apache.org/bugwritinghelp.html</ulink
>. De manière générale, il est conseillé de suivre ces règles : </para>

<formalpara
><title
>Incluez les informations sur votre système</title>
  <para
>La fonctionnalité <menuchoice
><guimenu
>Aide</guimenu
><guimenuitem
>Rapporter un Bogue</guimenuitem
></menuchoice
> remplira ces informations à votre place automatiquement, mais si vous choisissez de ne pas utiliser cette interface, vous devrez connaître la version de &kappname; que vous utilisez, la version de &kde;, le nom et la version de votre distribution et la version de votre noyau. </para>
</formalpara>

<formalpara
><title
>Inclure les traces lors d'un plantage</title>
  <para
>Les traces sont souvent l'élément d'information le plus utile pour la résolution des plantages. </para>
</formalpara>

<formalpara
><title
>Essayez de le reproduire</title>
  <para
>Faites nous savoir si vous êtes capables de reproduire le bogue. Il est utile pour nous de savoir si le bogue ne s'est produit qu'une fois et vous n'avez pas réussi à le faire se reproduire, si il arrive à chaque fois ou si il arrive parfois. </para>
</formalpara>

<formalpara
><title
>Inclure les étapes spécifiques</title>
  <para
><quote
>J'ai saisi une opération et &kappname; a planté.</quote
>, voila un mauvais rapport de bogue. <quote
>En utilisant le formulaire d'opération, j'ai saisi une nouvelle opération dans mon compte Carte de Crédit. J'ai sélectionné l'onglet Transfert, saisi un montant, puis je suis passé à l'onglet Dépôt, et de revenu à l'onglet Transfert. Quand je suis revenu à l'onglet Transfert, &kappname; a planté. Ce bug est reproductible chez moi.</quote
>, ceci est un bien meilleur rapport de bogue. </para>
</formalpara>

<formalpara
><title
>Dites nous ce à quoi vous vous attendiez</title>
  <para
>Dans certains cas, c'est évident, mais pour certains bogues plus subtils, vous verrez parfois un rapport de bogue où il n'est pas évident de deviner ce que la personne l'ayant signalé attendait. Dites nous systématiquement le comportement que vous attendiez. </para>
</formalpara>

<formalpara
><title
>Considérez lancer l'application avec le débogage activé</title>
  <para
>En compilant une version configurée avec --enable-debug=full vous pouvez vous assurer que les meilleures traces possibles sont générées. Si vous plantez, lancez une nouvelle fois &kappname; à partir de gdb et reproduisez le plantage. Lorsque le logiciel plante, saisissez <quote
>bt</quote
> pour générer une trace. </para>
</formalpara>

<para
>Faire ceci est un peu plus difficile, nous ne nous attendons donc pas à ce que tous les utilisateurs le fassent. Néanmoins, si vous souhaitez rendre &kappname; le plus stable possible, la meilleure façon de faire est encore de trouver le bogue dans le code source et de nous envoyer un patch. </para>
</sect3>
</sect2>
</sect1>
</chapter>
