gtk-doc-help HEAD - en to fr translation catalogue (350 entries)

note: (itstool) path: bookinfo/title
en: GTK-Doc Manual
fr: Manuel de GTK-Doc

note: (itstool) path: abstract/para
en: User manual for developers with instructions of GTK-Doc usage.
fr: Manuel utilisateur pour les développeurs contenant les instructions sur l'usage de GTK-Doc.

note: (itstool) path: publisher/publishername
en: GTK-Doc project
fr: Projet GTK-Doc

note: (itstool) path: bookinfo/copyright
en: <year>2000, 2005</year> <holder>Dan Mueth and Chris Lyttle</holder>
fr: <year>2000, 2005</year> <holder>Dan Mueth et Chris Lyttle</holder>

note: (itstool) path: legalnotice/para
en: Permission is granted to copy, distribute and/or modify this document under the terms of the <citetitle>GNU Free Documentation License</citetitle>, 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 <link linkend="fdl">included</link>.
fr: Permission vous est donnée de copier, distribuer et/ou modifier ce document selon les termes de la <citetitle>licence de documentation libre GNU</citetitle>, version 1.1 ou ultérieure publiée par la Free Software Foundation sans section inaltérable, sans texte de première page de couverture ni texte de dernière page de couverture. Vous trouverez un exemplaire de cette licence en suivant ce <link linkend="fdl">lien</link>.

note: (itstool) path: legalnotice/para
en: Many of the names used by companies to distinguish their products and services are claimed as trademarks. Where those names appear in any GNOME documentation, and those trademarks are made aware to the members of the GNOME Documentation Project, the names have been printed in caps or initial caps.
fr: La plupart des noms utilisés par les entreprises pour distinguer leurs produits et services sont des marques déposées. Lorsque ces noms apparaissent dans la documentation GNOME et que les membres du projet de Documentation GNOME sont informés de l'existence de ces marques déposées, soit ces noms entiers, soit leur première lettre est en majuscule.

note: (itstool) path: revhistory/revision
en: <revnumber>1.26.1</revnumber> <date>11 Aug 2017</date> <authorinitials>ss</authorinitials> <revremark>development</revremark>
fr: <revnumber>1.26.1</revnumber> <date>11 Aug 2017</date> <authorinitials>ss</authorinitials> <revremark>développement</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.26</revnumber> <date>11 Aug 2017</date> <authorinitials>ss</authorinitials> <revremark>port all tools from perl/bash to python</revremark>
fr: <revnumber>1.26</revnumber> <date>11 Aug 2017</date> <authorinitials>ss</authorinitials> <revremark>portage de tous les outils depuis perl/bash vers python</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.25</revnumber> <date>21 March 2016</date> <authorinitials>ss</authorinitials> <revremark>bug fixes, test cleanups</revremark>
fr: <revnumber>1.25</revnumber> <date>21 March 2016</date> <authorinitials>ss</authorinitials> <revremark>corrections d'anomalies, nettoyages de test</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.24</revnumber> <date>29 May 2015</date> <authorinitials>ss</authorinitials> <revremark>bug fix</revremark>
fr: <revnumber>1.24</revnumber> <date>29 May 2015</date> <authorinitials>ss</authorinitials> <revremark>corrections d'anomalies</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.23</revnumber> <date>17 May 2015</date> <authorinitials>ss</authorinitials> <revremark>bug fix</revremark>
fr: <revnumber>1.23</revnumber> <date>17 May 2015</date> <authorinitials>ss</authorinitials> <revremark>corrections d'anomalies
    </revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.22</revnumber> <date>07 May 2015</date> <authorinitials>ss</authorinitials> <revremark>bug fixes, dropping deprecated features</revremark>
fr: <revnumber>1.22</revnumber> <date>07 May 2015</date> <authorinitials>ss</authorinitials> <revremark>corrections d'anomalies, abandon de fonctionnalités obsolètes</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.21</revnumber> <date>17 Jul 2014</date> <authorinitials>ss</authorinitials> <revremark>bug fixes, dropping deprecated features</revremark>
fr: <revnumber>1.21</revnumber> <date>17 Jul 2014</date> <authorinitials>ss</authorinitials> <revremark>corrections d'anomalies, abandon de fonctionnalités obsolètes</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.19</revnumber> <date>05 Jun 2013</date> <authorinitials>ss</authorinitials> <revremark>bug fixes</revremark>
fr: <revnumber>1.19</revnumber> <date>05 Jun 2013</date> <authorinitials>ss</authorinitials> <revremark>corrections d'anomalies</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.18</revnumber> <date>14 Sep 2011</date> <authorinitials>ss</authorinitials> <revremark>bug fixes, speedups, markdown support</revremark>
fr: <revnumber>1.18</revnumber> <date>14 Sep 2011</date> <authorinitials>ss</authorinitials> <revremark>correction de bogues, amélioration de la vitesse de traitement, prise en charge de markdown</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.17</revnumber> <date>26 Feb 2011</date> <authorinitials>sk</authorinitials> <revremark>urgent bug fix update</revremark>
fr: <revnumber>1.17</revnumber> <date>26 février 2011</date> <authorinitials>sk</authorinitials> <revremark>mise à jour pour une correction de bogue urgente</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.16</revnumber> <date>14 Jan 2011</date> <authorinitials>sk</authorinitials> <revremark>bugfixes, layout improvements</revremark>
fr: <revnumber>1.16</revnumber> <date>14 janvier 2011</date> <authorinitials>sk</authorinitials> <revremark>correctifs et améliorations de mise en page</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.15</revnumber> <date>21 May 2010</date> <authorinitials>sk</authorinitials> <revremark>bug and regression fixes</revremark>
fr: <revnumber>1.15</revnumber> <date>21 mai 2010</date> <authorinitials>sk</authorinitials> <revremark>corrections d'anomalies et de régressions</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.14</revnumber> <date>28 March 2010</date> <authorinitials>sk</authorinitials> <revremark>bugfixes and performance improvements</revremark>
fr: <revnumber>1.14</revnumber> <date>28 mars 2010</date> <authorinitials>sk</authorinitials> <revremark>correctifs et amélioration de performances</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.13</revnumber> <date>18 December 2009</date> <authorinitials>sk</authorinitials> <revremark>broken tarball update</revremark>
fr: <revnumber>1.13</revnumber> <date>18 décembre 2009</date> <authorinitials>sk</authorinitials> <revremark>mise à jour du tarball brisé</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.12</revnumber> <date>18 December 2009</date> <authorinitials>sk</authorinitials> <revremark>new tool features and bugfixes</revremark>
fr: <revnumber>1.12</revnumber> <date>18 décembre 2009</date> <authorinitials>sk</authorinitials> <revremark>nouvelles fonctionnalités aux outils et résolution de bogues</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.11</revnumber> <date>16 November 2008</date> <authorinitials>mal</authorinitials> <revremark>GNOME doc-utils migration</revremark>
fr: <revnumber>1.11</revnumber> <date>16 novembre 2008</date> <authorinitials>mal</authorinitials> <revremark>Migration à GNOME doc-utils</revremark>

note: (itstool) path: chapter/para
en: This chapter introduces GTK-Doc and gives an overview of what it is and how it is used.
fr: Ce chapitre présente GTK-Doc et fournit un aperçu de ce que c'est et de la manière de l'utiliser.

note: (itstool) path: sect1/title
en: What is GTK-Doc?
fr: Qu'est-ce que GTK-Doc ?

note: (itstool) path: sect1/para
en: GTK-Doc is used to document C code. It is typically used to document the public API of libraries, such as the GTK+ and GNOME libraries. But it can also be used to document application code.
fr: GTK-Doc est utilisé pour documenter du code C. Il est typiquement utilisé pour documenter les API publiques de bibliothèques, comme les bibliothèques GTK+ et GNOME. Mais il peut aussi être utilisé pour documenter du code d'application.

note: (itstool) path: sect1/title
en: How Does GTK-Doc Work?
fr: Fonctionnement de GTK-Doc ?

note: (itstool) path: sect1/para
en: GTK-Doc works by using documentation of functions placed inside the source files in specially-formatted comment blocks, or documentation added to the template files which GTK-Doc uses (though note that GTK-Doc will only document functions that are declared in header files; it won't produce output for static functions).
fr: GTK-Doc fonctionne en utilisant la documentation de fonctions placées dans le code source sous la forme de blocs de commentaires avec un formatage spécifique ou la documentation ajoutée aux fichiers prototypes que GTK-Doc utilise (notez cependant que GTK-Doc ne documente que les fonctions déclarées dans des fichiers d'en-tête ; il ne fait rien pour les fonctions statiques).

note: (itstool) path: sect1/para
en: GTK-Doc consists of a number of python scripts, each performing a different step in the process.
fr: GTK-Doc consiste en un certain nombre de scripts Python, chacun réalisant une étape du processus.

note: (itstool) path: sect1/para
en: There are 5 main steps in the process:
fr: Il y a 5 étapes principales :

note: (itstool) path: listitem/para
en: <guilabel>Writing the documentation.</guilabel> The author fills in the source files with the documentation for each function, macro, union etc. (In the past information was entered in generated template files, which is not recommended anymore).
fr: <guilabel>Écriture de la documentation.</guilabel> L'auteur complète les fichiers sources avec la documentation pour chaque fonction, macro, union, etc. (dans le passé, l'information était saisie dans les fichiers prototypes générés mais ce n'est plus recommandé).

note: (itstool) path: listitem/para
en: <guilabel>Gathering information about the code.</guilabel> <application>gtkdoc-scan</application> scans the header files of the code looking for declarations of functions, macros, enums, structs, and unions. It creates the file <filename>&lt;module&gt;-decl-list.txt</filename> containing a list of the declarations, placing them into sections according to which header file they are in. On the first run this file is copied to <filename>&lt;module&gt;-sections.txt</filename>. The author can rearrange the sections, and the order of the declarations within them, to produce the final desired order. The second file it generates is <filename>&lt;module&gt;-decl.txt</filename>. This file contains the full declarations found by the scanner. If for some reason one would like some symbols to show up in the docs, where the full declaration cannot be found by the scanner or the declaration should appear differently, one can place entities similar to the ones in <filename>&lt;module&gt;-decl.txt</filename> into <filename>&lt;module&gt;-overrides.txt</filename>.
fr: <guilabel>Collecte des informations sur le code.</guilabel> <application>gtkdoc-scan</application> analyse les fichiers d'en-tête du code à la recherche des déclarations de fonctions, de macros, d'énumérations, de structures et d'unions. Il crée le fichier <filename>&lt;module&gt;-decl-list.txt</filename> contenant une liste des déclarations en les plaçant dans des sections en accord avec le fichier d'en-tête d'où elles proviennent. Lors du premier lancement, ce fichier est copié dans <filename>&lt;module&gt;-sections.txt</filename>. L'auteur peut réorganiser les sections et l'ordre des déclarations dans celui-ci, pour obtenir l'ordre final souhaité. Le deuxième fichier généré est <filename>&lt;module&gt;-decl.txt</filename>. Ce fichier contient les déclarations complètes trouvées lors de l'analyse. Si, pour une raison quelconque, on souhaite voir apparaître dans la documentation des éléments qui n'ont pas été trouvé lors de l'analyse, ou dont la déclaration doit apparaître différemment, il est possible d'ajouter des entrées dans <filename>&lt;module&gt;-overrides.txt</filename> similaires à celle de <filename>&lt;module&gt;-decl.txt</filename>.

note: (itstool) path: listitem/para
en: <application>gtkdoc-scangobj</application> can also be used to dynamically query a library about any GObject subclasses it exports. It saves information about each object's position in the class hierarchy and about any GObject properties and signals it provides.
fr: <application>gtkdoc-scanobj</application> peut aussi être utilisé pour interroger de manière dynamique une bibliothèque à propos de n'importe quelle sous-classe de GtkObject qu'elle exporte. Il enregistre les informations sur la position de chaque objet dans la hiérarchie de classe et sur tous les arguments et signaux GTK fournis.

note: (itstool) path: listitem/para
en: <application>gtkdoc-scanobj</application> should not be used anymore. It was needed in the past when GObject was still GtkObject inside gtk+.
fr: <application>gtkdoc-scanobj</application> ne devrait plus être utilisé. Il était nécessaire par le passé lorsque GObject était encore GtkObject dans gtk+.

note: (itstool) path: listitem/para
en: Files in <filename class="directory">xml/</filename> and <filename class="directory">html/</filename> directories are always overwritten. One should never edit them directly.
fr: Les fichiers dans les répertoires <filename class="directory">xml/</filename> et <filename class="directory">html/</filename> sont toujours écrasés. Il ne faut pas les modifier directement.

note: (itstool) path: listitem/para
en: <guilabel>Fixing up cross-references between documents.</guilabel> After installing the HTML files, <application>gtkdoc-fixxref</application> can be run to fix up any cross-references between separate documents. For example, the GTK+ documentation contains many cross-references to types documented in the GLib manual. When creating the source tarball for distribution, <application>gtkdoc-rebase</application> turns all external links into web-links. When installing distributed (pregenerated) docs the same application will try to turn links back to local links (where those docs are installed).
fr: <guilabel>Résolution des références croisées entre les documents.</guilabel> Après installation des fichiers HTML, <application>gtkdoc-fixxref</application> peut être exécuté pour résoudre toutes les références croisées entre les différents documents. Par exemple, la documentation de GTK+ contient beaucoup de références croisées vers des types documentés dans le manuel de GLib. Lors de la création de l'archive des sources pour la distribution, <application>gtkdoc-rebase</application> transforme tous les liens externes en liens Web. Lorsque vous installez la documentation distribuée (pré-générée), la même application va essayer de retransformer les liens en liens locaux (là où ces documentations sont installées).

note: (itstool) path: sect1/title
en: Getting GTK-Doc
fr: Obtention de GTK-Doc

note: (itstool) path: sect2/title
en: Requirements
fr: Pré-requis

note: (itstool) path: sect2/para
en: <guilabel>python 2/3</guilabel> - the main scripts are written in python.
fr: <guilabel>python 2/3</guilabel> - les principaux scripts sont écrits en Python.

note: (itstool) path: sect1/title
en: About GTK-Doc
fr: À propos de GTK-Doc

note: (itstool) path: sect1/para
en: (FIXME)
fr: (À COMPLETER)

note: (itstool) path: sect1/para
en: (History, authors, web pages, mailing list, license, future plans, comparison with other similar systems.)
fr: (Historique, auteurs, pages Web, liste de diffusion, licence, projets futurs, comparaison avec des systèmes similaires.)

note: (itstool) path: sect1/title
en: About this Manual
fr: À propos de ce manuel

note: (itstool) path: sect1/para
en: (who it is meant for, where you can get it, license)
fr: (qui est concerné, où le récupérer, licence)

note: (itstool) path: chapter/title
en: Setting up your project
fr: Mise en place de votre projet

note: (itstool) path: chapter/para
en: The next sections describe what steps to perform to integrate GTK-Doc into your project. Theses sections assume we work on a project called 'meep'. This project contains a library called 'libmeep' and an end-user app called 'meeper'. We also assume you will be using autoconf and automake. In addition section <link linkend="plain_makefiles">plain makefiles or other build systems</link> will describe the basics needed to work in a different build setup.
fr: Les sections suivantes décrivent les étapes à suivre pour intégrer GTK-Doc dans votre projet. Nous allons supposer que vous travaillez sur un projet appelé « meep ». Ce projet contient une bibliothèque appelée « libmeep » et une application « meeper ». Nous supposons également que vous utilisez autoconf et automake. Dans le cas contraire, la section <link linkend="plain_makefiles">« makefiles » simples et autres systèmes de compilation</link> décrit les éléments de base à respecter pour travailler dans une autre configuration de construction.

note: (itstool) path: sect1/title
en: Setting up a skeleton documentation
fr: Mise en place du squelette de documentation

note: (itstool) path: sect1/para
en: Under your top-level project directory create folders called docs/reference (this way you can also have docs/help for end-user documentation). It is recommended to create another subdirectory with the name of the doc-package. For packages with just one library this step is not necessary.
fr: Dans le répertoire racine de votre projet, créez les répertoires appelés docs/reference (de la même façon, vous pouvez avoir docs/help pour la documentation utilisateur). Il est recommandé de créer un autre sous-répertoire portant le nom du paquet de documentation. Pour les paquets qui contiennent seulement une bibliothèque, cette étape n'est pas nécessaire.

note: (itstool) path: example/title
en: Example directory structure
fr: Exemple d'arborescence de répertoires

note: (itstool) path: sect1/para
en: This can then look as shown below: <_:example-1/>
fr: Cela peut ressembler à ce qui suit : <_:example-1/>

note: (itstool) path: sect1/title (itstool) path: example/title
en: Integration with autoconf
fr: Intégration avec autoconf

note: (itstool) path: sect1/para
en: Very easy! Just add one line to your <filename>configure.ac</filename> script.
fr: C'est très simple ! Il faut juste ajouter une ligne dans votre script <filename>configure.ac</filename>.

note: (itstool) path: example/title
en: Keep gtk-doc optional
fr: Laisser gtk-doc optionnel

note: (itstool) path: sect1/para
en: This will require all developers to have gtk-doc installed. If it is okay for your project to have optional api-doc build setup, you can solve this as below. Keep it as is, as gtkdocize is looking for <function>GTK_DOC_CHECK</function> at the start of a line. <_:example-1/>
fr: Cela impose à tous les développeurs d'installer gtk-doc. Si pour votre projet, vous pouvez avoir une configuration de construction api-doc optionnelle, vous pouvez résoudre ce problème comme ci-dessous. Ne le modifiez pas car gtkdocize recherche <function>GTK_DOC_CHECK</function> au début d'une ligne. <_:example-1/>

note: (itstool) path: sect1/para
en: The first argument is used to check for the gtkdocversion at configure time. The 2nd, optional argument is used by <application>gtkdocize</application>. The <symbol>GTK_DOC_CHECK</symbol> macro also adds several configure switches:
fr: Le premier argument est utilisé pour vérifier le paramètre gtkdocversion au moment de la configuration. Le second, en option, est utilisé par <application>gtkdocize</application>. La macro <symbol>GTK_DOC_CHECK</symbol> ajoute également plusieurs drapeaux de configuration :

note: (itstool) path: listitem/para
en: --with-html-dir=PATH : path to installed docs
fr: --with-html-dir=CHEMIN : répertoire d'installation de la documentation,

note: (itstool) path: listitem/para
en: --enable-gtk-doc : use gtk-doc to build documentation [default=no]
fr: --enable-gtk-doc : utilisation de gtk-doc pour construire la documentation [par défaut=no],

note: (itstool) path: listitem/para
en: --enable-gtk-doc-html : build documentation in html format [default=yes]
fr: --enable-gtk-doc-html : construction de la documentation au format html [par défaut=yes],

note: (itstool) path: important/para
en: GTK-Doc is disabled by default! Remember to pass the option <option>'--enable-gtk-doc'</option> to the next <filename>configure</filename> run. Otherwise pregenerated documentation is installed (which makes sense for users but not for developers).
fr: GTK-Doc est désactivé par défaut ! N'oubliez pas de passer l'option <option>'--enable-gtk-doc'</option> lors de la prochaine exécution du script <filename>configure</filename>. Dans le cas contraire, la documentation pré-générée est installée (ce qui a du sens pour les utilisateurs mais pas pour les développeurs).

note: (itstool) path: example/title
en: Preparation for gtkdocize
fr: Préparation pour gtkdocize

note: (itstool) path: sect1/title
en: Integration with automake
fr: Intégration avec automake

note: (itstool) path: sect1/para
en: The next step is to edit the settings inside the <filename>Makefile.am</filename>. All the settings have a comment above that describes their purpose. Most settings are extra flags passed to the respective tools. Every tool has a variable of the form <option>&lt;TOOLNAME&gt;_OPTIONS</option>. All the tools support <option>--help</option> to list the supported parameters.
fr: L'étape suivante est de modifier les options dans le fichier <filename>Makefile.am</filename>. Toutes les options sont accompagnées d'un commentaire au-dessus qui explique leur fonction. La plupart des options sont des paramètres supplémentaires qui sont passés aux outils respectifs. Chaque outil possède une variable de la forme <option>&lt;NOM_DE_L_OUTIL&gt;_OPTIONS</option>. Tous les outils prennent en charge l'option <option>--help</option> qui affiche la liste des options prises en charge.

note: (itstool) path: sect1/title
en: Integration with autogen
fr: Intégration avec autogen

note: (itstool) path: sect1/para
en: Most projects will have an <filename>autogen.sh</filename> script to setup the build infrastructure after a checkout from version control system (such as cvs/svn/git). GTK-Doc comes with a tool called <application>gtkdocize</application> which can be used in such a script. It should be run before autoheader, automake or autoconf.
fr: La plupart des projets possède un script <filename>autogen.sh</filename> pour configurer l'infrastructure de compilation après un « checkout » depuis un système de gestion de versions (comme cvs/svn/git). GTK-Doc est livré avec un outil appelé <application>gtkdocize</application>, qui peut être utilisé dans un script comme celui-ci. Il doit être lancé avant autoheader, automake ou autoconf.

note: (itstool) path: example/title
en: Running gtkdocize from autogen.sh
fr: Exécution de gtkdocize depuis autogen.sh

note: (itstool) path: sect1/para
en: When running <application>gtkdocize</application> it copies <filename>gtk-doc.make</filename> to your project root (or any directory specified by the <option>--docdir</option> option). It also checks you configure script for the <function>GTK_DOC_CHECK</function> invocation. This macro can be used to pass extra parameters to <application>gtkdocize</application>.
fr: Lorsque <filename>gtkdocize</filename> est exécuté, il copie <filename>gtk-doc.make</filename> vers le répertoire racine de votre projet (ou tout autre répertoire désigné par l'option <option>--docdir</option>). Il vérifie également l'invocation de <function>GTK_DOC_CHECK</function> dans le script configure. Cette macro peut être utilisée pour transmettre des paramètres supplémentaires à <application>gtkdocize</application>.

note: (itstool) path: sect1/para
en: Historically GTK-Doc was generating template files where developers entered the docs. This turned out to be not so good (e.g. the need for having generated files under version control). Since GTK-Doc 1.9 the tools can get all the information from source comments and thus the templates can be avoided. We encourage people to keep documentation in the code. <application>gtkdocize</application> supports now a <option>--flavour no-tmpl</option> option that chooses a makefile that skips tmpl usage totally. Besides adding the option directly to the command invocation, they can be added also to an environment variable called <symbol>GTKDOCIZE_FLAGS</symbol> or set as a 2nd parameter in <symbol>GTK_DOC_CHECK</symbol> macro in the configure script. If you have never changed file in tmpl by hand and migrating from older gtkdoc versions, please remove the directory (e.g. from version control system).
fr: Historiquement, GTK-Doc générait des fichiers prototypes dans lesquels les développeurs saisissaient la documentation. Il s'est avéré que ce n'était pas une bonne idée (comme le besoin de placer les fichiers générés dans le gestionnaire de versions). Depuis GTK-Doc 1.9, les outils peuvent récupérer toutes les informations à partir des commentaires dans les sources, ce qui permet d'éviter d'avoir des prototypes. Nous vous encourageons à conserver la documentation dans le code. <application>gtkdocize</application> prend maintenant en charge une option <option>--flavour=no-tmpl</option> qui choisit un makefile qui s'affranchit totalement de l'utilisation des fichiers prototypes (tmpl). En plus d'ajouter les options directement au moment de l'appel de la commande, elles peuvent être ajoutées également dans une variable d'environnement appelée <symbol>GTKDOCIZE_FLAGS</symbol> ou choisies comme deuxième paramètre dans la macro <symbol>GTK_DOC_CHECK</symbol> dans le script de configuration. Si aucune modification n'a été faite à la main dans les fichiers prototypes et si vous migrez à partir d'anciennes versions de gtkdoc, supprimez le répertoire (par ex. à partir du système de gestion de versions).

note: (itstool) path: sect1/title (itstool) path: example/title
en: Running the doc build
fr: Lancement de la construction de la documentation

note: (itstool) path: sect1/para
en: After the previous steps it's time to run the build. First we need to rerun <filename>autogen.sh</filename>. If this script runs configure for you, then give it the <option>--enable-gtk-doc</option> option. Otherwise manually run <filename>configure</filename> with this option afterwards.
fr: Après toutes ces étapes, il est temps de lancer la construction. Tout d'abord, il faut relancer <filename>autogen.sh</filename>. Si ce script lance « configure » pour vous, alors il faut ajouter l'option <option>--enable-gtk-doc</option>, sinon lancez manuellement <filename>configure</filename> suivi de cette option.

note: (itstool) path: sect1/para
en: The first make run generates several additional files in the doc-directories. The important ones are: <filename>&lt;package&gt;.types</filename>, <filename>&lt;package&gt;-docs.xml</filename> (in the past .sgml), <filename>&lt;package&gt;-sections.txt</filename>.
fr: La première exécution de make génère plusieurs fichiers supplémentaires dans les répertoires de documentation (doc-directories). Les plus importants sont : <filename>&lt;paquet&gt;.types</filename>, <filename>&lt;paquet&gt;-docs.xml</filename> (anciennement .sgml), <filename>&lt;paquet&gt;-sections.txt</filename>.

note: (itstool) path: sect1/para
en: Now you can point your browser to <filename>docs/reference/&lt;package&gt;/index.html</filename>. Yes, it's a bit disappointing still. But hang-on, during the next chapter we tell you how to fill the pages with life.
fr: Maintenant, vous pouvez saisir l'adresse <filename>docs/reference/&lt;paquet&gt;/index.html</filename> dans votre navigateur. Le résultat est encore un peu décevant mais le prochain chapitre va expliquer comment donner de la vie à ces pages.

note: (itstool) path: sect1/title
en: Integration with version control systems
fr: Intégration avec des systèmes de gestion de versions

note: (itstool) path: sect1/title
en: Integration with plain makefiles or other build systems
fr: Intégration avec des « makefiles » simples et d'autres systèmes de compilation

note: (itstool) path: sect1/para
en: In the case one does not want to use automake and therefore <filename>gtk-doc.mak</filename> one will need to call the gtkdoc tools in the right order in own makefiles (or other build tools).
fr: Dans les cas où l'emploi de automake n'est pas souhaité et donc sans fichier <filename>gtk-doc.mak</filename>, il s'agit alors d'appeler les outils gtkdoc dans le bon ordre dans les fichiers « makefiles » ad hoc (ou d'autres systèmes).

note: (itstool) path: example/title
en: Documentation build steps
fr: Étapes de construction de la documentation

note: (itstool) path: sect1/para
en: One will need to look at the <filename>Makefile.am</filename> and <filename>gtk-doc.mak</filename> to pick the extra options needed.
fr: Il s'agit d'examiner les fichiers <filename>Makefile.am</filename> et <filename>gtk-doc.mak</filename> pour y trouver les options supplémentaires nécessaires.

note: (itstool) path: example/title
en: Example of using GTK-Doc from CMake
fr: Exemple d'utilisation de GTK-Doc depuis CMake

note: (itstool) path: sect1/para
en: The following example shows how to use this command. <_:example-1/>
fr: L'exemple suivant montre comment utiliser cette commande. <_:example-1/>

note: (itstool) path: chapter/title
en: Documenting the code
fr: Documentation du code

note: (itstool) path: chapter/para
en: GTK-Doc uses source code comment with a special syntax for code documentation. Further it retrieves information about your project structure from other sources. During the next section you will find all information about the syntax of the comments.
fr: GTK-Doc utilise les commentaires du code source, avec une syntaxe spéciale pour la documentation du code. En outre, il récupère des informations sur la structure de votre projet à partir d'autres sources. La section suivante vous donne toutes les informations concernant la syntaxe des commentaires.

note: (itstool) path: note/title
en: Documentation placement
fr: Emplacement de la documentation

note: (itstool) path: note/para
en: In the past most documentation had to be filled into files residing inside the <filename>tmpl</filename> directory. This has the disadvantages that the information is often not updated and also that the file tend to cause conflicts with version control systems.
fr: Par le passé, la plupart de la documentation devait être placé dans des fichiers dans le répertoire <filename>tmpl</filename>. Les inconvénients étaient que l'information n'était pas souvent mise à jour et que ces fichiers avaient tendance à provoquer des conflits avec les systèmes de gestion de versions.

note: (itstool) path: note/para
en: The avoid the aforementioned problems we suggest putting the documentation inside the sources. This manual will only describe this way of documenting code.
fr: Pour éviter ces problèmes, il est conseillé de placer la documentation dans le code source. Ce manuel ne décrit que cette manière de documenter du code.

note: (itstool) path: example/title
en: GTK-Doc comment block
fr: Bloc de commentaire GTK-Doc

note: (itstool) path: sect1/title
en: Documentation comments
fr: Commentaires de documentation

note: (itstool) path: sect1/para
en: A multiline comment that starts with an additional '*' marks a documentation block that will be processed by the GTK-Doc tools. <_:example-1/>
fr: Un commentaire multi-ligne qui commence avec un symbole « * » supplémentaire indique un bloc de documentation qui sera traité par les outils GTK-Doc. <_:example-1/>

note: (itstool) path: sect1/para
en: The 'identifier' is one line with the name of the item the comment is related to. The syntax differs a little depending on the item. (TODO add table showing identifiers)
fr: L'« identifier » (identifiant) est une ligne contenant le nom de l'élément avec lequel le commentaire est lié. La syntaxe diffère légèrement en fonction de l'élément. (À FAIRE : ajouter un tableau montrant les identifiants)

note: (itstool) path: listitem/para
en: What it is: The name for a class or function can sometimes be misleading for people coming from a different background.
fr: Ce que c'est : le nom d'une classe ou d'une fonction peut parfois être trompeur pour les personnes habituées à d'autres environnements.

note: (itstool) path: listitem/para
en: What it does: Tell about common uses. Put it in relation with the other API.
fr: Ce qu'il fait : indiquer les usages courants. À mettre en relation avec les autres API.

note: (itstool) path: tip/para
en: When documenting code, describe two aspects: <_:itemizedlist-1/>
fr: En documentant le code, deux aspects doivent être abordés : <_:itemizedlist-1/>

note: (itstool) path: listitem/para
en: Use function() to refer to functions or macros which take arguments.
fr: Utilisez fonction() pour vous référer à des fonctions ou des macros qui prennent des arguments.

note: (itstool) path: listitem/para
en: Use @param to refer to parameters. Also use this when referring to parameters of other functions, related to the one being described.
fr: Utilisez @paramètre pour vous référer aux paramètres. Utilisez-le aussi pour les paramètres d'autres fonctions, en relation avec celle décrite.

note: (itstool) path: listitem/para
en: Use %constant to refer to a constant, e.g. %G_TRAVERSE_LEAFS.
fr: Utilisez %constante pour vous référer à une constante, par ex. : %MA_CONSTANTE.

note: (itstool) path: listitem/para
en: Use #symbol to refer to other types of symbol, e.g. structs and enums and macros which don't take arguments.
fr: Utilisez #symbole pour vous référer à d'autres types de symbole. Par exemple des structures, énumérations ou macros qui ne prennent pas d'arguments.

note: (itstool) path: sect1/para
en: One advantage of hyper-text over plain-text is the ability to have links in the document. Writing the correct markup for a link can be tedious though. GTK-Doc comes to help by providing several useful abbreviations. <_:itemizedlist-1/>
fr: L'un des avantages de l'hypertexte par rapport au texte simple, c'est la possibilité d'avoir des liens dans les documents. Écrire correctement le balisage d'un lien peut être fastidieux. GTK-Doc fournit plusieurs raccourcis utiles pour vous aider. <_:itemizedlist-1/>

note: (itstool) path: tip/para
en: If you need to use the special characters '&lt;', '&gt;', '()', '@', '%', or '#' in your documentation without GTK-Doc changing them you can use the XML entities "&amp;lt;", "&amp;gt;", "&amp;lpar;", "&amp;rpar;", "&amp;commat;", "&amp;percnt;" and "&amp;num;" respectively or escape them with a backslash '\'.
fr: Si vous avez besoin d'utiliser les caractères spéciaux « '&lt;', '&gt; », « () », « @ », « % » ou « # » dans votre documentation sans que GTK-Doc ne les interprète, vous pouvez utiliser les entités XML « &amp;lt; », « &amp;gt; », « &amp;lpar; », « &amp;rpar; », « &amp;commat; », « &amp;percnt; », « &amp;num; » ou les échapper en les précédant d'un antislash « \ ».

note: (itstool) path: tip/para
en: As already mentioned earlier GTK-Doc is for documenting public API. Thus one cannot write documentation for static symbols. Nevertheless it is good to comment those symbols too. This helps other to understand you code. Therefore we recommend to comment these using normal comments (without the 2nd '*' in the first line). If later the function needs to be made public, all one needs to do is to add another '*' in the comment block and insert the symbol name at the right place inside the sections file.
fr: Comme indiqué plus tôt, GTK-Doc est fait pour documenter les API publiques. On ne peut donc pas écrire de la documentation pour les symboles statiques. Néanmoins, il est bon de commenter ces symboles aussi. Cela aide les autres à comprendre votre code. Par conséquent, nous recommandons de les documenter à l'aide de commentaires normaux (sans le second « * » à la première ligne). Si, plus tard, la fonction doit être rendue publique, il suffira juste d'ajouter un « * » dans le bloc de commentaires et d'ajouter le nom du symbole à la bonne place à l'intérieur du fichier des sections.

note: (itstool) path: sect1/title
en: Documenting sections
fr: Documentation des sections

note: (itstool) path: sect1/para
en: Each section of the documentation contains information about one class or module. To introduce the component one can write a section block. The short description is also used inside the table of contents. All the @fields are optional.
fr: Chaque section de la documentation contient des informations sur une classe ou un module. Pour introduire le composant, il est possible d'écrire un bloc de section. La description courte est également utilisée dans la table des matières. Tous les @champs sont facultatifs.

note: (itstool) path: example/title
en: Section comment block
fr: Bloc de commentaires de section

note: (itstool) path: varlistentry/term
en: SECTION:&lt;name&gt;
fr: SECTION:&lt;nom&gt;

note: (itstool) path: listitem/para
en: A one line description of the section, that later will appear after the links in the TOC and at the top of the section page.
fr: Une description de la section en une seule ligne, elle apparaîtra derrière les liens dans la table des matières et au début de la page de la section.

note: (itstool) path: listitem/para
en: The section title defaults to &lt;name&gt; from the SECTION declaration. It can be overridden with the @title field.
fr: Par défaut, la section titre est celle de la déclaration SECTION: &lt;nom&gt;. Elle peut être modifiée grâce au champ @title.

note: (itstool) path: listitem/para
en: Overrides the use of title as a section identifier. For GObjects the &lt;title&gt; is used as a section_id and for other sections it is &lt;MODULE&gt;-&lt;title&gt;.
fr: Remplace l'utilisation du titre comme identificateur de section. Pour GObjects, &lt;title&gt; est utilisé à la place de section_id et pour les autres sections, c'est &lt;MODULE&gt;-&lt;title&gt;.

note: (itstool) path: listitem/para
en: A list of symbols that are related to this section.
fr: Une liste de symboles qui ont un lien avec cette section.

note: (itstool) path: listitem/para
en: Stable - The intention of a Stable interface is to enable arbitrary third parties to develop applications to these interfaces, release them, and have confidence that they will run on all minor releases of the product (after the one in which the interface was introduced, and within the same major release). Even at a major release, incompatible changes are expected to be rare, and to have strong justifications.
fr: « Stable » - L'intention d'une interface stable est de permettre à des parties tierces de développer des applications pour ces interfaces, de les distribuer et d'avoir l'assurance qu'elles fonctionneront avec toutes les versions mineures du produit (après celle où l'interface a été introduite et pour le même numéro de version majeur). De plus, à chaque version majeure, les modifications incompatibles doivent être rares et être sérieusement justifiées.

note: (itstool) path: listitem/para
en: Unstable - Unstable interfaces are experimental or transitional. They are typically used to give outside developers early access to new or rapidly changing technology, or to provide an interim solution to a problem where a more general solution is anticipated. No claims are made about either source or binary compatibility from one minor release to the next.
fr: « Unstable » - Les interfaces instables sont expérimentales ou en transition. Elles sont généralement utilisées pour que les développeurs extérieurs aient un accès précoce aux technologies nouvelles ou en évolution rapide, ou de fournir une solution temporaire à un problème pour lequel une solution plus générale est prévue. Aucune exigence n'est demandée à propos de la compatibilité binaire ou de celle des sources, d'une version mineure à l'autre.

note: (itstool) path: listitem/para
en: Private - An interface that can be used within the GNOME stack itself, but that is not documented for end-users. Such functions should only be used in specified and documented ways.
fr: « Private » - C'est une interface qui peut être utilisée dans le noyau GNOME lui-même, mais qui n'est pas documentée pour les utilisateurs finaux. Ce type de fonctions ne doit être utilisé que dans des cas spécifiques et documentés.

note: (itstool) path: listitem/para
en: Internal - An interface that is internal to a module and does not require end-user documentation. Functions that are undocumented are assumed to be Internal.
fr: « Internal » - C'est une interface qui est interne à un module et qui ne nécessite pas de documentation pour l'utilisateur final. Les fonctions non documentées sont considérées comme internes.

note: (itstool) path: listitem/para
en: The <literal>#include</literal> files to show in the section synopsis (a comma separated list), overriding the global value from the <link linkend="metafiles_sections">section file</link> or command line. This item is optional.
fr: Les fichiers <literal>#include</literal> à afficher dans le résumé de la section (liste d'éléments séparés par des virgules), elle outrepasse la valeur globale du <link linkend="metafiles_sections">fichier de section</link> ou de la ligne de commande. Cet élément est facultatif.

note: (itstool) path: listitem/para
en: The image to display at the top of the reference page for this section. This will often be some sort of a diagram to illustrate the visual appearance of a class or a diagram of its relationship to other classes. This item is optional.
fr: L'image à afficher en haut de la page de référence pour cette section. C'est très souvent une espèce de diagramme pour illustrer l'apparence visuelle d'une classe ou un diagramme de ses relations avec d'autres classes. Cet élément est facultatif.

note: (itstool) path: tip/para
en: To avoid unnecessary recompilation after doc-changes put the section docs into the c-source where possible.
fr: Pour éviter des recompilations inutiles après des modifications de la documentation, placez la documentation de section dans les fichiers sources C, lorsque cela est possible.

note: (itstool) path: sect1/title
en: Documenting symbols
fr: Documentation des symboles

note: (itstool) path: sect1/para
en: Each symbol (function, macro, struct, enum, signal and property) is documented in a separate block. The block is best placed close to the definition of the symbols so that it is easy to keep them in sync. Thus functions are usually documented in the c-source and macros, structs and enums in the header file.
fr: Chaque symbole (fonction, macro, structure, énumération, signal et propriété) est documenté dans un bloc séparé. Il est mieux de placer le bloc près de la définition de son symbole pour faciliter sa synchronisation. Par conséquent, les fonctions sont habituellement documentées dans les fichiers sources C et les macros et les structures et les énumérations le sont dans le fichier d'en-tête.

note: (itstool) path: sect2/title (itstool) path: example/title
en: General tags
fr: Étiquettes générales

note: (itstool) path: sect2/para
en: You can add versioning information to all documentation elements to tell when an API was introduced, or when it was deprecated.
fr: Vous pouvez ajouter des informations de version à tous les éléments de documentation pour indiquer quand l'API a été introduite ou quand elle est devenue obsolète.

note: (itstool) path: variablelist/title
en: Versioning Tags
fr: Étiquettes de version

note: (itstool) path: varlistentry/term
en: Since:
fr: « Since »:

note: (itstool) path: listitem/para
en: Description since which version of the code the API is available.
fr: Texte indiquant depuis quelle version du code cette API est disponible.

note: (itstool) path: varlistentry/term
en: Deprecated:
fr: « Deprecated » :

note: (itstool) path: listitem/para
en: Paragraph denoting that this function should no be used anymore. The description should point the reader to the new API.
fr: Texte indiquant que cette fonction ne doit plus être utilisée. La description doit rediriger le lecteur vers la nouvelle API.

note: (itstool) path: sect2/title (itstool) path: example/title
en: Function comment block
fr: Bloc de commentaires pour les fonctions

note: (itstool) path: listitem/para
en: Document whether returned objects, lists, strings, etc, should be freed/unrefed/released.
fr: d'indiquer si les objets, listes, chaînes, etc. retournés doivent être freed/unfreed/released,

note: (itstool) path: listitem/para
en: Document whether parameters can be NULL, and what happens if they are.
fr: d'indiquer si les paramètres peuvent être NULL et ce qui se passe dans ce cas.

note: (itstool) path: listitem/para
en: Mention interesting pre-conditions and post-conditions where appropriate.
fr: Mentionner les pré-conditions et post-conditions intéressantes si nécessaire.

note: (itstool) path: sect2/para
en: Please remember to: <_:itemizedlist-1/>
fr: N'oubliez pas : <_:itemizedlist-1/>

note: (itstool) path: sect2/para
en: Gtk-doc assumes all symbols (macros, functions) starting with '_' are private. They are treated like static functions.
fr: GTK-Doc considère que tous les symboles (macros, fonctions) commençant par « _ » sont privés. Ils sont traités comme des fonctions statiques.

note: (itstool) path: variablelist/title
en: Function tags
fr: Étiquettes de fonction

note: (itstool) path: varlistentry/term
en: Returns:
fr: « Returns » :

note: (itstool) path: listitem/para
en: Paragraph describing the returned result.
fr: Paragraphe décrivant le résultat retourné.

note: (itstool) path: listitem/para
en: In case the function has variadic arguments, you should use this tag (@Varargs: does also work for historic reasons).
fr: Au cas où la fonction possède des arguments variables, vous devriez utiliser cette étiquette (@Varargs : peut également être utilisé pour des raisons historiques).

note: (itstool) path: sect2/title (itstool) path: example/title
en: Property comment block
fr: Bloc de commentaires pour les propriétés

note: (itstool) path: sect2/title (itstool) path: example/title
en: Signal comment block
fr: Bloc de commentaires pour les signaux

note: (itstool) path: listitem/para
en: Document when the signal is emitted and whether it is emitted before or after other signals.
fr: Documenter lorsque le signal est émis et s'il est émis avant ou après d'autres signaux,

note: (itstool) path: listitem/para
en: Document what an application might do in the signal handler.
fr: Documenter ce qu'une application pourrait faire dans le gestionnaire du signal.

note: (itstool) path: sect2/title (itstool) path: example/title
en: Struct comment block
fr: Bloc de commentaire pour les structures

note: (itstool) path: sect2/para
en: Use <code>/*&lt; private &gt;*/</code> before the private struct fields you want to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse behaviour.
fr: Utilisez <code>/*&lt; private &gt;*/</code> avant les champs de structures privées que vous voulez cacher. Utilisez <code>/*&lt; public &gt;*/</code> dans le cas contraire.

note: (itstool) path: sect2/para
en: Struct comment blocks can also be used for GObjects and GObjectClasses. It is usually a good idea to add a comment block for a class, if it has vmethods (as this is how they can be documented). For the GObject itself one can use the related section docs, having a separate block for the instance struct would be useful if the instance has public fields. One disadvantage here is that this creates two index entries of the same name (the structure and the section).
fr: Les blocs de commentaire pour les structures peuvent aussi être utilisés avec GObjects et GObjectClasses. Il est normalement recommandé d'ajouter un bloc de commentaire pour une classe, si elle contient des vmethods (car c'est la manière de les documenter). Pour GObject, il est possible d'utiliser la documentation de section correspondante ; la présence d'un bloc séparé pour la structure de l'instance serait utile si l'instance possède des champs publics. Le désavantage ici étant que cela crée deux entrées d'index pour le même nom (la structure et la section).

note: (itstool) path: sect2/title (itstool) path: example/title
en: Enum comment block
fr: Bloc de commentaire pour les énumérations

note: (itstool) path: sect2/para
en: Use <code>/*&lt; private &gt;*/</code> before the private enum values you want to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse behaviour.
fr: Utilisez <code>/*&lt; private &gt;*/</code> avant les valeurs d'énumérations privées que vous voulez cacher. Utilisez <code>/*&lt; public &gt;*/</code> dans le cas contraire.

note: (itstool) path: example/title
en: Program documentation block
fr: Bloc de documentation programme

note: (itstool) path: sect1/title
en: Useful DocBook tags
fr: Balises DocBook utiles

note: (itstool) path: sect1/para
en: Here are some DocBook tags which are most useful when documenting the code.
fr: Voici quelques balises DocBook très utiles pendant la conception de la documentation d'un code.

note: (itstool) path: sect1/para
en: To link to another section in the GTK docs: <_:informalexample-1/> The linkend is the SGML/XML id on the top item of the page you want to link to. For most pages this is currently the part ("gtk", "gdk", "glib") and then the page title ("Hash Tables"). For widgets it is just the class name. Spaces and underscores are converted to '-' to conform to SGML/XML.
fr: Pour créer un lien vers une autre section dans la documentation GTK : <_:informalexample-1/> l'élément « linkend » est l'identifiant SGML/XML de l'élément le plus haut sur la page vers laquelle vous voulez pointer. Pour la plupart des pages, c'est en général la partie (« gtk », « gdk », « glib ») suivi du titre de la page (« Hash Tables »). Pour les éléments graphiques, c'est simplement le nom de la classe. Les espaces et les caractères de soulignement sont convertis en « - » pour être conforme au SGML/XML.

note: (itstool) path: sect1/para
en: To refer to an external function, e.g. a standard C function: <_:informalexample-1/>
fr: Pour faire référence à une fonction externe comme, par exemple, à une fonction C standard : <_:informalexample-1/>

note: (itstool) path: sect1/para
en: To include example code: <_:informalexample-1/> or possibly this, for very short code fragments which don't need a title: <_:informalexample-2/> For the latter GTK-Doc also supports an abbreviation: |[ ... ]|
fr: Pour inclure des extraits de code : <_:informalexample-1/> ou ceci, pour des petits fragments de code qui ne nécessitent pas de titre : <_:informalexample-2/> Pour ces derniers, GTK-Doc prend également en charge une abréviation : |[ ...  ]|

note: (itstool) path: sect1/para
en: To include bulleted lists: <_:informalexample-1/>
fr: Pour ajouter une liste à puces : <_:informalexample-1/>

note: (itstool) path: sect1/para
en: To include a note which stands out from the text: <_:informalexample-1/>
fr: Pour ajouter une note de bas de page : <_:informalexample-1/>

note: (itstool) path: sect1/para
en: To refer to a type: <_:informalexample-1/>
fr: Pour se référer à un type : <_:informalexample-1/>

note: (itstool) path: sect1/para
en: To refer to an external structure (not one described in the GTK docs): <_:informalexample-1/>
fr: Pour se référer à une structure externe (non décrite dans la documentation GTK) : <_:informalexample-1/>

note: (itstool) path: sect1/para
en: To refer to a field of a structure: <_:informalexample-1/>
fr: Pour se référer à un champ d'une structure : <_:informalexample-1/>

note: (itstool) path: sect1/para
en: To refer to a class name, we could possibly use: <_:informalexample-1/> but you'll probably be using #GtkWidget instead (to automatically create a link to the GtkWidget page - see <link linkend="documenting_syntax">the abbreviations</link>).
fr: Pour se référer au nom d'une classe, il est possible d'utiliser : <_:informalexample-1/> mais vous utiliserez probablement #GtkWidget à la place (pour créer automatiquement un lien vers la page GtkWidget - consultez <link linkend="documenting_syntax">les raccourcis</link>).

note: (itstool) path: sect1/para
en: To emphasize text: <_:informalexample-1/>
fr: Pour mettre en évidence un texte : <_:informalexample-1/>

note: (itstool) path: sect1/para
en: For filenames use: <_:informalexample-1/>
fr: Pour les noms de fichiers : <_:informalexample-1/>

note: (itstool) path: sect1/para
en: To refer to keys use: <_:informalexample-1/>
fr: Pour se référer à des touches : <_:informalexample-1/>

note: (itstool) path: chapter/title
en: Filling the extra files
fr: Remplissage des fichiers supplémentaires

note: (itstool) path: chapter/para
en: There are a couple of extra files, that need to be maintained along with the inline source code comments: <filename>&lt;package&gt;.types</filename>, <filename>&lt;package&gt;-docs.xml</filename> (in the past .sgml), <filename>&lt;package&gt;-sections.txt</filename>.
fr: Il y a plusieurs fichiers supplémentaires, qui ont besoin d'être maintenus en parallèle aux commentaires dans le code source : <filename>&lt;package&gt;.types</filename>, <filename>&lt;package&gt;-docs.xml</filename> (anciennement .sgml), <filename>&lt;package&gt;-sections.txt</filename>.

note: (itstool) path: sect1/title
en: Editing the types file
fr: Édition des fichiers types

note: (itstool) path: example/title
en: Example types file snippet
fr: Extrait d'un exemple de fichiers types

note: (itstool) path: sect1/para
en: Since GTK-Doc 1.8 <application>gtkdoc-scan</application> can generate this list for you. Just add "--rebuild-types" to SCAN_OPTIONS in <filename>Makefile.am</filename>. If you use this approach you should not dist the types file nor have it under version control.
fr: Depuis GTK-Doc 1.8, <application>gtkdoc-scan</application> peut générer cette liste pour vous. Ajoutez simplement l'option « --rebuild-types » à SCAN_OPTIONS dans le fichier <filename>Makefile.am</filename>. Si vous utilisez cette approche vous ne devriez pas distribuer le fichier « types », ni l'avoir dans le système de gestion de versions.

note: (itstool) path: sect1/title
en: Editing the master document
fr: Édition du document maître

note: (itstool) path: sect1/para
en: GTK-Doc produces documentation in DocBook SGML/XML. When processing the inline source comments, the GTK-Doc tools generate one documentation page per class or module as a separate file. The master document includes them and place them in an order.
fr: GTK-Doc génère de la documentation au format SGML/XML DocBook. Lors du traitement des commentaires dans les fichiers sources, les outils GTK-Doc génèrent une page de documentation par classe ou par module dans un fichier séparé. Le document maître les inclut et les place dans l'ordre.

note: (itstool) path: tip/para
en: Do not create tutorials as extra documents. Just write extra chapters. The benefit of directly embedding the tutorial for your library into the API documentation is that it is easy to link for the tutorial to symbol documentation. Apart chances are higher that the tutorial gets updates along with the library.
fr: Ne créez pas de tutoriels comme documents supplémentaires. Écrivez juste des chapitres supplémentaires. L'avantage d'inclure le tutoriel de votre bibliothèque directement dans la documentation de l'API est qu'il est facile d'y ajouter des liens qui pointent vers la documentation des symboles. De plus, il y aura plus de chance que votre tutoriel soit mis à jour en même temps que la bibliothèque.

note: (itstool) path: sect1/para
en: So what are the things to change inside the master document? For a start is only a little. There are some placeholders (text in square brackets) there which you should take care of.
fr: Alors, quelles sont les choses à modifier dans le document maître ? Pour commencer, très peu de choses. Il n'y a quelques paramètres substituables (texte entre crochets) que vous devrez prendre en charge.

note: (itstool) path: example/title
en: Master document header
fr: En-tête du document maître

note: (itstool) path: example/title
en: Optional part in the master document
fr: Partie optionnelle dans le document maître

note: (itstool) path: sect1/title
en: Editing the section file
fr: Édition du fichier section

note: (itstool) path: sect1/para
en: The section file is used to organise the documentation output by GTK-Doc. Here one specifies which symbol belongs to which module or class and control the visibility (public or private).
fr: Le fichier section est utilisé pour organiser la documentation générée par GTK-Doc. C'est ici qu'il faut indiquer quels symboles sont attachés à quels modules ou classes et contrôler la visibilité (« public » ou « private »).

note: (itstool) path: sect1/para
en: The &lt;TITLE&gt; ... &lt;/TITLE&gt; tag is used to specify the title of the section. It is only useful before the templates (if used) are initially created, since the title set in the template file overrides this. Also if one uses SECTION comment in the sources, this is obsolete.
fr: La balise &lt;TITLE&gt; ... &lt;/TITLE&gt; est utilisée pour indiquer le titre de la section. C'est utile seulement avant la création initiale des prototypes, car ensuite le titre défini dans le prototype est prioritaire. Elle est également obsolète si des commentaires de SECTION sont utilisés dans les fichiers sources.

note: (itstool) path: sect1/para
en: You can also use &lt;INCLUDE&gt; ... &lt;/INCLUDE&gt; to specify the #include files which are shown in the synopsis sections. It contains a comma-separate list of #include files, without the angle brackets. If you set it outside of any sections, it acts for all sections until the end of the file. If you set it within a section, it only applies to that section.
fr: Vous pouvez utiliser les balises &lt;INCLUDE&gt; ... &lt;/INCLUDE&gt; pour indiquer les fichiers #include qui sont affichés dans les sections résumé. Elles contiennent une liste de fichiers #include, séparés par des virgules, sans les chevrons. Si vous les placez en dehors d'une section, elles s'appliquent à toutes les sections jusqu'à la fin du fichier. Si vous les placez dans une section, elles s'appliquent seulement à cette section.

note: (itstool) path: chapter/title
en: Controlling the result
fr: Contrôle du résultat

note: (itstool) path: chapter/para
en: A GTK-Doc run generates report files inside the documentation directory. The generated files are named: <filename>&lt;package&gt;-undocumented.txt</filename>, <filename>&lt;package&gt;-undeclared.txt</filename> and <filename>&lt;package&gt;-unused.txt</filename>. All those are plain text files that can be viewed and postprocessed easily.
fr: Une exécution de GTK-Doc produit des fichiers de compte-rendu dans le répertoire de documentation. Ces fichiers sont nommés : <filename>&lt;package&gt;-undocumented.txt</filename>, <filename>&lt;package&gt;-undeclared.txt</filename> et <filename>&lt;package&gt;-unused.txt</filename>. Tous ces fichiers texte peuvent être lus et post-traités facilement.

note: (itstool) path: chapter/para
en: The <filename>&lt;package&gt;-undocumented.txt</filename> file starts with the documentation coverage summary. Below are two sections divided by blank lines. The first section lists undocumented or incomplete symbols. The second section does the same for section docs. Incomplete entries are those, which have documentation, but where e.g. a new parameter has been added.
fr: Le fichier <filename>&lt;package&gt;-undocumented.txt</filename> commence avec un résumé du sujet couvert par la documentation. Suivent deux sections séparées par des lignes blanches. La première section liste les symboles non documentés ou incomplets. La seconde section fait de même pour les documentations de sections. Les éléments incomplets sont ceux qui possèdent une documentation mais auxquels, par exemple, un paramètre a été ajouté.

note: (itstool) path: chapter/para
en: The <filename>&lt;package&gt;-undeclared.txt</filename> file lists symbols given in the <filename>&lt;package&gt;-sections.txt</filename> but not found in the sources. Check if they have been removed or if they are misspelled.
fr: Le fichier <filename>&lt;package&gt;-undeclared.txt</filename> liste les symboles contenus dans le fichier <filename>&lt;package&gt;-sections.txt</filename> mais non trouvés dans les fichiers sources. Vérifiez s'ils n'ont pas été supprimés ou mal orthographiés.

note: (itstool) path: chapter/para
en: The <filename>&lt;package&gt;-unused.txt</filename> file lists symbol names, where the GTK-Doc scanner has found documentation, but does not know where to put it. This means that the symbol has not yet been added to the <filename>&lt;package&gt;-sections.txt</filename> file.
fr: Le fichier <filename>&lt;package&gt;-unused.txt</filename> liste les noms des symboles pour lesquels l'analyseur GTK-Doc a trouvé de la documentation mais ne sait pas où la placer. Cela signifie que le symbole n'a pas encore été ajouté au fichier <filename>&lt;package&gt;-sections.txt</filename>.

note: (itstool) path: tip/para
en: Enable or add the <option>TESTS=$(GTKDOC_CHECK)</option> line in Makefile.am. If at least GTK-Doc 1.9 is installed, this will run sanity checks during <command>make check</command> run.
fr: Activez ou ajoutez la ligne <option>TESTS=($GTKDOC_CHECK)</option> dans le fichier Makefile.am. Si la version installée de GTK-Doc est supérieure à 1.9, des contrôles de validité seront lancés pendant l'exécution de <command>make check</command>.

note: (itstool) path: chapter/title
en: Modernizing the documentation
fr: Modernisation de la documentation

note: (itstool) path: sect1/title
en: GTK-Doc 1.9
fr: Manuel de GTK-Doc 1.9

note: (itstool) path: sect1/title
en: GTK-Doc 1.10
fr: Manuel de GTK-Doc 1.10

note: (itstool) path: sect1/title
en: GTK-Doc 1.16
fr: Manuel de GTK-Doc 1.16

note: (itstool) path: sect1/title
en: GTK-Doc 1.20
fr: Manuel de GTK-Doc 1.20

note: (itstool) path: sect1/title
en: GTK-Doc 1.25
fr: Manuel de GTK-Doc 1.25

note: (itstool) path: chapter/title
en: Documenting other interfaces
fr: Documentation d'autres interfaces

note: (itstool) path: chapter/para
en: So far we have been using GTK-Doc to document the API of code. The next sections contain suggestions how the tools can be used to document other interfaces too.
fr: Nous avons jusqu'ici utilisé GTK-Doc pour documenter les API du code. Les sections qui suivent contiennent des suggestions sur la manière d'utiliser les outils pour documenter aussi d'autres interfaces.

note: (itstool) path: sect1/title
en: Command line options and man pages
fr: Options de ligne de commande et pages de manuel

note: (itstool) path: sect1/para
en: As one can generate man pages for a docbook refentry as well, it sounds like a good idea to use it for that purpose. This way the interface is part of the reference and one gets the man-page for free.
fr: Comme il est possible de générer aussi des pages de manuel à partir d'une « refentry » DocBook, il semble donc intéressant de l'utiliser dans ce but. Ainsi, l'interface fait partie de la référence et l'on obtient en cadeau la page de manuel.

note: (itstool) path: sect2/title
en: Document the tool
fr: Documentation de l'outil

note: (itstool) path: sect2/para
en: Create one refentry file per tool. Following <link linkend="settingup_docfiles">our example</link> we would call it <filename>meep/docs/reference/meeper/meep.xml</filename>. For the xml tags that should be used and can look at generated file in the xml subdirectory as well as examples e.g. in glib.
fr: Créez un fichier « refentry » par outil. En suivant <link linkend="settingup_docfiles">notre exemple</link>, nous l'appellerons <filename>meep/docs/reference/meeper/meep.xml</filename>. Pour connaître les balises XML pouvant être utilisées, on peut observer le fichier généré dans le sous-répertoire xml ou des exemples comme dans glib.

note: (itstool) path: sect2/title
en: Adding the extra configure check
fr: Ajout de contrôles « configure » supplémentaires

note: (itstool) path: example/title
en: Extra configure checks
fr: Contrôles « configure » supplémentaires

note: (itstool) path: sect2/title
en: Adding the extra makefile rules
fr: Ajout de règles « makefile » supplémentaires

note: (itstool) path: sect1/title
en: DBus interfaces
fr: Interfaces DBus

note: (itstool) path: sect1/para
en: (FIXME: http://hal.freedesktop.org/docs/DeviceKit/DeviceKit.html, http://cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)
fr: (À_CORRIGER : http://hal.freedesktop.org/docs/DeviceKit/DeviceKit.html, http://cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)

note: (itstool) path: chapter/title
en: Frequently asked questions
fr: Foire aux questions

note: (itstool) path: segmentedlist/segtitle
en: Answer
fr: Réponse

note: (itstool) path: seglistitem/seg
en: No class hierarchy.
fr: Pas de hiérarchie de classe.

note: (itstool) path: seglistitem/seg
en: The objects <function>xxx_get_type()</function> function has not been entered into the <filename>&lt;package&gt;.types</filename> file.
fr: Les fonctions objet <function>xxx_get_type()</function> n'ont pas été saisies dans le fichier <filename>&lt;module&gt;.types</filename>.

note: (itstool) path: seglistitem/seg
en: Still no class hierarchy.
fr: Toujours pas de hiérarchie de classe.

note: (itstool) path: seglistitem/seg
en: Missing or wrong naming in <filename>&lt;package&gt;-sections.txt</filename> file (see <ulink url="http://mail.gnome.org/archives/gtk-doc-list/2003-October/msg00006.html">explanation</ulink>).
fr: Mauvais nom ou nom absent dans le fichier <filename>&lt;module&gt;-sections.txt</filename> (consultez une <ulink url="http://mail.gnome.org/archives/gtk-doc-list/2003-October/msg00006.html">explication</ulink>).

note: (itstool) path: seglistitem/seg
en: Damn, I have still no class hierarchy.
fr: Zut, je n'ai toujours pas de hiérarchie de classe.

note: (itstool) path: seglistitem/seg
en: Is the object name (name of the instance struct, e.g. <type>GtkWidget</type>) part of the normal section (don't put this into Standard or Private subsections).
fr: Est-ce que le nom de l'objet (nom de la structure de l'instance, par ex. <type>GtkWidget</type>) fait parti de la section « normal » (ne pas le mettre dans les sous-sections « Standard » ou « Private »).

note: (itstool) path: seglistitem/seg
en: No symbol index.
fr: Pas d'index des symboles.

note: (itstool) path: seglistitem/seg
en: Does the <filename>&lt;package&gt;-docs.{xml,sgml}</filename> contain a index that xi:includes the generated index?
fr: Est-ce que <filename>&lt;module&gt;-docs.{xml,sgml}</filename> contient un index qui « xi:includes » l'index généré ?

note: (itstool) path: seglistitem/seg
en: Symbols are not linked to their doc-section.
fr: Les symboles ne sont pas liés à leur section de documentation.

note: (itstool) path: seglistitem/seg
en: Is the doc-comment using the correct markup (added #,% or ())? Check if the gtkdoc-fixxref warns about unresolvable xrefs.
fr: Est-ce que doc-comment utilise le markup correct (ajout d'un #, % ou ()) ? Contrôlez si gtkdoc-fixxref affiche des avertissements à propos de xrefs non résolus.

note: (itstool) path: seglistitem/seg
en: A new class does not appear in the docs.
fr: Une nouvelle classe n'apparaît pas dans les documents.

note: (itstool) path: seglistitem/seg
en: Is the new page xi:included from <filename>&lt;package&gt;-docs.{xml,sgml}</filename>.
fr: Est-ce que la nouvelle page est xi:included à partir de <filename>&lt;module&gt;-docs.{xml,sgml}</filename>.

note: (itstool) path: seglistitem/seg
en: A new symbol does not appear in the docs.
fr: Un nouveau symbole n'apparaît pas dans les documents.

note: (itstool) path: seglistitem/seg
en: Is the doc-comment properly formatted. Check for spelling mistakes in the begin of the comment. Check if the gtkdoc-fixxref warns about unresolvable xrefs. Check if the symbol is correctly listed in the <filename>&lt;package&gt;-sections.txt</filename> in a public subsection.
fr: Est-ce que le doc-comment est correctement formaté. Vérifiez qu'il n'y a pas d'erreur de frappe au début du commentaire. Vérifiez que gtkdoc-fixxref ne vous indique pas de xrefs non résolus. Vérifiez que le symbole est correctement listé dans une section publique de <filename>&lt;module&gt;-sections.txt</filename>.

note: (itstool) path: seglistitem/seg
en: A type is missing from the class hierarchy.
fr: Un type est absent dans la hiérarchie de classe.

note: (itstool) path: seglistitem/seg
en: I get foldoc links for all gobject annotations.
fr: J'obtiens des liens foldoc pour toutes les annotations gobject.

note: (itstool) path: seglistitem/seg
en: Check that <filename>xml/annotation-glossary.xml</filename> is xi:included from <filename>&lt;package&gt;-docs.{xml,sgml}</filename>.
fr: Vérifiez que <filename>xml/annotation-glossary.xml</filename> est xi:included à partir de <filename>&lt;module&gt;-docs.{xml,sgml}</filename>.

note: (itstool) path: seglistitem/seg
en: Parameter described in source code comment block but does not exist
fr: Un paramètre est décrit dans le bloc de commentaires dans le code source mais il n'existe pas.

note: (itstool) path: seglistitem/seg
en: Check if the prototype in the header has different parameter names as in the source.
fr: Vérifiez si le prototype dans le fichier d'en-tête possède des noms de paramètres différents de ceux du fichier source.

note: (itstool) path: seglistitem/seg
en: multiple "IDs" for constraint linkend: XYZ
fr: « ID » multiples pour le linkend: XYZ contraint

note: (itstool) path: seglistitem/seg
en: Symbol XYZ appears twice in <filename>&lt;package&gt;-sections.txt</filename> file.
fr: Le symbole XYZ apparaît en double dans le fichier <filename>&lt;package&gt;-sections.txt</filename>.

note: (itstool) path: seglistitem/seg
en: Element typename in namespace '' encountered in para, but no template matches.
fr: Élément typename dans l'espace de nom '' rencontré dans para mais aucun prototype ne correspond.

note: (itstool) path: chapter/title
en: Tools related to gtk-doc
fr: Outils liés à gtk-doc

note: (itstool) path: chapter/para
en: GtkDocPlugin - a <ulink url="http://trac-hacks.org/wiki/GtkDocPlugin">Trac GTK-Doc</ulink> integration plugin, that adds API docs to a trac site and integrates with the trac search.
fr: GtkDocPlugin - un greffon d'intégration à <ulink url="http://trac-hacks.org/wiki/GtkDocPlugin">Trac GTK-Doc</ulink>, qui ajoute la documentation d'API à un site Trac et s'intègre à la recherche Trac.

note: (itstool) path: appendixinfo/releaseinfo
en: Version 1.1, March 2000
fr: Version 1.1, mars 2000

note: (itstool) path: legalnotice/para
en: <_:address-1/> Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
fr: <_:address-1/> Chacun est libre de copier et de distribuer des copies conformes de cette Licence, mais nul n'est autorisé à la modifier.

note: (itstool) path: appendix/title (itstool) path: para/quote
en: GNU Free Documentation License
fr: Licence de Documentation Libre GNU

note: (itstool) path: sect1/title
en: 0. PREAMBLE
fr: 0. Préambule

note: (itstool) path: sect1/para
en: The purpose of this License is to make a manual, textbook, or other written document <quote>free</quote> in the sense of freedom: to assure everyone the effective freedom to copy and redistribute it, with or without modifying it, either commercially or noncommercially. Secondarily, this License preserves for the author and publisher a way to get credit for their work, while not being considered responsible for modifications made by others.
fr: L'objet de cette Licence est de rendre tout manuel, livre ou autre document écrit <quote>libre</quote> au sens de la liberté d'utilisation, à savoir : assurer à chacun la liberté effective de le copier ou de le redistribuer, avec ou sans modifications, commercialement ou non. En outre, cette Licence garantit à l'auteur et à l'éditeur la reconnaissance de leur travail, sans qu'ils soient pour autant considérés comme responsables des modifications réalisées par des tiers.

note: (itstool) path: sect1/para
en: This License is a kind of <quote>copyleft</quote>, which means that derivative works of the document must themselves be free in the same sense. It complements the GNU General Public License, which is a copyleft license designed for free software.
fr: Cette Licence est une sorte de <quote>copyleft</quote>, ce qui signifie que les travaux dérivés du document d'origine sont eux-mêmes « libres » selon les mêmes termes. Elle complète la Licence Publique Générale GNU, qui est également une Licence copyleft, conçue pour les logiciels libres.

note: (itstool) path: sect1/para
en: We have designed this License in order to use it for manuals for free software, because free software needs free documentation: a free program should come with manuals providing the same freedoms that the software does. But this License is not limited to software manuals; it can be used for any textual work, regardless of subject matter or whether it is published as a printed book. We recommend this License principally for works whose purpose is instruction or reference.
fr: Nous avons conçu cette Licence pour la documentation des logiciels libres, car les logiciels libres ont besoin d'une documentation elle-même libre : un logiciel libre doit être accompagné d'un manuel garantissant les mêmes libertés que celles accordées par le logiciel lui-même. Mais cette Licence n'est pas limitée aux seuls manuels des logiciels ; elle peut être utilisée pour tous les documents écrits, sans distinction particulière relative au sujet traité ou au mode de publication. Nous recommandons l'usage de cette Licence principalement pour les travaux destinés à des fins d'enseignement ou devant servir de documents de référence.

note: (itstool) path: sect1/title
en: 1. APPLICABILITY AND DEFINITIONS
fr: 1. APPLICABILITÉ ET DÉFINITIONS

note: (itstool) path: sect1/para
en: This License applies to any manual or other work that contains a notice placed by the copyright holder saying it can be distributed under the terms of this License. The <quote>Document</quote>, below, refers to any such manual or work. Any member of the public is a licensee, and is addressed as <quote>you</quote>.
fr: Cette Licence couvre tout manuel ou tout autre travail écrit contenant une notice de copyright autorisant la redistribution selon les termes de cette Licence. Le mot <quote>Document</quote> se réfère ci-après à un tel manuel ou travail. Toute personne en est par définition concessionnaire et est référencée ci-après par le terme <quote>Vous</quote>.

note: (itstool) path: sect1/para
en: A <quote>Modified Version</quote> of the Document means any work containing the Document or a portion of it, either copied verbatim, or with modifications and/or translated into another language.
fr: Une <quote>Version modifiée</quote> du Document désigne tout travail en contenant la totalité ou seulement une portion de celui-ci, copiée mot pour mot, modifiée et/ou traduite dans une autre langue.

note: (itstool) path: sect1/para
en: A <quote>Secondary Section</quote> is a named appendix or a front-matter section of the <link linkend="fdl-document">Document</link> that deals exclusively with the relationship of the publishers or authors of the Document to the Document's overall subject (or to related matters) and contains nothing that could fall directly within that overall subject. (For example, if the Document is in part a textbook of mathematics, a Secondary Section may not explain any mathematics.) The relationship could be a matter of historical connection with the subject or with related matters, or of legal, commercial, philosophical, ethical or political position regarding them.
fr: Une <quote>Section secondaire</quote> désigne une annexe au <link linkend="fdl-document">Document</link>, ou toute information indiquant les rapports entre l'auteur ou l'éditeur et le sujet (ou tout autre sujet connexe) du Document, sans toutefois être en rapport direct avec le sujet lui-même (par exemple, si le Document est un manuel de mathématiques, une Section secondaire ne traitera d'aucune notion mathématique). Cette section peut contenir des informations relatives à l'historique du Document, des sources documentaires, des dispositions légales, commerciales, philosophiques, ou des positions éthiques ou politiques susceptibles de concerner le sujet traité.

note: (itstool) path: sect1/para
en: The <quote>Invariant Sections</quote> are certain <link linkend="fdl-secondary"> Secondary Sections</link> whose titles are designated, as being those of Invariant Sections, in the notice that says that the <link linkend="fdl-document">Document</link> is released under this License.
fr: Les <quote>Sections inaltérables</quote> sont des <link linkend="fdl-secondary">sections secondaires</link> considérées comme ne pouvant être modifiées et citées comme telles dans la notice légale qui place le <link linkend="fdl-document">Document</link> sous cette Licence.

note: (itstool) path: sect1/para
en: The <quote>Cover Texts</quote> are certain short passages of text that are listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says that the <link linkend="fdl-document">Document</link> is released under this License.
fr: Les <quote>Textes de couverture</quote> sont les textes courts situés sur les pages de couverture avant et arrière du <link linkend="fdl-document">Document</link>, et cités comme tels dans la mention légale de ce <link linkend="fdl-document">Document</link>.

note: (itstool) path: sect1/para
en: A <quote>Transparent</quote> copy of the <link linkend="fdl-document"> Document</link> means a machine-readable copy, represented in a format whose specification is available to the general public, whose contents can be viewed and edited directly and straightforwardly with generic text editors or (for images composed of pixels) generic paint programs or (for drawings) some widely available drawing editor, and that is suitable for input to text formatters or for automatic translation to a variety of formats suitable for input to text formatters. A copy made in an otherwise Transparent file format whose markup has been designed to thwart or discourage subsequent modification by readers is not Transparent. A copy that is not <quote>Transparent</quote> is called <quote>Opaque</quote>.
fr: Le terme <quote>Copie transparente</quote> désigne une version numérique du <link linkend="fdl-document"> Document</link> représentée dans un format dont les spécifications sont publiquement disponibles et dont le contenu peut être visualisé et édité directement et immédiatement par un éditeur de texte quelconque, ou (pour les images composées de pixels) par un programme de traitement d'images quelconque, ou (pour les dessins) par un éditeur de dessins courant. Ce format doit pouvoir être accepté directement ou être convertible facilement dans des formats utilisables directement par des logiciels de formatage de texte. Une copie publiée dans un quelconque format numérique ouvert mais dont la structure a été conçue dans le but exprès de prévenir les modifications ultérieures du Document ou dans le but d'en décourager les lecteurs n'est pas considérée comme une Copie Transparente. Une copie qui n'est pas <quote>Transparente</quote> est considérée, par opposition, comme <quote>Opaque</quote>.

note: (itstool) path: sect1/para
en: Examples of suitable formats for Transparent copies include plain ASCII without markup, Texinfo input format, LaTeX input format, SGML or XML using a publicly available DTD, and standard-conforming simple HTML designed for human modification. Opaque formats include PostScript, PDF, proprietary formats that can be read and edited only by proprietary word processors, SGML or XML for which the DTD and/or processing tools are not generally available, and the machine-generated HTML produced by some word processors for output purposes only.
fr: Le format de fichier texte codé en ASCII générique et n'utilisant pas de balises, les formats de fichiers Texinfo ou LaTeX, les formats de fichiers SGML ou XML utilisant une DTD publiquement accessible, ainsi que les formats de fichiers HTML simple et standard, écrits de telle sorte qu'ils sont modifiables sans outil spécifique, sont des exemples de formats acceptables pour la réalisation de Copies Transparentes. Les formats suivants sont opaques : PostScript, PDF, formats de fichiers propriétaires qui ne peuvent être visualisés ou édités que par des traitements de textes propriétaires, SGML et XML utilisant des DTD et/ou des outils de formatage qui ne sont pas disponibles publiquement, et du code HTML généré par une machine à l'aide d'un traitement de texte quelconque et dans le seul but de la génération d'un format de sortie.

note: (itstool) path: sect1/para
en: The <quote>Title Page</quote> means, for a printed book, the title page itself, plus such following pages as are needed to hold, legibly, the material this License requires to appear in the title page. For works in formats which do not have any title page as such, <quote>Title Page</quote> means the text near the most prominent appearance of the work's title, preceding the beginning of the body of the text.
fr: La <quote>Page de titre</quote> désigne, pour les ouvrages imprimés, la page de titre elle-même, ainsi que les pages supplémentaires nécessaires pour fournir clairement les informations dont cette Licence impose la présence sur la page de titre. Pour les travaux n'ayant pas de Page de titre comme décrit ci-dessus, la <quote>Page de titre</quote> désigne le texte qui s'apparente le plus au titre du document et situé avant le texte principal.

note: (itstool) path: sect1/title
en: 2. VERBATIM COPYING
fr: 2. COPIES CONFORMES

note: (itstool) path: sect1/para
en: You may copy and distribute the <link linkend="fdl-document">Document</link> in any medium, either commercially or noncommercially, provided that this License, the copyright notices, and the license notice saying this License applies to the Document are reproduced in all copies, and that you add no other conditions whatsoever to those of this License. You may not use technical measures to obstruct or control the reading or further copying of the copies you make or distribute. However, you may accept compensation in exchange for copies. If you distribute a large enough number of copies you must also follow the conditions in <link linkend="fdl-section3">section 3</link>.
fr: Vous pouvez copier et distribuer le <link linkend="fdl-document">Document</link> sur tout type de support, commercialement ou non, à condition que cette Licence, la notice de copyright et la notice de la Licence indiquant que cette Licence s'applique à ce Document soient reproduits dans toutes les copies, et que vous n'y ajoutiez aucune condition restrictive supplémentaire. Vous ne pouvez pas utiliser un quelconque moyen technique visant à empêcher ou à contrôler la lecture ou la reproduction ultérieure des copies que vous avez créées ou distribuées. Toutefois, vous pouvez solliciter une rétribution en échange des copies. Si vous distribuez une grande quantité de copies, référez-vous aux dispositions de la <link linkend="fdl-section3">section 3</link>.

note: (itstool) path: sect1/para
en: You may also lend copies, under the same conditions stated above, and you may publicly display copies.
fr: Vous pouvez également prêter des copies, sous les mêmes conditions que celles suscitées, et vous pouvez afficher publiquement des copies de ce Document.

note: (itstool) path: sect1/title
en: 3. COPYING IN QUANTITY
fr: 3. COPIES EN NOMBRE

note: (itstool) path: sect1/para
en: If you publish printed copies of the <link linkend="fdl-document">Document</link> numbering more than 100, and the Document's license notice requires <link linkend="fdl-cover-texts">Cover Texts</link>, you must enclose the copies in covers that carry, clearly and legibly, all these Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on the back cover. Both covers must also clearly and legibly identify you as the publisher of these copies. The front cover must present the full title with all words of the title equally prominent and visible. You may add other material on the covers in addition. Copying with changes limited to the covers, as long as they preserve the title of the <link linkend="fdl-document">Document</link> and satisfy these conditions, can be treated as verbatim copying in other respects.
fr: Si vous publiez des copies imprimées de ce <link linkend="fdl-document">Document</link> à plus de 100 exemplaires et que la Licence du Document indique la présence de <link linkend="fdl-cover-texts">Textes de couverture</link>, vous devez fournir une couverture pour chaque copie, qui présente les Textes de couverture des première et dernière pages de couverture du Document. Les première et dernière pages de couverture doivent également vous identifier clairement et sans ambiguïté comme étant l'éditeur de ces copies. La première page de couverture doit comporter le titre du Document en mots d'importance et de visibilité égales. Vous pouvez ajouter des informations complémentaires sur les pages de couverture. Les copies du Document dont seule la couverture a été modifiée peuvent être considérées comme des copies conformes, à condition que le titre du <link linkend="fdl-document">Document</link> soit préservé et que les conditions indiquées précédemment soient respectées.

note: (itstool) path: sect1/para
en: If the required texts for either cover are too voluminous to fit legibly, you should put the first ones listed (as many as fit reasonably) on the actual cover, and continue the rest onto adjacent pages.
fr: Si les textes devant se trouver sur la couverture sont trop importants pour y tenir de manière claire, vous pouvez ne placer que les premiers sur la première page et placer les suivants sur les pages consécutives.

note: (itstool) path: sect1/para
en: If you publish or distribute <link linkend="fdl-transparent">Opaque</link> copies of the <link linkend="fdl-document">Document</link> numbering more than 100, you must either include a machine-readable <link linkend="fdl-transparent">Transparent</link> copy along with each Opaque copy, or state in or with each Opaque copy a publicly-accessible computer-network location containing a complete Transparent copy of the Document, free of added material, which the general network-using public has access to download anonymously at no charge using public-standard network protocols. If you use the latter option, you must take reasonably prudent steps, when you begin distribution of Opaque copies in quantity, to ensure that this Transparent copy will remain thus accessible at the stated location until at least one year after the last time you distribute an Opaque copy (directly or through your agents or retailers) of that edition to the public.
fr: Si vous publiez plus de 100 <link linkend="fdl-transparent">Copies opaques</link> du <link linkend="fdl-document">Document</link>, vous devez soit fournir une Copie transparente pour chaque Copie opaque, soit préciser ou fournir avec chaque Copie opaque une adresse réseau publiquement accessible d'une <link linkend="fdl-transparent">Copie transparente</link> et complète du Document, sans aucun ajout ou modification, et à laquelle tout le monde peut accéder en téléchargement anonyme et sans frais, selon des protocoles réseau communs et standard. Si vous choisissez cette dernière option, vous devez prendre les dispositions nécessaires, dans la limite du raisonnable, afin de garantir l'accès non restrictif à la Copie transparente durant une année pleine après la diffusion publique de la dernière Copie opaque(directement ou via vos revendeurs).

note: (itstool) path: sect1/para
en: It is requested, but not required, that you contact the authors of the <link linkend="fdl-document">Document</link> well before redistributing any large number of copies, to give them a chance to provide you with an updated version of the Document.
fr: Nous recommandons, mais ce n'est pas obligatoire, que vous contactiez l'auteur du <link linkend="fdl-document">Document</link> suffisamment tôt avant toute publication d'un grand nombre de copies, afin de lui permettre de vous donner une version à jour du Document.

note: (itstool) path: sect1/para
en: You may copy and distribute a <link linkend="fdl-modified">Modified Version</link> of the <link linkend="fdl-document">Document</link> under the conditions of sections <link linkend="fdl-section2">2</link> and <link linkend="fdl-section3">3</link> above, provided that you release the Modified Version under precisely this License, with the Modified Version filling the role of the Document, thus licensing distribution and modification of the Modified Version to whoever possesses a copy of it. In addition, you must do these things in the Modified Version:
fr: Vous pouvez copier et distribuer une <link linkend="fdl-modified">Version modifiée</link> du <link linkend="fdl-document">Document</link> en respectant les conditions des sections <link linkend="fdl-section2">2</link> et <link linkend="fdl-section3">3</link> précédentes, à condition de placer cette Version modifiée sous la présente Licence, dans laquelle le terme « Document » doit être remplacé par les termes « Version modifiée », donnant ainsi l'autorisation de redistribuer et de modifier cette Version modifiée à quiconque en possède une copie. De plus, vous devez effectuer les actions suivantes dans la Version modifiée :

note: (itstool) path: formalpara/para
en: Use in the <link linkend="fdl-title-page">Title Page</link> (and on the covers, if any) a title distinct from that of the <link linkend="fdl-document">Document</link>, and from those of previous versions (which should, if there were any, be listed in the History section of the Document). You may use the same title as a previous version if the original publisher of that version gives permission.
fr: Utiliser sur la <link linkend="fdl-title-page">Page de titre</link> (et sur la page de couverture éventuellement présente) un titre distinct de celui du <link linkend="fdl-document">Document</link> d'origine et de toutes ses versions antérieures (qui, si elles existent, doivent être mentionnées dans la section Historique du Document). Vous pouvez utiliser le même titre si l'éditeur d'origine vous en a donné expressément la permission.

note: (itstool) path: formalpara/para
en: List on the <link linkend="fdl-title-page">Title Page</link>, as authors, one or more persons or entities responsible for authorship of the modifications in the <link linkend="fdl-modified">Modified Version</link>, together with at least five of the principal authors of the <link linkend="fdl-document">Document</link> (all of its principal authors, if it has less than five).
fr: Mentionner sur la <link linkend="fdl-title-page">Page de titre</link> en tant qu'auteurs une ou plusieurs des personnes ou entités responsables des modifications de la <link linkend="fdl-modified">Version modifiée</link>, avec au moins les cinq principaux auteurs du <link linkend="fdl-document">Document</link> (ou tous les auteurs s'il y en a moins de cinq).

note: (itstool) path: formalpara/para
en: State on the <link linkend="fdl-title-page">Title Page</link> the name of the publisher of the <link linkend="fdl-modified">Modified Version</link>, as the publisher.
fr: Préciser sur la <link linkend="fdl-title-page">Page de titre</link> le nom de l'éditeur de la <link linkend="fdl-modified">Version modifiée</link>, en tant qu'éditeur du Document.

note: (itstool) path: formalpara/para
en: Preserve all the copyright notices of the <link linkend="fdl-document">Document</link>.
fr: Préserver intégralement toutes les notices de copyright du <link linkend="fdl-document">Document</link>.

note: (itstool) path: formalpara/para
en: Add an appropriate copyright notice for your modifications adjacent to the other copyright notices.
fr: Ajouter une notice de copyright adjacente aux autres notices pour vos propres modifications.

note: (itstool) path: formalpara/para
en: Include, immediately after the copyright notices, a license notice giving the public permission to use the <link linkend="fdl-modified">Modified Version</link> under the terms of this License, in the form shown in the Addendum below.
fr: Inclure immédiatement après les notices de copyright une notice donnant à quiconque l'autorisation d'utiliser la <link linkend="fdl-modified">Version modifiée</link> selon les termes de cette Licence, sous la forme présentée dans l'annexe indiquée ci-dessous.

note: (itstool) path: formalpara/para
en: Preserve in that license notice the full lists of <link linkend="fdl-invariant"> Invariant Sections</link> and required <link linkend="fdl-cover-texts">Cover Texts</link> given in the <link linkend="fdl-document">Document's</link> license notice.
fr: Préserver dans cette notice la liste complète des <link linkend="fdl-invariant">Sections inaltérables</link> et les <link linkend="fdl-cover-texts">Textes de couverture</link> donnés avec la notice de la Licence du <link linkend="fdl-document">Document</link>.

note: (itstool) path: formalpara/para
en: Include an unaltered copy of this License.
fr: Inclure une copie non modifiée de cette Licence.

note: (itstool) path: formalpara/para
en: Preserve the section entitled <quote>History</quote>, and its title, and add to it an item stating at least the title, year, new authors, and publisher of the <link linkend="fdl-modified">Modified Version</link> as given on the <link linkend="fdl-title-page">Title Page</link>. If there is no section entitled <quote>History</quote> in the <link linkend="fdl-document">Document</link>, create one stating the title, year, authors, and publisher of the Document as given on its Title Page, then add an item describing the Modified Version as stated in the previous sentence.
fr: Préserver la section nommée <quote>Historique</quote> et son titre, et y ajouter une nouvelle entrée décrivant le titre, l'année, les nouveaux auteurs et l'éditeur de la <link linkend="fdl-modified">Version modifiée</link>, tels que décrits sur la <link linkend="fdl-title-page">Page de titre</link>, ainsi qu'un descriptif des modifications apportées depuis la précédente version. S'il n'y a pas de section nommée <quote>Historique</quote> dans le <link linkend="fdl-document">Document</link>, créer une telle section précisant le titre, l'année, les auteurs et l'éditeur du Document tel que précisé sur la <link linkend="fdl-title-page">Page de titre</link>, et ajouter une entrée décrivant la <link linkend="fdl-modified">Version modifiée</link> tel que précisé dans la phrase précédente.

note: (itstool) path: formalpara/para
en: Preserve the network location, if any, given in the <link linkend="fdl-document">Document</link> for public access to a <link linkend="fdl-transparent">Transparent</link> copy of the Document, and likewise the network locations given in the Document for previous versions it was based on. These may be placed in the <quote>History</quote> section. You may omit a network location for a work that was published at least four years before the Document itself, or if the original publisher of the version it refers to gives permission.
fr: Conserver l'adresse réseau éventuellement indiquée dans le <link linkend="fdl-document">Document</link> permettant à quiconque d'accéder à une <link linkend="fdl-transparent">Copie transparente</link> du Document, ainsi que les adresses réseau indiquées dans le Document pour les versions précédentes sur lesquelles le Document se base. Ces liens peuvent être placés dans la section <quote>Historique</quote>. Vous pouvez ne pas conserver les liens pour un travail datant de plus de quatre ans avant la version courante ou si l'éditeur d'origine vous en accorde la permission.

note: (itstool) path: formalpara/para
en: In any section entitled <quote>Acknowledgements</quote> or <quote>Dedications</quote>, preserve the section's title, and preserve in the section all the substance and tone of each of the contributor acknowledgements and/or dedications given therein.
fr: Si une section <quote>Remerciements</quote> ou une section <quote>Dédicaces</quote> sont présentes, les informations et les appréciations concernant les contributeurs et les personnes auxquelles s'adressent ces remerciements doivent être conservées, ainsi que le titre de ces sections.

note: (itstool) path: formalpara/para
en: Preserve all the <link linkend="fdl-invariant">Invariant Sections</link> of the <link linkend="fdl-document">Document</link>, unaltered in their text and in their titles. Section numbers or the equivalent are not considered part of the section titles.
fr: Conserver sans modification les <link linkend="fdl-invariant">Sections inaltérables</link> du <link linkend="fdl-document">Document</link>, ni dans leurs textes, ni dans leurs titres. Les numéros de sections ne sont pas considérés comme faisant partie du texte des sections.

note: (itstool) path: formalpara/para
en: Delete any section entitled <quote>Endorsements</quote>. Such a section may not be included in the <link linkend="fdl-modified">Modified Version</link>.
fr: Effacer toute section intitulée <quote>Approbations</quote>. Une telle section ne peut pas être incluse dans une <link linkend="fdl-modified">Version modifiée</link>.

note: (itstool) path: formalpara/para
en: Do not retitle any existing section as <quote>Endorsements</quote> or to conflict in title with any <link linkend="fdl-invariant">Invariant Section</link>.
fr: Ne pas renommer une section existante sous le titre <quote>Approbations</quote> ou sous un autre titre entrant en conflit avec le titre d'une <link linkend="fdl-invariant">Section inaltérable</link>.

note: (itstool) path: sect1/para
en: If the <link linkend="fdl-modified">Modified Version</link> includes new front-matter sections or appendices that qualify as <link linkend="fdl-secondary">Secondary Sections</link> and contain no material copied from the Document, you may at your option designate some or all of these sections as invariant. To do this, add their titles to the list of <link linkend="fdl-invariant">Invariant Sections</link> in the Modified Version's license notice. These titles must be distinct from any other section titles.
fr: Si la <link linkend="fdl-modified">Version modifiée</link> contient de nouvelles sections préliminaires ou de nouvelles annexes considérées comme des <link linkend="fdl-secondary">Sections secondaires</link> et que celles-ci ne contiennent aucun élément copié à partir du Document, vous pouvez à votre convenance en désigner une ou plusieurs comme étant des Sections inaltérables. Pour ce faire, ajoutez leurs titres dans la liste des <link linkend="fdl-invariant">Sections inaltérables</link> au sein de la notice de Licence de la Version modifiée. Ces titres doivent êtres distincts des titres des autres sections.

note: (itstool) path: sect1/para
en: You may add a section entitled <quote>Endorsements</quote>, provided it contains nothing but endorsements of your <link linkend="fdl-modified">Modified Version</link> by various parties--for example, statements of peer review or that the text has been approved by an organization as the authoritative definition of a standard.
fr: Vous pouvez ajouter une section nommée <quote>Approbations</quote> à condition que ces approbations ne concernent que les modifications ayant donné naissance à la <link linkend="fdl-modified">Version modifiée</link> (par exemple, comptes rendus de revue du document ou acceptation du texte par une organisation le reconnaissant comme étant la définition d'un standard).

note: (itstool) path: sect1/para
en: You may add a passage of up to five words as a <link linkend="fdl-cover-texts">Front-Cover Text</link>, and a passage of up to 25 words as a <link linkend="fdl-cover-texts">Back-Cover Text</link>, to the end of the list of <link linkend="fdl-cover-texts">Cover Texts</link> in the <link linkend="fdl-modified">Modified Version</link>. Only one passage of Front-Cover Text and one of Back-Cover Text may be added by (or through arrangements made by) any one entity. If the <link linkend="fdl-document">Document</link> already includes a cover text for the same cover, previously added by you or by arrangement made by the same entity you are acting on behalf of, you may not add another; but you may replace the old one, on explicit permission from the previous publisher that added the old one.
fr: Vous pouvez ajouter un passage comprenant jusqu'à cinq mots en <link linkend="fdl-cover-texts">première page de couverture</link>, et jusqu'à vingt-cinq mots en <link linkend="fdl-cover-texts">dernière page de couverture</link>, à la liste des <link linkend="fdl-cover-texts">Textes de couverture</link> de la <link linkend="fdl-modified">Version modifiée</link>. Il n'est autorisé d'ajouter qu'un seul passage en première et en dernière pages de couverture par personne ou groupe de personnes ou organisation ayant contribué à la modification du Document. Si le <link linkend="fdl-document">Document</link> comporte déjà un passage sur la même couverture, ajouté en votre nom ou au nom de l'organisation au nom de laquelle vous agissez, vous ne pouvez pas ajouter de passage supplémentaire ; mais vous pouvez remplacer un ancien passage si vous avez expressément obtenu l'autorisation de l'éditeur de celui-ci.

note: (itstool) path: sect1/para
en: The author(s) and publisher(s) of the <link linkend="fdl-document">Document</link> do not by this License give permission to use their names for publicity for or to assert or imply endorsement of any <link linkend="fdl-modified">Modified Version </link>.
fr: Cette Licence ne vous donne pas le droit d'utiliser le nom des auteurs et des éditeurs de ce <link linkend="fdl-document">Document</link> à des fins publicitaires ou pour prétendre à l'approbation d'une <link linkend="fdl-modified">Version modifiée</link>.

note: (itstool) path: sect1/title
en: 5. COMBINING DOCUMENTS
fr: 5. FUSION DE DOCUMENTS

note: (itstool) path: sect1/para
en: You may combine the <link linkend="fdl-document">Document</link> with other documents released under this License, under the terms defined in <link linkend="fdl-section4">section 4</link> above for modified versions, provided that you include in the combination all of the <link linkend="fdl-invariant">Invariant Sections</link> of all of the original documents, unmodified, and list them all as Invariant Sections of your combined work in its license notice.
fr: Vous pouvez fusionner le <link linkend="fdl-document">Document</link> avec d'autres documents soumis à cette Licence, suivant les spécifications de la <link linkend="fdl-section4">section 4</link> pour les Versions modifiées, à condition d'inclure dans le document résultant toutes les <link linkend="fdl-invariant">Sections inaltérables</link> des documents originaux sans modification, et de toutes les lister dans la liste des Sections inaltérables de la notice de Licence du document résultant de la fusion.

note: (itstool) path: sect1/para
en: The combined work need only contain one copy of this License, and multiple identical <link linkend="fdl-invariant">Invariant Sections</link> may be replaced with a single copy. If there are multiple Invariant Sections with the same name but different contents, make the title of each such section unique by adding at the end of it, in parentheses, the name of the original author or publisher of that section if known, or else a unique number. Make the same adjustment to the section titles in the list of Invariant Sections in the license notice of the combined work.
fr: Le document résultant de la fusion n'a besoin que d'une seule copie de cette Licence, et les <link linkend="fdl-invariant">Sections inaltérables</link> existant en multiples exemplaires peuvent être remplacées par une copie unique. S'il existe plusieurs Sections inaltérables portant le même nom mais de contenu différent, rendez unique le titre de chaque section en ajoutant, à la fin de celui-ci, entre parenthèses, le nom de l'auteur ou de l'éditeur d'origine, ou, à défaut, un numéro unique. Les mêmes modifications doivent être réalisées dans la liste des Sections inaltérables de la notice de Licence du document final.

note: (itstool) path: sect1/para
en: In the combination, you must combine any sections entitled <quote>History</quote> in the various original documents, forming one section entitled <quote>History</quote>; likewise combine any sections entitled <quote>Acknowledgements</quote>, and any sections entitled <quote>Dedications</quote>. You must delete all sections entitled <quote>Endorsements.</quote>
fr: Dans le document résultant de la fusion, vous devez rassembler en une seule toutes les sections <quote>Historique</quote> des documents d'origine. De même, vous devez rassembler les sections <quote>Remerciements</quote> et <quote>Dédicaces</quote>. Vous devez supprimer toutes les sections <quote>Approbations</quote>.

note: (itstool) path: sect1/title
en: 6. COLLECTIONS OF DOCUMENTS
fr: 6. REGROUPEMENTS DE DOCUMENTS

note: (itstool) path: sect1/para
en: You may make a collection consisting of the <link linkend="fdl-document">Document</link> and other documents released under this License, and replace the individual copies of this License in the various documents with a single copy that is included in the collection, provided that you follow the rules of this License for verbatim copying of each of the documents in all other respects.
fr: Vous pouvez créer un regroupement de documents comprenant le <link linkend="fdl-document">Document</link> et d'autres documents soumis à cette Licence, et remplacer les copies individuelles de cette Licence des différents documents par une unique copie incluse dans le regroupement de documents, à condition de respecter pour chacun de ces documents l'ensemble des règles de cette Licence concernant les copies conformes.

note: (itstool) path: sect1/title
en: 7. AGGREGATION WITH INDEPENDENT WORKS
fr: 7. AGRÉGATION AVEC DES TRAVAUX INDÉPENDANTS

note: (itstool) path: sect1/para
en: A compilation of the <link linkend="fdl-document">Document</link> or its derivatives with other separate and independent documents or works, in or on a volume of a storage or distribution medium, does not as a whole count as a <link linkend="fdl-modified">Modified Version</link> of the Document, provided no compilation copyright is claimed for the compilation. Such a compilation is called an <quote>aggregate</quote>, and this License does not apply to the other self-contained works thus compiled with the Document , on account of their being thus compiled, if they are not themselves derivative works of the Document. If the <link linkend="fdl-cover-texts">Cover Text</link> requirement of <link linkend="fdl-section3">section 3</link> is applicable to these copies of the Document, then if the Document is less than one quarter of the entire aggregate, the Document's Cover Texts may be placed on covers that surround only the Document within the aggregate. Otherwise they must appear on covers around the whole aggregate.
fr: La compilation du <link linkend="fdl-document">Document</link> ou de ses dérivés avec d'autres documents ou travaux séparés et indépendants sur un support de stockage ou sur un média de distribution quelconque ne représente pas une <link linkend="fdl-modified">Version modifiée</link> du Document tant qu'aucun copyright n'est déposé pour cette compilation. Une telle compilation est appelée <quote>agrégat</quote> et cette Licence ne s'applique pas aux autres travaux indépendants compilés avec le Document s'ils ne sont pas eux-mêmes des travaux dérivés du Document. Si les exigences de la <link linkend="fdl-section3">section 3</link> concernant les <link linkend="fdl-cover-texts">Textes de couverture</link> sont applicables à ces copies du Document, et si le Document représente un volume inférieur à un quart du volume total de l'agrégat, les Textes de couverture du Document peuvent être placés sur des pages de couverture qui n'encadrent que le Document au sein de l'agrégat. Dans le cas contraire, ils doivent apparaître sur les pages de couverture de l'agrégat complet.

note: (itstool) path: sect1/title
en: 8. TRANSLATION
fr: 8. TRADUCTION

note: (itstool) path: sect1/para
en: Translation is considered a kind of modification, so you may distribute translations of the <link linkend="fdl-document">Document</link> under the terms of <link linkend="fdl-section4">section 4</link>. Replacing <link linkend="fdl-invariant"> Invariant Sections</link> with translations requires special permission from their copyright holders, but you may include translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections. You may include a translation of this License provided that you also include the original English version of this License. In case of a disagreement between the translation and the original English version of this License, the original English version will prevail.
fr: La traduction est considérée comme une forme de modification, vous pouvez donc distribuer les traductions du <link linkend="fdl-document">Document</link> selon les termes de la <link linkend="fdl-section4">section 4</link>. Vous devez obtenir l'autorisation spéciale des auteurs des <link linkend="fdl-invariant">Sections inaltérables</link> pour les remplacer par des traductions, mais vous pouvez inclure les traductions des Sections inaltérables en plus des textes originaux. Vous pouvez inclure une traduction de cette Licence à condition d'inclure également la version originale en anglais. En cas de contradiction entre la traduction et la version originale en anglais, c'est cette dernière qui prévaut.

note: (itstool) path: sect1/title
en: 9. TERMINATION
fr: 9. RÉVOCATION

note: (itstool) path: sect1/para
en: You may not copy, modify, sublicense, or distribute the <link linkend="fdl-document">Document</link> except as expressly provided for under this License. Any other attempt to copy, modify, sublicense or distribute the Document is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance.
fr: Vous ne pouvez pas copier, modifier, sous-licencier ou distribuer le <link linkend="fdl-document">Document</link> autrement que selon les termes de cette Licence. Tout autre acte de copie, modification, sous-Licence ou distribution du Document est sans objet et vous prive automatiquement des droits que cette Licence vous accorde. En revanche, les personnes qui ont reçu de votre part des copies ou les droits sur le document sous couvert de cette Licence ne voient pas leurs droits révoqués tant qu'elles en respectent les principes.

note: (itstool) path: sect1/title
en: 10. FUTURE REVISIONS OF THIS LICENSE
fr: 10. RÉVISIONS FUTURES DE CETTE LICENCE

note: (itstool) path: sect1/para
en: The <ulink type="http" url="http://www.gnu.org/fsf/fsf.html">Free Software Foundation</ulink> may publish new, revised versions of the GNU Free Documentation License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. See <ulink type="http" url="http://www.gnu.org/copyleft">http://www.gnu.org/copyleft/</ulink>.
fr: La <ulink type="http" url="http://www.gnu.org/fsf/fsf.html">Free Software Foundation</ulink> peut publier de temps en temps de nouvelles versions révisées de cette Licence. Ces nouvelles versions seront semblables à la présente version dans l'esprit, mais pourront différer sur des points particuliers en fonction de nouvelles questions ou nouveaux problèmes. Voyez <ulink type="http" url="http://www.gnu.org/copyleft">http://www.gnu.org/copyleft/</ulink> pour plus de détails.

note: (itstool) path: sect1/para
en: Each version of the License is given a distinguishing version number. If the <link linkend="fdl-document">Document</link> specifies that a particular numbered version of this License <quote>or any later version</quote> applies to it, you have the option of following the terms and conditions either of that specified version or of any later version that has been published (not as a draft) by the Free Software Foundation. If the Document does not specify a version number of this License, you may choose any version ever published (not as a draft) by the Free Software Foundation.
fr: Chaque version de cette Licence est dotée d'un numéro de version distinct. Si un <link linkend="fdl-document">Document</link> spécifie un numéro de version particulier de cette Licence, et porte la mention <quote>ou toute autre version ultérieure</quote>, vous pouvez choisir de suivre les termes de la version spécifiée ou ceux de n'importe quelle version ultérieure publiée par la Free Software Foundation. Si aucun numéro de version n'est spécifié, vous pouvez choisir n'importe quelle version officielle publiée par la Free Software Foundation.

note: (itstool) path: sect1/para
en: To use this License in a document you have written, include a copy of the License in the document and put the following copyright and license notices just after the title page:
fr: Pour utiliser cette Licence avec un document que vous avez écrit, incorporez une copie du texte de cette Licence en anglais et placez le texte ci-dessous juste après la page de titre :

note: (itstool) path: blockquote/para
en: Copyright YEAR YOUR NAME.
fr: Copyright © 2010 Bruno Brouard.

note: (itstool) path: blockquote/para
en: Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with the <link linkend="fdl-invariant">Invariant Sections</link> being LIST THEIR TITLES, with the <link linkend="fdl-cover-texts">Front-Cover Texts</link> being LIST, and with the <link linkend="fdl-cover-texts">Back-Cover Texts</link> being LIST. A copy of the license is included in the section entitled <quote>GNU Free Documentation License</quote>.
fr: Permission vous est donnée de copier, distribuer et/ou modifier ce document selon les termes de la Licence GNU Free Documentation License, Version 1.1 ou ultérieure publiée par la Free Software Foundation ; avec <link linkend="fdl-invariant">les sections inaltérables</link> suivantes LISTE DES TITRES DES SECTIONS INALTÉRABLES, avec le <link linkend="fdl-cover-texts">texte de première page de couverture</link> suivant TEXTE DE PREMIÈRE PAGE DE COUVERTURE et avec le <link linkend="fdl-cover-texts">texte de dernière page de couverture</link> suivant TEXTE DE DERNIÈRE PAGE DE COUVERTURE. Une copie de cette Licence est incluse dans la section appelée <quote>GNU Free Documentation License</quote> de ce document.

note: (itstool) path: sect1/para
en: If you have no <link linkend="fdl-invariant">Invariant Sections</link>, write <quote>with no Invariant Sections</quote> instead of saying which ones are invariant. If you have no <link linkend="fdl-cover-texts">Front-Cover Texts</link>, write <quote>no Front-Cover Texts</quote> instead of <quote>Front-Cover Texts being LIST</quote>; likewise for <link linkend="fdl-cover-texts">Back-Cover Texts</link>.
fr: Si votre Document ne comporte pas de <link linkend="fdl-invariant">section inaltérable</link> écrivez <quote>pas de section inaltérable</quote> au lieu de la liste des sections inaltérables. Si votre Document ne comporte pas de <link linkend="fdl-cover-texts">texte de première page de couverture</link>, écrivez <quote>pas de texte de première page de couverture</quote> au lieu de <quote>texte de première page de couverture suivant TEXTE DE PREMIÈRE PAGE DE COUVERTURE</quote> ; de même pour le <link linkend="fdl-cover-texts">texte de dernière page de couverture</link>.

note: (itstool) path: sect1/para
en: If your document contains nontrivial examples of program code, we recommend releasing these examples in parallel under your choice of free software license, such as the <ulink type="http" url="http://www.gnu.org/copyleft/gpl.html"> GNU General Public License</ulink>, to permit their use in free software.
fr: Si votre Document contient des exemples non triviaux de code programme, nous recommandons de distribuer ces exemples en parallèle sous <ulink type="http" url="http://www.gnu.org/copyleft/gpl.html">Licence GNU General Public License</ulink>, qui permet leur usage dans les logiciels libres.

note: (itstool) path: para/quote
en: free
fr: libre

note: (itstool) path: sect1/para
en: The purpose of this License is to make a manual, textbook, or other written document <_:quote-1/> in the sense of freedom: to assure everyone the effective freedom to copy and redistribute it, with or without modifying it, either commercially or noncommercially. Secondarily, this License preserves for the author and publisher a way to get credit for their work, while not being considered responsible for modifications made by others.
fr: L'objet de cette Licence est de rendre tout manuel, livre ou autre document écrit « <_:quote-1/> » au sens de la liberté d'utilisation, à savoir : assurer à chacun la liberté effective de le copier ou de le redistribuer, avec ou sans modifications, commercialement ou non. En outre, cette Licence garantit à l'auteur et à l'éditeur la reconnaissance de leur travail, sans qu'ils soient pour autant considérés comme responsables des modifications réalisées par des tiers.

note: (itstool) path: sect1/para
en: This License is a kind of <_:quote-1/>, which means that derivative works of the document must themselves be free in the same sense. It complements the GNU General Public License, which is a copyleft license designed for free software.
fr: Cette Licence est une sorte de <_:quote-1/>, ce qui signifie que les travaux dérivés du document d'origine sont eux-mêmes « libres » selon les mêmes termes. Elle complète la Licence Publique Générale GNU, qui est également une Licence copyleft, conçue pour les logiciels libres.

note: (itstool) path: para/quote
en: you
fr: Vous

note: (itstool) path: sect1/para
en: This License applies to any manual or other work that contains a notice placed by the copyright holder saying it can be distributed under the terms of this License. The <_:quote-1/>, below, refers to any such manual or work. Any member of the public is a licensee, and is addressed as <_:quote-2/>.
fr: Cette Licence couvre tout manuel ou tout autre travail écrit contenant une notice de copyright autorisant la redistribution selon les termes de cette Licence. Le mot <_:quote-1/> se réfère ci-après à un tel manuel ou travail. Toute personne en est par définition concessionnaire et est référencée ci-après par le terme <_:quote-2/>.

note: (itstool) path: para/quote (itstool) path: para/link
en: Modified Version
fr: Version modifiée

note: (itstool) path: sect1/para
en: A <_:quote-1/> of the Document means any work containing the Document or a portion of it, either copied verbatim, or with modifications and/or translated into another language.
fr: Une <_:quote-1/> du Document désigne tout travail en contenant la totalité ou seulement une portion de celui-ci, copiée mot pour mot, modifiée et/ou traduite dans une autre langue.

note: (itstool) path: para/quote
en: Secondary Section
fr: Section secondaire

note: (itstool) path: sect1/para
en: A <_:quote-1/> is a named appendix or a front-matter section of the <_:link-2/> that deals exclusively with the relationship of the publishers or authors of the Document to the Document's overall subject (or to related matters) and contains nothing that could fall directly within that overall subject. (For example, if the Document is in part a textbook of mathematics, a Secondary Section may not explain any mathematics.) The relationship could be a matter of historical connection with the subject or with related matters, or of legal, commercial, philosophical, ethical or political position regarding them.
fr: Une <_:quote-1/> désigne une annexe au <_:link-2/>, ou toute information indiquant les rapports entre l'auteur ou l'éditeur et le sujet (ou tout autre sujet connexe) du Document, sans toutefois être en rapport direct avec le sujet lui-même (par exemple, si le Document est un manuel de mathématiques, une Section secondaire ne traitera d'aucune notion mathématique). Cette section peut contenir des informations relatives à l'historique du Document, des sources documentaires, des dispositions légales, commerciales, philosophiques, ou des positions éthiques ou politiques susceptibles de concerner le sujet traité.

note: (itstool) path: para/quote (itstool) path: para/link
en: Invariant Sections
fr: Sections inaltérables

note: (itstool) path: para/link
en: Secondary Sections
fr: sections secondaires

note: (itstool) path: sect1/para
en: The <_:quote-1/> are certain <_:link-2/> whose titles are designated, as being those of Invariant Sections, in the notice that says that the <_:link-3/> is released under this License.
fr: Les <_:quote-1/> sont des <_:link-2/> considérées comme ne pouvant être modifiées et citées comme telles dans la notice légale qui place le <_:link-3/> sous cette Licence.

note: (itstool) path: para/quote (itstool) path: para/link
en: Cover Texts
fr: Textes de couverture

note: (itstool) path: sect1/para
en: The <_:quote-1/> are certain short passages of text that are listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says that the <_:link-2/> is released under this License.
fr: Les <_:quote-1/> sont les textes courts situés sur les pages de couverture avant et arrière, et cités comme tels dans la mention légale de ce <_:link-2/>.

note: (itstool) path: para/quote (itstool) path: para/link
en: Transparent
fr: Copie transparente

note: (itstool) path: sect1/para
en: A <_:quote-1/> copy of the <_:link-2/> means a machine-readable copy, represented in a format whose specification is available to the general public, whose contents can be viewed and edited directly and straightforwardly with generic text editors or (for images composed of pixels) generic paint programs or (for drawings) some widely available drawing editor, and that is suitable for input to text formatters or for automatic translation to a variety of formats suitable for input to text formatters. A copy made in an otherwise Transparent file format whose markup has been designed to thwart or discourage subsequent modification by readers is not Transparent. A copy that is not <_:quote-3/> is called <_:quote-4/>.
fr: Le terme <_:quote-1/> désigne une version numérique du <_:link-2/> représentée dans un format dont les spécifications sont publiquement disponibles et dont le contenu peut être visualisé et édité directement et immédiatement par un éditeur de texte quelconque, ou (pour les images composées de pixels) par un programme de traitement d'images quelconque, ou (pour les dessins) par un éditeur de dessins courant. Ce format doit pouvoir être accepté directement ou être convertible facilement dans des formats utilisables directement par des logiciels de formatage de texte. Une copie publiée dans un quelconque format numérique ouvert mais dont la structure a été conçue dans le but exprès de prévenir les modifications ultérieures du Document ou dans le but d'en décourager les lecteurs n'est pas considérée comme une Copie Transparente. Une copie qui n'est pas <_:quote-3/> est considérée, par opposition, comme <_:quote-4/>.

note: (itstool) path: para/quote (itstool) path: para/link
en: Title Page
fr: Page de titre

note: (itstool) path: sect1/para
en: The <_:quote-1/> means, for a printed book, the title page itself, plus such following pages as are needed to hold, legibly, the material this License requires to appear in the title page. For works in formats which do not have any title page as such, <_:quote-2/> means the text near the most prominent appearance of the work's title, preceding the beginning of the body of the text.
fr: La <_:quote-1/> désigne, pour les ouvrages imprimés, la page de titre elle-même, ainsi que les pages supplémentaires nécessaires pour fournir clairement les informations dont cette Licence impose la présence sur la page de titre. Pour les travaux n'ayant pas de Page de titre comme décrit ci-dessus, la <_:quote-2/> désigne le texte qui s'apparente le plus au titre du document et situé avant le texte principal.

note: (itstool) path: sect1/para
en: You may copy and distribute the <_:link-1/> in any medium, either commercially or noncommercially, provided that this License, the copyright notices, and the license notice saying this License applies to the Document are reproduced in all copies, and that you add no other conditions whatsoever to those of this License. You may not use technical measures to obstruct or control the reading or further copying of the copies you make or distribute. However, you may accept compensation in exchange for copies. If you distribute a large enough number of copies you must also follow the conditions in <_:link-2/>.
fr: Vous pouvez copier et distribuer le <_:link-1/> sur tout type de support, commercialement ou non, à condition que cette Licence, la notice de copyright et la notice de la Licence indiquant que cette Licence s'applique à ce Document soient reproduits dans toutes les copies, et que vous n'y ajoutiez aucune condition restrictive supplémentaire. Vous ne pouvez pas utiliser un quelconque moyen technique visant à empêcher ou à contrôler la lecture ou la reproduction ultérieure des copies que vous avez créées ou distribuées. Toutefois, vous pouvez solliciter une rétribution en échange des copies. Si vous distribuez une grande quantité de copies, référez-vous aux dispositions de la <_:link-2/>.

note: (itstool) path: sect1/para
en: If you publish printed copies of the <_:link-1/> numbering more than 100, and the Document's license notice requires <_:link-2/>, you must enclose the copies in covers that carry, clearly and legibly, all these Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on the back cover. Both covers must also clearly and legibly identify you as the publisher of these copies. The front cover must present the full title with all words of the title equally prominent and visible. You may add other material on the covers in addition. Copying with changes limited to the covers, as long as they preserve the title of the <_:link-3/> and satisfy these conditions, can be treated as verbatim copying in other respects.
fr: Si vous publiez des copies imprimées de ce <_:link-1/> à plus de 100 exemplaires et que la Licence du Document indique la présence de <_:link-2/>, vous devez fournir une couverture pour chaque copie, qui présente les Textes de couverture des première et dernière pages de couverture du Document. Les première et dernière pages de couverture doivent également vous identifier clairement et sans ambiguïté comme étant l'éditeur de ces copies. La première page de couverture doit comporter le titre du Document en mots d'importance et de visibilité égales. Vous pouvez ajouter des informations complémentaires sur les pages de couverture. Les copies du Document dont seule la couverture a été modifiée peuvent être considérées comme des copies conformes, à condition que le titre du <_:link-3/> soit préservé et que les conditions indiquées précédemment soient respectées.

note: (itstool) path: sect1/para
en: If you publish or distribute <_:link-1/> copies of the <_:link-2/> numbering more than 100, you must either include a machine-readable <_:link-3/> copy along with each Opaque copy, or state in or with each Opaque copy a publicly-accessible computer-network location containing a complete Transparent copy of the Document, free of added material, which the general network-using public has access to download anonymously at no charge using public-standard network protocols. If you use the latter option, you must take reasonably prudent steps, when you begin distribution of Opaque copies in quantity, to ensure that this Transparent copy will remain thus accessible at the stated location until at least one year after the last time you distribute an Opaque copy (directly or through your agents or retailers) of that edition to the public.
fr: Si vous publiez plus de 100 <_:link-1/> du <_:link-2/>, vous devez soit fournir une Copie transparente pour chaque Copie opaque, soit préciser ou fournir avec chaque Copie opaque une adresse réseau publiquement accessible d'une <_:link-3/> et complète du Document, sans aucun ajout ou modification, et à laquelle tout le monde peut accéder en téléchargement anonyme et sans frais, selon des protocoles réseau communs et standard. Si vous choisissez cette dernière option, vous devez prendre les dispositions nécessaires, dans la limite du raisonnable, afin de garantir l'accès non restrictif à la Copie transparente durant une année pleine après la diffusion publique de la dernière Copie opaque(directement ou via vos revendeurs).

note: (itstool) path: sect1/para
en: It is requested, but not required, that you contact the authors of the <_:link-1/> well before redistributing any large number of copies, to give them a chance to provide you with an updated version of the Document.
fr: Nous recommandons, mais ce n'est pas obligatoire, que vous contactiez l'auteur du <_:link-1/> suffisamment tôt avant toute publication d'un grand nombre de copies, afin de lui permettre de vous donner une version à jour du Document.

note: (itstool) path: sect1/para
en: You may copy and distribute a <_:link-1/> of the <_:link-2/> under the conditions of sections <_:link-3/> and <_:link-4/> above, provided that you release the Modified Version under precisely this License, with the Modified Version filling the role of the Document, thus licensing distribution and modification of the Modified Version to whoever possesses a copy of it. In addition, you must do these things in the Modified Version:
fr: Vous pouvez copier et distribuer une <_:link-1/> du <_:link-2/> en respectant les conditions des sections <_:link-3/> et <_:link-4/> précédentes, à condition de placer cette Version modifiée sous la présente Licence, dans laquelle le terme « Document » doit être remplacé par les termes « Version modifiée », donnant ainsi l'autorisation de redistribuer et de modifier cette Version modifiée à quiconque en possède une copie. De plus, vous devez effectuer les actions suivantes dans la Version modifiée :

note: (itstool) path: formalpara/para
en: Use in the <_:link-1/> (and on the covers, if any) a title distinct from that of the <_:link-2/>, and from those of previous versions (which should, if there were any, be listed in the History section of the Document). You may use the same title as a previous version if the original publisher of that version gives permission.
fr: Utiliser sur la <_:link-1/> (et sur la page de couverture éventuellement présente) un titre distinct de celui du <_:link-2/> d'origine et de toutes ses versions antérieures (qui, si elles existent, doivent être mentionnées dans la section Historique du Document). Vous pouvez utiliser le même titre si l'éditeur d'origine vous en a donné expressément la permission.

note: (itstool) path: formalpara/para
en: List on the <_:link-1/>, as authors, one or more persons or entities responsible for authorship of the modifications in the <_:link-2/>, together with at least five of the principal authors of the <_:link-3/> (all of its principal authors, if it has less than five).
fr: Mentionner sur la <_:link-1/> en tant qu'auteurs une ou plusieurs des personnes ou entités responsables des modifications de la <_:link-2/>, avec au moins les cinq principaux auteurs du <_:link-3/> (ou tous les auteurs s'il y en a moins de cinq).

note: (itstool) path: formalpara/para
en: State on the <_:link-1/> the name of the publisher of the <_:link-2/>, as the publisher.
fr: Préciser sur la <_:link-1/> le nom de l'éditeur de la <_:link-2/>, en tant qu'éditeur du Document.

note: (itstool) path: formalpara/para
en: Preserve all the copyright notices of the <_:link-1/>.
fr: Préserver intégralement toutes les notices de copyright du <_:link-1/>.

note: (itstool) path: formalpara/para
en: Include, immediately after the copyright notices, a license notice giving the public permission to use the <_:link-1/> under the terms of this License, in the form shown in the Addendum below.
fr: Inclure immédiatement après les notices de copyright une notice donnant à quiconque l'autorisation d'utiliser la <_:link-1/> selon les termes de cette Licence, sous la forme présentée dans l'annexe indiquée ci-dessous.

note: (itstool) path: para/link
en: Document's
fr: Document

note: (itstool) path: formalpara/para
en: Preserve in that license notice the full lists of <_:link-1/> and required <_:link-2/> given in the <_:link-3/> license notice.
fr: Préserver dans cette notice la liste complète des <_:link-1/> et les <_:link-2/> donnés avec la notice de la Licence du <_:link-3/>.

note: (itstool) path: para/quote
en: History
fr: Historique

note: (itstool) path: formalpara/para
en: Preserve the section entitled <_:quote-1/>, and its title, and add to it an item stating at least the title, year, new authors, and publisher of the <_:link-2/> as given on the <_:link-3/>. If there is no section entitled <_:quote-4/> in the <_:link-5/>, create one stating the title, year, authors, and publisher of the Document as given on its Title Page, then add an item describing the Modified Version as stated in the previous sentence.
fr: Préserver la section nommée <_:quote-1/> et son titre, et y ajouter une nouvelle entrée décrivant le titre, l'année, les nouveaux auteurs et l'éditeur de la <_:link-2/>, tels que décrits sur la <_:link-3/>, ainsi qu'un descriptif des modifications apportées depuis la précédente version. S'il n'y a pas de section nommée <_:quote-4/> dans le <_:link-5/>, créer une telle section précisant le titre, l'année, les auteurs et l'éditeur du Document tel que précisé sur la Page de titre,et ajouter une entrée décrivant la Version modifiée tel que précisé dans la phrase précédente.

note: (itstool) path: formalpara/para
en: Preserve the network location, if any, given in the <_:link-1/> for public access to a <_:link-2/> copy of the Document, and likewise the network locations given in the Document for previous versions it was based on. These may be placed in the <_:quote-3/> section. You may omit a network location for a work that was published at least four years before the Document itself, or if the original publisher of the version it refers to gives permission.
fr: Conserver l'adresse réseau éventuellement indiquée dans le <_:link-1/> permettant à quiconque d'accéder à une <_:link-2/> du Document, ainsi que les adresses réseau indiquées dans le Document pour les versions précédentes sur lesquelles le Document se base. Ces liens peuvent être placés dans la section <_:quote-3/>. Vous pouvez ne pas conserver les liens pour un travail datant de plus de quatre ans avant la version courante ou si l'éditeur d'origine vous en accorde la permission.

note: (itstool) path: para/quote
en: Acknowledgements
fr: Remerciements

note: (itstool) path: para/quote
en: Dedications
fr: Dédicaces

note: (itstool) path: formalpara/para
en: In any section entitled <_:quote-1/> or <_:quote-2/>, preserve the section's title, and preserve in the section all the substance and tone of each of the contributor acknowledgements and/or dedications given therein.
fr: Si une section <_:quote-1/> ou une section <_:quote-2/> sont présentes, les informations et les appréciations concernant les contributeurs et les personnes auxquelles s'adressent ces remerciements doivent être conservées, ainsi que le titre de ces sections.

note: (itstool) path: formalpara/para
en: Preserve all the <_:link-1/> of the <_:link-2/>, unaltered in their text and in their titles. Section numbers or the equivalent are not considered part of the section titles.
fr: Conserver sans modification les <_:link-1/> du <_:link-2/>, ni dans leurs textes, ni dans leurs titres. Les numéros de sections ne sont pas considérés comme faisant partie du texte des sections.

note: (itstool) path: para/quote
en: Endorsements
fr: Approbations

note: (itstool) path: formalpara/para
en: Delete any section entitled <_:quote-1/>. Such a section may not be included in the <_:link-2/>.
fr: Effacer toute section intitulée <_:quote-1/>. Une telle section ne peut pas être incluse dans une <_:link-2/>.

note: (itstool) path: para/link
en: Invariant Section
fr: Section inaltérable

note: (itstool) path: formalpara/para
en: Do not retitle any existing section as <_:quote-1/> or to conflict in title with any <_:link-2/>.
fr: Ne pas renommer une section existante sous le titre <_:quote-1/> ou sous un autre titre entrant en conflit avec le titre d'une <_:link-2/>.

note: (itstool) path: sect1/para
en: If the <_:link-1/> includes new front-matter sections or appendices that qualify as <_:link-2/> and contain no material copied from the Document, you may at your option designate some or all of these sections as invariant. To do this, add their titles to the list of <_:link-3/> in the Modified Version's license notice. These titles must be distinct from any other section titles.
fr: Si la <_:link-1/> contient de nouvelles sections préliminaires ou de nouvelles annexes considérées comme des <_:link-2/> et que celles-ci ne contiennent aucun élément copié à partir du Document, vous pouvez à votre convenance en désigner une ou plusieurs comme étant des Sections inaltérables. Pour ce faire, ajoutez leurs titres dans la liste des <_:link-3/> au sein de la notice de Licence de la Version modifiée. Ces titres doivent êtres distincts des titres des autres sections.

note: (itstool) path: sect1/para
en: You may add a section entitled <_:quote-1/>, provided it contains nothing but endorsements of your <_:link-2/> by various parties--for example, statements of peer review or that the text has been approved by an organization as the authoritative definition of a standard.
fr: Vous pouvez ajouter une section nommée <_:quote-1/> à condition que ces approbations ne concernent que les modifications ayant donné naissance à la <_:link-2/> (par exemple, comptes rendus de revue du document ou acceptation du texte par une organisation le reconnaissant comme étant la définition d'un standard).

note: (itstool) path: para/link
en: Front-Cover Text
fr: première page de couverture

note: (itstool) path: para/link
en: Back-Cover Text
fr: dernière page de couverture

note: (itstool) path: sect1/para
en: You may add a passage of up to five words as a <_:link-1/>, and a passage of up to 25 words as a <_:link-2/>, to the end of the list of <_:link-3/> in the <_:link-4/>. Only one passage of Front-Cover Text and one of Back-Cover Text may be added by (or through arrangements made by) any one entity. If the <_:link-5/> already includes a cover text for the same cover, previously added by you or by arrangement made by the same entity you are acting on behalf of, you may not add another; but you may replace the old one, on explicit permission from the previous publisher that added the old one.
fr: Vous pouvez ajouter un passage comprenant jusqu'à cinq mots en <_:link-1/>, et jusqu'à vingt-cinq mots en <_:link-2/>, à la liste des <_:link-3/> de la <_:link-4/>. Il n'est autorisé d'ajouter qu'un seul passage en première et en dernière pages de couverture par personne ou groupe de personnes ou organisation ayant contribué à la modification du Document. Si le <_:link-5/> comporte déjà un passage sur la même couverture, ajouté en votre nom ou au nom de l'organisation au nom de laquelle vous agissez, vous ne pouvez pas ajouter de passage supplémentaire ; mais vous pouvez remplacer un ancien passage si vous avez expressément obtenu l'autorisation de l'éditeur de celui-ci.

note: (itstool) path: sect1/para
en: The author(s) and publisher(s) of the <_:link-1/> do not by this License give permission to use their names for publicity for or to assert or imply endorsement of any <_:link-2/>.
fr: Cette Licence ne vous donne pas le droit d'utiliser le nom des auteurs et des éditeurs de ce <_:link-1/> à des fins publicitaires ou pour prétendre à l'approbation d'une <_:link-2/>.

note: (itstool) path: sect1/para
en: You may combine the <_:link-1/> with other documents released under this License, under the terms defined in <_:link-2/> above for modified versions, provided that you include in the combination all of the <_:link-3/> of all of the original documents, unmodified, and list them all as Invariant Sections of your combined work in its license notice.
fr: Vous pouvez fusionner le <_:link-1/> avec d'autres documents soumis à cette Licence, suivant les spécifications de la <_:link-2/> pour les Versions modifiées, à condition d'inclure dans le document résultant toutes les <_:link-3/> des documents originaux sans modification, et de toutes les lister dans la liste des Sections inaltérables de la notice de Licence du document résultant de la fusion.

note: (itstool) path: sect1/para
en: The combined work need only contain one copy of this License, and multiple identical <_:link-1/> may be replaced with a single copy. If there are multiple Invariant Sections with the same name but different contents, make the title of each such section unique by adding at the end of it, in parentheses, the name of the original author or publisher of that section if known, or else a unique number. Make the same adjustment to the section titles in the list of Invariant Sections in the license notice of the combined work.
fr: Le document résultant de la fusion n'a besoin que d'une seule copie de cette Licence, et les <_:link-1/> existant en multiples exemplaires peuvent être remplacées par une copie unique. S'il existe plusieurs Sections inaltérables portant le même nom mais de contenu différent, rendez unique le titre de chaque section en ajoutant, à la fin de celui-ci, entre parenthèses, le nom de l'auteur ou de l'éditeur d'origine, ou, à défaut, un numéro unique. Les mêmes modifications doivent être réalisées dans la liste des Sections inaltérables de la notice de Licence du document final.

note: (itstool) path: para/quote
en: Endorsements.
fr: Approbations

note: (itstool) path: sect1/para
en: In the combination, you must combine any sections entitled <_:quote-1/> in the various original documents, forming one section entitled <_:quote-2/>; likewise combine any sections entitled <_:quote-3/>, and any sections entitled <_:quote-4/>. You must delete all sections entitled <_:quote-5/>
fr: Dans le document résultant de la fusion, vous devez rassembler toutes les sections <_:quote-1/> des documents d'origine en une seule section <_quote-2/>. De même, vous devez rassembler les sections <_:quote-3/> et <_:quote-4/>. Vous devez supprimer toutes les sections <_:quote-5/>.

note: (itstool) path: sect1/para
en: You may make a collection consisting of the <_:link-1/> and other documents released under this License, and replace the individual copies of this License in the various documents with a single copy that is included in the collection, provided that you follow the rules of this License for verbatim copying of each of the documents in all other respects.
fr: Vous pouvez créer un regroupement de documents comprenant le <_:link-1/> d'autres documents soumis à cette Licence, et remplacer les copies individuelles de cette Licence des différents documents par une unique copie incluse dans le regroupement de documents, à condition de respecter pour chacun de ces documents l'ensemble des règles de cette Licence concernant les copies conformes.

note: (itstool) path: para/quote
en: aggregate
fr: agrégat

note: (itstool) path: para/link
en: Cover Text
fr: Textes de couverture

note: (itstool) path: sect1/para
en: A compilation of the <_:link-1/> or its derivatives with other separate and independent documents or works, in or on a volume of a storage or distribution medium, does not as a whole count as a <_:link-2/> of the Document, provided no compilation copyright is claimed for the compilation. Such a compilation is called an <_:quote-3/>, and this License does not apply to the other self-contained works thus compiled with the Document , on account of their being thus compiled, if they are not themselves derivative works of the Document. If the <_:link-4/> requirement of <_:link-5/> is applicable to these copies of the Document, then if the Document is less than one quarter of the entire aggregate, the Document's Cover Texts may be placed on covers that surround only the Document within the aggregate. Otherwise they must appear on covers around the whole aggregate.
fr: La compilation du <_:link-1/> ou de ses dérivés avec d'autres documents ou travaux séparés et indépendants sur un support de stockage ou sur un média de distribution quelconque ne représente pas une <_:link-2/> du Document tant qu'aucun copyright n'est déposé pour cette compilation. Une telle compilation est appelée <_:quote-3/> et cette Licence ne s'applique pas aux autres travaux indépendants compilés avec le Document s'ils ne sont pas eux-mêmes des travaux dérivés du Document. Si les exigences de la <_:link-4/> concernant les <_:link-5/> sont applicables à ces copies du Document, et si le Document représente un volume inférieur à un quart du volume total de l'agrégat, les Textes de couverture du Document peuvent être placés sur des pages de couverture qui n'encadrent que le Document au sein de l'agrégat. Dans le cas contraire, ils doivent apparaître sur les pages de couverture de l'agrégat complet.

note: (itstool) path: sect1/para
en: Translation is considered a kind of modification, so you may distribute translations of the <_:link-1/> under the terms of <_:link-2/>. Replacing <_:link-3/> with translations requires special permission from their copyright holders, but you may include translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections. You may include a translation of this License provided that you also include the original English version of this License. In case of a disagreement between the translation and the original English version of this License, the original English version will prevail.
fr: La traduction est considérée comme une forme de modification, vous pouvez donc distribuer les traductions du <_:link-1/> selon les termes de la <_:link-2/>. Vous devez obtenir l'autorisation spéciale des auteurs des <_:link-3/> pour les remplacer par des traductions, mais vous pouvez inclure les traductions des Sections inaltérables en plus des textes originaux. Vous pouvez inclure une traduction de cette Licence à condition d'inclure également la version originale en anglais. En cas de contradiction entre la traduction et la version originale en anglais, c'est cette dernière qui prévaut.

note: (itstool) path: sect1/para
en: You may not copy, modify, sublicense, or distribute the <_:link-1/> except as expressly provided for under this License. Any other attempt to copy, modify, sublicense or distribute the Document is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance.
fr: Vous ne pouvez pas copier, modifier, sous-licencier ou distribuer le <_:link-1/> autrement que selon les termes de cette Licence. Tout autre acte de copie, modification, sous-Licence ou distribution du Document est sans objet et vous prive automatiquement des droits que cette Licence vous accorde. En revanche, les personnes qui ont reçu de votre part des copies ou les droits sur le document sous couvert de cette Licence ne voient pas leurs droits révoqués tant qu'elles en respectent les principes.

note: (itstool) path: sect1/para
en: The <_:ulink-1/> may publish new, revised versions of the GNU Free Documentation License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. See <_:ulink-2/>.
fr: La <_:ulink-1/> peut publier de temps en temps de nouvelles versions révisées de cette Licence. Ces nouvelles versions seront semblables à la présente version dans l'esprit, mais pourront différer sur des points particuliers en fonction de nouvelles questions ou nouveaux problèmes. Voyez <_:ulink-2/> pour plus de détails.

note: (itstool) path: para/quote
en: or any later version
fr: ou toute autre version ultérieure

note: (itstool) path: sect1/para
en: Each version of the License is given a distinguishing version number. If the <_:link-1/> specifies that a particular numbered version of this License <_:quote-2/> applies to it, you have the option of following the terms and conditions either of that specified version or of any later version that has been published (not as a draft) by the Free Software Foundation. If the Document does not specify a version number of this License, you may choose any version ever published (not as a draft) by the Free Software Foundation.
fr: Chaque version de cette Licence est dotée d'un numéro de version distinct. Si un <_:link-1/> spécifie un numéro de version particulier de cette Licence, et porte la mention <_:quote-2/>, vous pouvez choisir de suivre les termes de la version spécifiée ou ceux de n'importe quelle version ultérieure publiée par la Free Software Foundation. Si aucun numéro de version n'est spécifié, vous pouvez choisir n'importe quelle version officielle publiée par la Free Software Foundation.

note: (itstool) path: para/link
en: Front-Cover Texts
fr: texte de première page de couverture

note: (itstool) path: para/link
en: Back-Cover Texts
fr: texte de dernière page de couverture

note: (itstool) path: blockquote/para
en: Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with the <_:link-1/> being LIST THEIR TITLES, with the <_:link-2/> being LIST, and with the <_:link-3/> being LIST. A copy of the license is included in the section entitled <_:quote-4/>.
fr: Permission vous est donnée de copier, distribuer et/ou modifier ce document selon les termes de la Licence GNU Free Documentation License, Version 1.1 ou ultérieure publiée par la Free Software Foundation ; avec <_:link-1/> suivantes LISTE DES TITRES DES SECTIONS INALTÉRABLES, avec le <_:link-2/> suivant TEXTE DE PREMIÈRE PAGE DE COUVERTURE et avec le <_:link-3/>  suivant TEXTE DE DERNIÈRE PAGE DE COUVERTURE. Une copie de cette Licence est incluse dans la section appelée <_:quote-4/> de ce document.

note: (itstool) path: para/quote
en: with no Invariant Sections
fr: pas de section inaltérable

note: (itstool) path: para/quote
en: no Front-Cover Texts
fr: pas de texte de première page de couverture

note: (itstool) path: para/quote
en: Front-Cover Texts being LIST
fr: texte de première page de couverture suivant TEXTE DE PREMIÈRE PAGE DE COUVERTURE

note: (itstool) path: sect1/para
en: If you have no <_:link-1/>, write <_:quote-2/> instead of saying which ones are invariant. If you have no <_:link-3/>, write <_:quote-4/> instead of <_:quote-5/>; likewise for <_:link-6/>.
fr: Si votre Document ne comporte pas de <_:link-1/> écrivez <_:quote-2/> au lieu de la liste des sections inaltérables. Si votre Document ne comporte pas de <_:link-3/>, écrivez <_:quote-4/> au lieu de <_:quote-5/>; de même pour le <_:link-6/>.

note: (itstool) path: para/ulink
en: GNU General Public License
fr: Licence Publique Générale GNU

note: (itstool) path: sect1/para
en: If your document contains nontrivial examples of program code, we recommend releasing these examples in parallel under your choice of free software license, such as the <_:ulink-1/>, to permit their use in free software.
fr: Si votre Document contient des exemples non triviaux de code programme, nous recommandons de distribuer ces exemples en parallèle sous <_:ulink-1/>, qui permet leur usage dans les logiciels libres.
