diff --git a/TRANSLATORS b/TRANSLATORS
index 1e7d605f..6df8140b 100644
--- a/TRANSLATORS
+++ b/TRANSLATORS
@@ -20,3 +20,4 @@ Loc Cosnier
 Yannick Gingras
 Martin Chlumsky
 Stephan Michaud
+Edith Viau
diff --git a/library/doctest.po b/library/doctest.po
index 38f6cb8c..78954be1 100644
--- a/library/doctest.po
+++ b/library/doctest.po
@@ -5,23 +5,23 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2020-10-01 16:00+0200\n"
-"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
-"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"POT-Creation-Date: 2020-07-20 10:51+0200\n"
+"PO-Revision-Date: 2021-09-12 09:38-0400\n"
 "Language-Team: FRENCH <traductions@lists.afpy.org>\n"
 "Language: fr\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
+"Last-Translator: Edith Viau <info@eviau.net>\n"
+"X-Generator: Poedit 2.3\n"
 
 #: library/doctest.rst:2
 msgid ":mod:`doctest` --- Test interactive Python examples"
-msgstr ""
+msgstr ":mod:`doctest` — Exemples de tests interactifs en Python"
 
 #: library/doctest.rst:12
-#, fuzzy
 msgid "**Source code:** :source:`Lib/doctest.py`"
-msgstr "**Code source:** :source:`Lib/os.py`"
+msgstr "**Code source :** :source:`Lib/doctest.py`"
 
 #: library/doctest.rst:16
 msgid ""
@@ -29,18 +29,27 @@ msgid ""
 "interactive Python sessions, and then executes those sessions to verify that "
 "they work exactly as shown.  There are several common ways to use doctest:"
 msgstr ""
+"Le module :mod:`doctest` cherche des extraits de texte ressemblant à des "
+"sessions Python interactives avant de les exécuter, de façon à vérifier que "
+"le fonctionnement correspond exactement à la description. Voici quelques cas "
+"d'utilisation de *doctest* :"
 
 #: library/doctest.rst:20
 msgid ""
 "To check that a module's docstrings are up-to-date by verifying that all "
 "interactive examples still work as documented."
 msgstr ""
+"Vérifier que les *docstrings* d'un module sont à jour en vérifiant que tous "
+"les exemples interactifs fonctionnent toujours tels que décrits."
 
 #: library/doctest.rst:23
 msgid ""
 "To perform regression testing by verifying that interactive examples from a "
 "test file or a test object work as expected."
 msgstr ""
+"Réaliser un test de régression en vérifiant que les exemples interactifs "
+"provenant d'un fichier de test ou d'un objet de test fonctionnent comme "
+"prévu."
 
 #: library/doctest.rst:26
 msgid ""
@@ -49,16 +58,22 @@ msgid ""
 "text are emphasized, this has the flavor of \"literate testing\" or "
 "\"executable documentation\"."
 msgstr ""
+"Rédiger de la documentation sous forme de tutoriel pour un paquet, avec une "
+"abondance d'exemples ayant des entrées et des sorties. On pourrait voir ça "
+"comme des tests « dans le texte » ou de la « documentation exécutable », "
+"selon le point de vue."
 
 #: library/doctest.rst:31
 msgid "Here's a complete but small example module::"
-msgstr ""
+msgstr "Voici un petit exemple d'un module qui soit tout de même complet ::"
 
 #: library/doctest.rst:88
 msgid ""
 "If you run :file:`example.py` directly from the command line, :mod:`doctest` "
 "works its magic:"
 msgstr ""
+"L'exécution du fichier :file:`example.py` directement à partir de la ligne "
+"de commande démontre la magie de :mod:`doctest` :"
 
 #: library/doctest.rst:96
 msgid ""
@@ -66,10 +81,14 @@ msgid ""
 "Pass ``-v`` to the script, and :mod:`doctest` prints a detailed log of what "
 "it's trying, and prints a summary at the end:"
 msgstr ""
+"Il n'y a pas de sortie ! C'est normal, cela signifie que tous les exemples "
+"fonctionnent. Passez ``-v`` au script pour que :mod:`doctest` affiche un "
+"journal détaillé de ce qui a été essayé, avant d'afficher un résumé à la "
+"fin :"
 
 #: library/doctest.rst:114
 msgid "And so on, eventually ending with:"
-msgstr ""
+msgstr "Et ainsi de suite, jusqu'à ce qu'on atteigne :"
 
 #: library/doctest.rst:133
 msgid ""
@@ -79,26 +98,37 @@ msgid ""
 "libraries. Especially useful examples can be found in the standard test "
 "file :file:`Lib/test/test_doctest.py`."
 msgstr ""
+"C'est tout ce dont vous avez besoin pour pouvoir commencer une utilisation "
+"productive de :mod:`doctest` ! Allez-y. Les sections suivantes donnent tous "
+"les détails. Notez qu'il y a plusieurs exemples de *doctests* dans la suite "
+"de tests de la bibliothèque standard de Python et dans les autres "
+"bibliothèques. Des exemples particulièrement utiles se situent dans le "
+"fichier de test standard :file:`Lib/test/test_doctest.py`."
 
 #: library/doctest.rst:143
 msgid "Simple Usage: Checking Examples in Docstrings"
-msgstr ""
+msgstr "Utilisation simple : vérifier des exemples dans des *docstrings*"
 
 #: library/doctest.rst:145
 msgid ""
 "The simplest way to start using doctest (but not necessarily the way you'll "
 "continue to do it) is to end each module :mod:`M` with::"
 msgstr ""
+"Le plus simple pour commencer à utiliser *doctest* (mais pas nécessairement "
+"la façon avec laquelle vous continuerez) est de terminer chaque module :mod:"
+"`M` avec ::"
 
 #: library/doctest.rst:152
 msgid ":mod:`doctest` then examines docstrings in module :mod:`M`."
-msgstr ""
+msgstr ":mod:`doctest` examine alors les *docstrings* dans le module :mod:`M`."
 
 #: library/doctest.rst:154
 msgid ""
 "Running the module as a script causes the examples in the docstrings to get "
 "executed and verified::"
 msgstr ""
+"Exécuter le module comme un script a comme conséquence d'exécuter et de "
+"vérifier les exemples dans les *docstrings* ::"
 
 #: library/doctest.rst:159
 msgid ""
@@ -107,16 +137,22 @@ msgid ""
 "and the final line of output is ``***Test Failed*** N failures.``, where *N* "
 "is the number of examples that failed."
 msgstr ""
+"Ceci n'affiche rien à moins qu'un exemple échoue ; le cas échéant, les "
+"exemples défaillants et les causes du ou des échecs sont affichés sur "
+"*stdout*, et la ligne finale de la sortie est ``***Test Failed*** *N "
+"failures*.``, où *N* est le nombre d'exemples défaillants."
 
 #: library/doctest.rst:164
 msgid "Run it with the ``-v`` switch instead::"
-msgstr ""
+msgstr "À la place, exécutez-la avec l'option de ligne de commande ``-v`` ::"
 
 #: library/doctest.rst:168
 msgid ""
 "and a detailed report of all examples tried is printed to standard output, "
 "along with assorted summaries at the end."
 msgstr ""
+"alors, un rapport détaillé de tous les exemples faisant partie de l'essai "
+"est affiché sur la sortie standard, accompagné à la fin de leurs résumés."
 
 #: library/doctest.rst:171
 msgid ""
@@ -125,6 +161,10 @@ msgid ""
 "``sys.argv`` is not examined by :func:`testmod` (so passing ``-v`` or not "
 "has no effect)."
 msgstr ""
+"Vous pouvez activer le mode verbeux en passant ``verbose=True`` à :func:"
+"`testmod`, ou vous le désactiver en lui passant ``verbose=False``. Dans ces "
+"deux cas, ``sys.argv`` n'est pas inspecté par :func:`testmod` (ainsi, lui "
+"passer ``-v`` ou pas n'a aucun effet)."
 
 #: library/doctest.rst:176
 msgid ""
@@ -132,6 +172,10 @@ msgid ""
 "instruct the Python interpreter to run the doctest module directly from the "
 "standard library and pass the module name(s) on the command line::"
 msgstr ""
+"Il y a un raccourci pour exécuter :func:`testmod` à partir de la ligne de "
+"commande. Vous demandez à l'interpréteur Python d'exécuter le module "
+"*doctest* directement à partir de la bibliothèque standard afin de passer le "
+"ou les noms des modules à partir de la ligne de commande ainsi ::"
 
 #: library/doctest.rst:182
 msgid ""
@@ -139,22 +183,31 @@ msgid ""
 "`testmod` on it.  Note that this may not work correctly if the file is part "
 "of a package and imports other submodules from that package."
 msgstr ""
+"Ceci importera :file:`example.py` comme un module autonome et exécutera :"
+"func:`testmod` sur celui-ci. Notez que ceci peut ne pas fonctionner si le "
+"fichier fait partie d'un paquet et importe d'autres sous-modules de ce "
+"paquet."
 
 #: library/doctest.rst:186
 msgid ""
 "For more information on :func:`testmod`, see section :ref:`doctest-basic-"
 "api`."
 msgstr ""
+"Pour plus d'informations sur :func:`testmod`, consultez la section :ref:"
+"`doctest-basic-api`."
 
 #: library/doctest.rst:192
 msgid "Simple Usage: Checking Examples in a Text File"
-msgstr ""
+msgstr "Utilisation simple : vérifier des exemples dans un fichier texte"
 
 #: library/doctest.rst:194
 msgid ""
 "Another simple application of doctest is testing interactive examples in a "
 "text file.  This can be done with the :func:`testfile` function::"
 msgstr ""
+"Une autre application simple de *doctest* est de tester des exemples "
+"interactifs dans un fichier texte. Ceci est fait avec la fonction :func:"
+"`testfile` ::"
 
 #: library/doctest.rst:200
 msgid ""
@@ -163,12 +216,19 @@ msgid ""
 "if it were a single giant docstring; the file doesn't need to contain a "
 "Python program!   For example, perhaps :file:`example.txt` contains this:"
 msgstr ""
+"Ce court script exécute et vérifie chacun des exemples Python interactifs "
+"contenus dans le fichier :file:`example.txt`. Le contenu du fichier est "
+"traité comme une seule *docstring* géante ; le fichier n'a pas besoin de "
+"contenir un programme Python ! Par exemple, prenons un fichier :file:"
+"`example.txt` contenant :"
 
 #: library/doctest.rst:223
 msgid ""
 "Running ``doctest.testfile(\"example.txt\")`` then finds the error in this "
 "documentation::"
 msgstr ""
+"Exécuter ``doctest.testfile(\"example.txt\")`` recherche les erreurs dans "
+"cette documentation ::"
 
 #: library/doctest.rst:234
 msgid ""
@@ -177,6 +237,10 @@ msgid ""
 "cause(s) of the failure(s) are printed to stdout, using the same format as :"
 "func:`testmod`."
 msgstr ""
+"Comme pour :func:`testmod`, :func:`testfile` n'affichera rien sauf si un "
+"exemple échoue. Si un exemple échoue, alors le ou les exemples défaillants "
+"et leurs causes sont affichés sur *stdout*, dans le même format que :func:"
+"`testmod`."
 
 #: library/doctest.rst:239
 msgid ""
@@ -185,12 +249,19 @@ msgid ""
 "optional arguments that can be used to tell it to look for files in other "
 "locations."
 msgstr ""
+"Par défaut, :func:`testfile` cherche les fichiers dans le répertoire où se "
+"situe le module qui l'appelle. Consultez la section :ref:`doctest-basic-api` "
+"pour une description des options de ligne de commande à utiliser afin de "
+"chercher dans d'autres répertoires."
 
 #: library/doctest.rst:243
 msgid ""
 "Like :func:`testmod`, :func:`testfile`'s verbosity can be set with the ``-"
 "v`` command-line switch or with the optional keyword argument *verbose*."
 msgstr ""
+"Comme pour :func:`testmod`, la verbosité de :func:`testfile` peut être "
+"ajustée avec l'option de ligne de commande ``-v`` ou avec le mot clé "
+"*verbose*."
 
 #: library/doctest.rst:247
 msgid ""
@@ -198,22 +269,31 @@ msgid ""
 "instruct the Python interpreter to run the doctest module directly from the "
 "standard library and pass the file name(s) on the command line::"
 msgstr ""
+"Il y a un raccourci pour exécuter :func:`testfile` à partir de la ligne de "
+"commande.  Demandez à l'interpréteur Python d'exécuter le module *doctest* "
+"directement à partir de la bibliothèque standard et de passer le ou les noms "
+"des modules à partir de la ligne de commande ainsi ::"
 
 #: library/doctest.rst:253
 msgid ""
 "Because the file name does not end with :file:`.py`, :mod:`doctest` infers "
 "that it must be run with :func:`testfile`, not :func:`testmod`."
 msgstr ""
+"Puisque le nom du fichier ne se termine pas par :file:`.py`, :mod:`doctest` "
+"en déduit qu'il s'exécute à l'aide de :func:`testfile`, et non pas :func:"
+"`testmod`."
 
 #: library/doctest.rst:256
 msgid ""
 "For more information on :func:`testfile`, see section :ref:`doctest-basic-"
 "api`."
 msgstr ""
+"Pour plus d'information sur :func:`testfile`, consultez la section :ref:"
+"`doctest-basic-api`."
 
 #: library/doctest.rst:262
 msgid "How It Works"
-msgstr ""
+msgstr "Comment ça marche"
 
 #: library/doctest.rst:264
 msgid ""
@@ -224,16 +304,27 @@ msgid ""
 "examples; for information about actually running doctest on these examples, "
 "see the following sections."
 msgstr ""
+"Cette section examine en détail le fonctionnement de *doctest* : quelles "
+"*docstrings* sont considérées, comment sont trouvés les exemples "
+"interactifs, quel est le contexte d'exécution sélectionné, comment les "
+"exceptions sont gérées, et de quelles façons les options de ligne de "
+"commande peuvent être utilisées pour définir le comportement. Ceci est "
+"l'information dont vous avez besoin pour écrire des exemples *doctest* ; "
+"pour de l'information sur l'exécution de *doctest* sur ces exemples, "
+"consultez les sections suivantes."
 
 #: library/doctest.rst:275
 msgid "Which Docstrings Are Examined?"
-msgstr ""
+msgstr "Quelles *docstrings* sont considérées ?"
 
 #: library/doctest.rst:277
 msgid ""
 "The module docstring, and all function, class and method docstrings are "
 "searched.  Objects imported into the module are not searched."
 msgstr ""
+"Les *docstrings* du module, de toutes les fonctions, classes, et méthodes "
+"sont cherchées. Les objets qui sont importés dans le module ne sont pas "
+"cherchés."
 
 #: library/doctest.rst:280
 msgid ""
@@ -243,16 +334,24 @@ msgid ""
 "searched, and strings are treated as if they were docstrings.  In output, a "
 "key ``K`` in ``M.__test__`` appears with name ::"
 msgstr ""
+"De plus, si ``M.__test__`` existe et qu'il est vrai, il doit être un *dict* "
+"dont chaque élément lie un nom (chaîne de caractère) à un objet (fonction, "
+"classe, chaîne de caractère). Les *docstrings* d'objets fonctions et classes "
+"trouvées dans ``M.__test__`` sont cherchés, et les chaînes de caractères "
+"sont traitées comme si elles étaient des *docstrings*. En sortie, une clé "
+"``K`` dans ``M.__test__`` apparaît avec le nom ::"
 
 #: library/doctest.rst:288
 msgid ""
 "Any classes found are recursively searched similarly, to test docstrings in "
 "their contained methods and nested classes."
 msgstr ""
+"Toute classe trouvée est ainsi cherchée récursivement, afin de tester les "
+"*docstrings* contenues dans leurs méthodes et leurs classes imbriquées."
 
 #: library/doctest.rst:299
 msgid "How are Docstring Examples Recognized?"
-msgstr ""
+msgstr "Comment les exemples *docstring* sont-ils identifiés ?"
 
 #: library/doctest.rst:301
 msgid ""
@@ -260,6 +359,9 @@ msgid ""
 "but doctest isn't trying to do an exact emulation of any specific Python "
 "shell."
 msgstr ""
+"Dans la plupart des cas, un copier-coller d'une séance interactive de "
+"console fonctionne bien, mais *doctest* n'essaye pas de faire une simulation "
+"exacte d'un *shell* Python spécifique."
 
 #: library/doctest.rst:326
 msgid ""
@@ -267,10 +369,13 @@ msgid ""
 "'`` line containing the code, and the expected output (if any) extends to "
 "the next ``'>>> '`` or all-whitespace line."
 msgstr ""
+"Toute sortie souhaitée doit immédiatement suivre le dernier ``'>>> '`` ou le "
+"dernier ``'... '`` contenant le code, et la sortie souhaitée, s'il y en a "
+"une, s'étend jusqu'au prochain ``'>>> '`` ou à la prochaine ligne vide."
 
 #: library/doctest.rst:330
 msgid "The fine print:"
-msgstr ""
+msgstr "En détail :"
 
 #: library/doctest.rst:332
 msgid ""
@@ -279,6 +384,10 @@ msgid ""
 "a blank line, put ``<BLANKLINE>`` in your doctest example each place a blank "
 "line is expected."
 msgstr ""
+"La sortie souhaitée ne peut pas contenir une ligne vide, puisque contenir "
+"une telle ligne signale la fin de la sortie souhaitée. Si la sortie "
+"souhaitée doit contenir une ligne vide, ajoutez ``<BLANKLINE>`` dans votre "
+"exemple *doctest* à chaque endroit où une ligne vide est souhaitée."
 
 #: library/doctest.rst:337
 msgid ""
@@ -294,12 +403,29 @@ msgid ""
 "different algorithm for handling tabs by writing a custom :class:"
 "`DocTestParser` class."
 msgstr ""
+"Tous les caractères de tabulation insécables (*hard tab characters*) sont "
+"convertis en espaces, en utilisant des taquets de tabulation de 8 espaces. "
+"Les tabulations se trouvant dans la sortie générée par le code test ne sont "
+"pas modifiées. Comme tout caractère de tabulation insécable *est* converti, "
+"ceci veut dire que si le code de sortie inclut des caractères de tabulation "
+"insécables, alors la seule façon que le *doctest* peut réussir est si "
+"l'option :const:`NORMALIZE_WHITESPACE` ou si :ref:`directive <doctest-"
+"directives>` a cours. De façon alternative, le test peut être ré-écrit afin "
+"de capturer la sortie et de la comparer à un ensemble de valeurs attendues, "
+"et ce, en tant qu'étape du test. Cette gestion des tabulations à la source a "
+"été obtenue suite à un processus d'essais et d'erreurs ; il a été démontré "
+"que c'était là la façon de les gérer qui soit la moins susceptible de "
+"générer des erreurs. Il est possible d'utiliser un algorithme différent pour "
+"la gestion des tabulations en rédigeant une classe sur mesure :class:"
+"`DocTestParser`."
 
 #: library/doctest.rst:349
 msgid ""
 "Output to stdout is captured, but not output to stderr (exception tracebacks "
 "are captured via a different means)."
 msgstr ""
+"La sortie vers *stdout* est capturée, mais pas la sortie vers *stderr* (les "
+"traces d'appel sont capturées par d'autres moyens)."
 
 #: library/doctest.rst:352
 msgid ""
@@ -307,6 +433,10 @@ msgid ""
 "any other reason use a backslash, you should use a raw docstring, which will "
 "preserve your backslashes exactly as you type them::"
 msgstr ""
+"Si vous souhaitez conserver les barres obliques inversées telles quelles "
+"lorsque vous terminez une ligne avec une barre oblique inversée dans une "
+"séance interactive, ou quand vous utilisez une telle barre pour toute autre "
+"raison, vous devez utiliser une *docstring* brute ::"
 
 #: library/doctest.rst:361
 msgid ""
@@ -315,20 +445,27 @@ msgid ""
 "Alternatively, you can double each backslash in the doctest version (and not "
 "use a raw string)::"
 msgstr ""
+"Sinon, la barre oblique inversée est interprétée comme faisant partie de la "
+"chaîne de caractères. Par exemple, le ``\\n`` ci-dessus est interprété comme "
+"un caractère de saut de ligne. De façon alternative, vous pouvez doubler "
+"chaque barre oblique inversée dans la version *doctest* (et n'utilisez pas "
+"dans ce cas de *docstring* brute) ::"
 
 #: library/doctest.rst:370
 msgid "The starting column doesn't matter::"
-msgstr ""
+msgstr "La colonne de départ n'a pas d'importance ::"
 
 #: library/doctest.rst:377
 msgid ""
 "and as many leading whitespace characters are stripped from the expected "
 "output as appeared in the initial ``'>>> '`` line that started the example."
 msgstr ""
+"et autant d'espaces sont retirés de la sortie attendue qu'il y avait "
+"d'espaces avant la ligne commençant par ``'>>> '``."
 
 #: library/doctest.rst:384
 msgid "What's the Execution Context?"
-msgstr ""
+msgstr "Quel est le contexte d'exécution ?"
 
 #: library/doctest.rst:386
 msgid ""
@@ -340,16 +477,28 @@ msgid ""
 "names defined earlier in the docstring being run. Examples cannot see names "
 "defined in other docstrings."
 msgstr ""
+"Par défaut, chaque fois que :mod:`doctest` trouve une *docstring* à tester, "
+"il utilise une *copie superficielle* des variables globales de :mod:`M`, de "
+"telle façon que l'exécution de tests ne change pas les variables globales "
+"réelles du module et que l'exécution d'un unique test dans :mod:`M` ne "
+"puisse laisser traîner des miettes pouvant accidentellement causer la "
+"réussite d'un autre test. Ceci signifie que les exemples peuvent utiliser "
+"librement n'importe quel nom défini au niveau supérieur dans :mod:`M` ainsi "
+"que les noms définis précédemment dans la *docstring* en cours d'exécution. "
+"Les exemples ne peuvent voir les noms définis dans d'autres *docstrings*."
 
 #: library/doctest.rst:394
 msgid ""
 "You can force use of your own dict as the execution context by passing "
 "``globs=your_dict`` to :func:`testmod` or :func:`testfile` instead."
 msgstr ""
+"Vous pouvez forcer l'utilisation de votre propre *dict* comme contexte "
+"d'exécution en passant ``globs=your_dict`` à :func:`testmod` ou encore, à :"
+"func:`testfile`."
 
 #: library/doctest.rst:401
 msgid "What About Exceptions?"
-msgstr ""
+msgstr "Qu'en est-il des exceptions ?"
 
 #: library/doctest.rst:403
 msgid ""
@@ -359,16 +508,23 @@ msgid ""
 "numbers), this is one case where doctest works hard to be flexible in what "
 "it accepts."
 msgstr ""
+"Pas de problèmes, tant que la trace d'appels est la seule sortie produite "
+"par l'exemple : il suffit d'ajouter la trace. [#]_ Comme les traces d'appels "
+"contiennent des détails qui sont sujets à changement rapide (par exemple, le "
+"chemin exact vers un fichier et les numéros de ligne), ceci est un cas où "
+"*doctest* fait un effort pour être flexible dans ce qu'il accepte."
 
 #: library/doctest.rst:409
 msgid "Simple example::"
-msgstr ""
+msgstr "Exemple simple ::"
 
 #: library/doctest.rst:416
 msgid ""
 "That doctest succeeds if :exc:`ValueError` is raised, with the ``list."
 "remove(x): x not in list`` detail as shown."
 msgstr ""
+"Ce *doctest* réussit si :exc:`ValueError` est levée, avec le détail ``list."
+"remote(x): x not in list`` tel que montré."
 
 #: library/doctest.rst:419
 msgid ""
@@ -376,6 +532,9 @@ msgid ""
 "which may be either of the following two lines, indented the same as the "
 "first line of the example::"
 msgstr ""
+"La sortie attendue pour une exception doit commencer par un en-tête de trace "
+"d'appels, qui peut être l'une des deux lignes suivantes, avec la même "
+"indentation que la première ligne de l'exemple ::"
 
 #: library/doctest.rst:426
 msgid ""
@@ -383,6 +542,10 @@ msgid ""
 "contents are ignored by doctest.  The traceback stack is typically omitted, "
 "or copied verbatim from an interactive session."
 msgstr ""
+"L'en-tête de la trace d'appels est suivi par une pile optionnelle de trace "
+"d'appels, dont le contenu est ignoré par *doctest*. La trace d'appels est "
+"habituellement omise, ou est copiée verbatim à partir d'une séance "
+"interactive."
 
 #: library/doctest.rst:430
 msgid ""
@@ -391,12 +554,20 @@ msgid ""
 "a traceback, but can extend across multiple lines if the exception has a "
 "multi-line detail::"
 msgstr ""
+"La pile de trace d'appels est suivie par la partie la plus intéressante : la "
+"ou les lignes contenant le type et le détail de l'exception. Ceci est "
+"habituellement la dernière ligne de la trace d'appels ; dans le cas où "
+"l'exception a un détail sur plusieurs lignes, il est possible de prolonger "
+"sur plusieurs lignes ::"
 
 #: library/doctest.rst:442
 msgid ""
 "The last three lines (starting with :exc:`ValueError`) are compared against "
 "the exception's type and detail, and the rest are ignored."
 msgstr ""
+"Les trois dernières lignes (en commençant par :exc:`ValueError`) sont "
+"comparées avec le type et le détail de l'exception ; tout le reste est "
+"ignoré."
 
 #: library/doctest.rst:445
 msgid ""
@@ -404,6 +575,9 @@ msgid ""
 "documentation value to the example.  So the last example is probably better "
 "as::"
 msgstr ""
+"La pratique optimale est d'omettre la pile de trace d'appels, à moins que "
+"celle-ci ait une valeur significative de documentation de l'exemple. Ainsi, "
+"le dernier exemple est probablement meilleur tel qui suit ::"
 
 #: library/doctest.rst:455
 msgid ""
@@ -413,10 +587,18 @@ msgid ""
 "just as well be three (or three hundred) commas or digits, or an indented "
 "transcript of a Monty Python skit."
 msgstr ""
+"Prenez note que les traces d'appels sont traitées de façon vraiment "
+"particulière. Précisément, dans l'exemple ré-écrit, l'utilisation de ``...`` "
+"est indépendante de l'option *doctest* :const:`ELLIPSIS`. Les points de "
+"suspension dans cet exemple peuvent être omis, ou peuvent aussi être trois "
+"(ou trois cents) virgules ou chiffres, ou une retranscription indentée d'une "
+"parodie de Monty Python."
 
 #: library/doctest.rst:461
 msgid "Some details you should read once, but won't need to remember:"
 msgstr ""
+"Quelques détails que vous devriez lire une fois, mais que vous pouvez "
+"oublier :"
 
 #: library/doctest.rst:463
 msgid ""
@@ -427,6 +609,13 @@ msgid ""
 "ordinary output rarely begins with a traceback header line, so this doesn't "
 "create real problems."
 msgstr ""
+"*Doctest* ne peut pas deviner si votre sortie attendue provient d'une trace "
+"d'appels issue d'une exception ou d'un affichage ordinaire. Ainsi, si nous "
+"avons un exemple s'attendant à obtenir ``ValueError: 42 is prime``, celui-ci "
+"réussira peu importe si :exc:`ValueError` est réellement levée ou si "
+"l'exemple affiche simplement ce texte de trace d'appels. Dans la pratique, "
+"une sortie ordinaire commence rarement par une ligne d'en-tête de trace "
+"d'appels ; ainsi, ceci ne pose pas de vrai problème."
 
 #: library/doctest.rst:470
 msgid ""
@@ -436,6 +625,13 @@ msgid ""
 "with an alphanumeric is taken to be the start of the exception detail.  Of "
 "course this does the right thing for genuine tracebacks."
 msgstr ""
+"Chaque ligne de la trace d'appel (s'il y en a) doit soit être indentée d'un "
+"niveau supplémentaire au niveau de la première ligne de l'exemple *ou* doit "
+"commencer par un caractère qui ne soit pas alphanumérique. La première ligne "
+"suivant l'en-tête de la trace d'appels qui soit indentée similairement et "
+"qui commence par un caractère alphanumérique est comprise comme étant le "
+"début du détail de l'exception. Bien sûr, ceci fait la chose adéquate pour "
+"les traces d'appels véritables."
 
 #: library/doctest.rst:476
 msgid ""
@@ -443,6 +639,9 @@ msgid ""
 "everything following the leftmost colon and any module information in the "
 "exception name is ignored."
 msgstr ""
+"Lorsque l'option de *doctest* :const:`IGNORE_EXCEPTION_DETAIL` est définie, "
+"tout ce qui suit le point-virgule se trouvant le plus à gauche ainsi que "
+"toute information liée au module dans le nom de l'exception sont ignorés."
 
 #: library/doctest.rst:480
 msgid ""
@@ -452,12 +651,21 @@ msgid ""
 "need to test a :exc:`SyntaxError` that omits the traceback header, you will "
 "need to manually add the traceback header line to your test example."
 msgstr ""
+"Le shell interactif omet la ligne d'en-tête de la trace d'appels pour "
+"certaines erreurs :exc:`SyntaxError`. Ceci étant dit, *doctest* utilise la "
+"ligne d'en-tête de la trace d'appels afin de faire une distinction entre les "
+"exceptions et les autres types d'erreurs. Ainsi, dans les rares cas où vous "
+"avez besoin de tester une erreur :exc:`SyntaxError` qui omet l'en-tête de la "
+"trace d'appels, il vous est nécessaire d'ajouter manuellement la ligne d'en-"
+"tête de la trace d'appels à l'exemple de test."
 
 #: library/doctest.rst:488
 msgid ""
 "For some :exc:`SyntaxError`\\ s, Python displays the character position of "
 "the syntax error, using a ``^`` marker::"
 msgstr ""
+"Pour certaines erreurs :exc:`SyntaxError`, Python affiche la position du "
+"caractère de l'erreur de syntaxe, en utilisant un marqueur ``^`` ::"
 
 #: library/doctest.rst:497
 msgid ""
@@ -466,10 +674,14 @@ msgid ""
 "following test would pass, even though it puts the ``^`` marker in the wrong "
 "location::"
 msgstr ""
+"Comme les lignes dénotant la position de l'erreur précèdent le type et le "
+"détail de l'exception, elles ne sont pas vérifiées par *doctest*. Par "
+"exemple, le test suivant réussira, même si le marqueur ``^`` n'est pas à la "
+"bonne place ::"
 
 #: library/doctest.rst:513
 msgid "Option Flags"
-msgstr ""
+msgstr "Options de ligne de commande"
 
 #: library/doctest.rst:515
 msgid ""
@@ -480,16 +692,26 @@ msgid ""
 "and may be passed to the doctest command line interface via the ``-o`` "
 "option."
 msgstr ""
+"Un ensemble d'options de ligne de commande contrôle différents aspects du "
+"comportement de *doctest*. Pour les options, des noms symboliques sont "
+"fournis comme des constantes de module, qui peuvent être composés par un OU "
+"bit à bit (:ref:`bitwise ORed <bitwise>`) et passés à diverses fonctions. "
+"Les noms peuvent aussi être utilisés dans des :ref:`instructions doctest "
+"<doctest-directives>`, et peuvent être passés à l'interface de ligne de "
+"commande de *doctest* à l'aide de l'option ``-o``."
 
 #: library/doctest.rst:521
 msgid "The ``-o`` command line option."
-msgstr ""
+msgstr "L'option de ligne de commande ``-o``."
 
 #: library/doctest.rst:524
 msgid ""
 "The first group of options define test semantics, controlling aspects of how "
 "doctest decides whether actual output matches an example's expected output:"
 msgstr ""
+"Le premier groupe d'options définit les sémantiques de test, de façon à "
+"contrôler comment *doctest* décide si la sortie obtenue correspond à la "
+"sortie attendue de l'exemple :"
 
 #: library/doctest.rst:530
 msgid ""
@@ -502,6 +724,16 @@ msgid ""
 "output still work in these cases.  This option will probably go away, but "
 "not for several years."
 msgstr ""
+"Par défaut, si un bloc de sortie attendu contient uniquement un ``1``, un "
+"vrai bloc de sortie contenant uniquement un ``1`` ou un ``True`` sera "
+"considéré comme étant une correspondance ; de façon similaire, nous avons "
+"une correspondance pour ``0`` et ``False``. Lorsque l'option :const:"
+"`DONT_ACCEPT_TRUE_FOR_1` est précisée, aucune de ces substitutions n'est "
+"acceptée. Le comportement par défaut s'ajuste au fait que Python a changé le "
+"type de renvoi de plusieurs fonctions, passant de nombres entiers à des "
+"booléens ; les *doctests* s'attendant à une sortie de \"petit entier"
+"\" (*little integer*) fonctionnent encore dans ces cas. Cette option "
+"disparaîtra probablement, mais pas avant plusieurs années."
 
 #: library/doctest.rst:542
 msgid ""
@@ -511,6 +743,13 @@ msgid ""
 "is the only way to communicate that a blank line is expected.  When :const:"
 "`DONT_ACCEPT_BLANKLINE` is specified, this substitution is not allowed."
 msgstr ""
+"Par défaut, si un bloc de sortie attendue contient une ligne contenant "
+"uniquement la chaîne de caractères ``<BLANKLINE>``, alors cette ligne sera "
+"en correspondance avec une ligne vide dans la sortie réelle. Puisqu'une "
+"véritable ligne vide permet de délimiter la sortie attendue, ceci est la "
+"seule façon de communiquer qu'une ligne vide est souhaitée. Lorsque "
+"l'option :const:`DONT_ACCEPT_BLANKLINE` est précisée, cette substitution "
+"n'est pas permise."
 
 #: library/doctest.rst:551
 msgid ""
@@ -521,6 +760,14 @@ msgid ""
 "useful when a line of expected output is very long, and you want to wrap it "
 "across multiple lines in your source."
 msgstr ""
+"Lorsque précisé, toutes les séquences de caractères d'espacement et de "
+"caractères de saut de ligne sont traitées comme équivalentes. Toute séquence "
+"de caractères d'espacement à l'intérieur de la sortie attendue correspondra "
+"alors à toute séquence de caractères d'espacement à l'intérieur de la sortie "
+"réelle. Par défaut, les caractères d'espacement doivent correspondre de "
+"façon exacte. L'option :const:`NORMALIZE_WHITESPACE` est particulièrement "
+"utile lorsqu'une ligne de sortie attendue est très longue, et que l'on "
+"souhaite la répartir sur plusieurs lignes dans le fichier source."
 
 #: library/doctest.rst:562
 msgid ""
@@ -530,6 +777,14 @@ msgid ""
 "this simple. Complicated uses can lead to the same kinds of \"oops, it "
 "matched too much!\" surprises that ``.*`` is prone to in regular expressions."
 msgstr ""
+"Lorsque précisé, un marqueur de points de suspension (``...``) dans la "
+"sortie attendue peut correspondre à n'importe quelle partie de chaîne de "
+"caractères dans la sortie réelle. Ceci inclut les parties qui traversent les "
+"frontières de lignes, ainsi que les parties vides de chaînes de caractères ; "
+"ainsi, il est préférable d'en faire une utilisation simple. Les usages "
+"complexes mènent aux mêmes surprises du type \"oups, il y avait trop de "
+"correspondances !\" que l'utilisation de ``.*`` dans les expressions "
+"régulières."
 
 #: library/doctest.rst:571
 msgid ""
@@ -539,6 +794,11 @@ msgid ""
 "the actual exception raised is ``ValueError: 3*14``, but will fail, e.g., "
 "if :exc:`TypeError` is raised."
 msgstr ""
+"Lorsque précisé, un exemple qui s'attend à une exception réussit le test si "
+"une exception du type attendu est levée, même si le détail de l'exception ne "
+"correspond pas. Par exemple, un exemple s'attendant à ``ValueError: 42`` "
+"réussira si l'exception réellement levée est ``ValueError: 3*14``, mais "
+"échouera si par exemple :exc:`TypeError` est levée."
 
 #: library/doctest.rst:577
 msgid ""
@@ -546,6 +806,10 @@ msgid ""
 "both of these variations will work with the flag specified, regardless of "
 "whether the test is run under Python 2.7 or Python 3.2 (or later versions)::"
 msgstr ""
+"Il fera fi du nom de module utilisé dans les rapports *doctest* de Python 3. "
+"Ainsi, ces deux variations fonctionneront avec l'option précisée, peu "
+"importe si le test est exécuté avec Python 2.7 ou Python 3.2 (ou des "
+"versions ultérieures) ::"
 
 #: library/doctest.rst:589
 msgid ""
@@ -558,6 +822,15 @@ msgid ""
 "support :ref:`doctest directives <doctest-directives>` and ignore them as "
 "irrelevant comments). For example::"
 msgstr ""
+"Prendre note que :const:`ELLIPSIS` peut aussi être utilisée afin d'ignorer "
+"les détails du message d'exception, mais un tel test peut tout de même "
+"échouer si les détails du module sont affichés comme faisant partie du nom "
+"de l'exception. L'utilisation de :const:`IGNORE_EXCEPTION_DETAIL` et des "
+"détails de Python 2.3 est aussi la seule façon claire d'écrire un *doctest* "
+"qui ne se soucie pas du détail d'exception tout en continuant de réussir, et "
+"ce, pour Python 2.3 ou antérieur (ces versions ne supportent pas les :ref:"
+"`instructions doctest <doctest-directives>`, les ignorant et les traitant "
+"comme des commentaires sans pertinence). Par exemple ::"
 
 #: library/doctest.rst:603
 msgid ""
@@ -565,12 +838,18 @@ msgid ""
 "even though the detail changed in Python 2.4 to say \"does not\" instead of "
 "\"doesn't\"."
 msgstr ""
+"réussit sous Python 2.3 ainsi que pour les versions ultérieures de Python, "
+"avec l'option précisée, même si le détail a été changé dans Python 2.4 pour "
+"mentionner *\"does not\"* plutôt que *\"doesn't\"* (ne fait pas)."
 
 #: library/doctest.rst:607
 msgid ""
 ":const:`IGNORE_EXCEPTION_DETAIL` now also ignores any information relating "
 "to the module containing the exception under test."
 msgstr ""
+"Maintenant, :const:`IGNORE_EXCEPTION_DETAIL` permet aussi d'ignorer toute "
+"information liée au module contenant l'exception qui est en train d'être "
+"testée."
 
 #: library/doctest.rst:614
 msgid ""
@@ -580,31 +859,48 @@ msgid ""
 "be checked.  E.g., the example's output might be random; or the example "
 "might depend on resources which would be unavailable to the test driver."
 msgstr ""
+"Lorsque précisé, cesse complètement l'exécution de tous les exemples. Ceci "
+"peut être utile dans des contextes où les exemples *doctest* sont à la fois "
+"de la documentation et des cas de tests, et qu'un exemple doit être inclus "
+"pour des raisons de documentation, mais ne devrait pas être vérifié. Par "
+"exemple, la sortie de l'exemple doit être aléatoire ; ou encore, lorsque "
+"l'exemple peut dépendre de ressources inatteignables pour l'exécuteur de "
+"test."
 
 #: library/doctest.rst:620
 msgid ""
 "The SKIP flag can also be used for temporarily \"commenting out\" examples."
 msgstr ""
+"L'option *SKIP* peut aussi être utilisée temporairement afin de commenter "
+"des exemples et d'en empêcher l'exécution."
 
 #: library/doctest.rst:625
 msgid "A bitmask or'ing together all the comparison flags above."
 msgstr ""
+"Un masque binaire effectuant une composition avec OU de toutes les options "
+"de comparaisons ci-dessus."
 
 #: library/doctest.rst:627
 msgid "The second group of options controls how test failures are reported:"
 msgstr ""
+"Le deuxième groupe d'options détermine comment les échecs de tests sont "
+"signalés :"
 
 #: library/doctest.rst:632
 msgid ""
 "When specified, failures that involve multi-line expected and actual outputs "
 "are displayed using a unified diff."
 msgstr ""
+"Lorsque précisé, les défaillances qui font intervenir des sorties attendues "
+"et réelles multi-lignes sont affichées dans une *diff* unifiée."
 
 #: library/doctest.rst:638
 msgid ""
 "When specified, failures that involve multi-line expected and actual outputs "
 "will be displayed using a context diff."
 msgstr ""
+"Lorsque précisé, les défaillances qui font intervenir des sorties attendues "
+"et réelles multi-lignes sont affichées dans une *diff* de contexte."
 
 #: library/doctest.rst:644
 msgid ""
@@ -615,6 +911,13 @@ msgid ""
 "output contains letter ``l``, a line is inserted with a caret marking the "
 "mismatching column positions."
 msgstr ""
+"Lorsque précisé, les différences sont obtenues grâce à ``difflib.Differ``, "
+"en utilisant le même algorithme que le populaire utilitaire :file:`ndiff."
+"py`. Ceci est la seule méthode qui puisse faire la différence à l'intérieur "
+"des lignes ainsi que parmi les lignes prises conjointement. Par exemple, si "
+"une ligne de sortie attendue contient le chiffre ``1`` alors que la sortie "
+"réelle contient la lettre ``l``, une ligne est insérée avec un marqueur "
+"caret démarquant les positions de colonnes où il n'y a pas de correspondance."
 
 #: library/doctest.rst:653
 msgid ""
@@ -626,6 +929,14 @@ msgid ""
 "remaining examples are still run, and still count towards the total number "
 "of failures reported; only the output is suppressed."
 msgstr ""
+"Lorsque précisé, le premier exemple défaillant de chaque *doctest* est "
+"affiché, mais la sortie est supprimée pour tous les autres exemples. Ceci "
+"empêche *doctest* de rapporter les exemples adéquats qui échouent du fait "
+"d'échecs précédents ; ceci peut aussi cacher des exemples inadéquats qui "
+"échouent de façon indépendante au premier échec. Lorsque :const:"
+"`REPORT_ONLY_FIRST_FAILURE` est précisé, les exemples restants sont toujours "
+"exécutés, et sont toujours comptabilisés dans le nombre total des lignes "
+"échouant ; seulement la sortie est omise."
 
 #: library/doctest.rst:664
 msgid ""
@@ -634,22 +945,34 @@ msgid ""
 "most 1.  This flag may be useful during debugging, since examples after the "
 "first failure won't even produce debugging output."
 msgstr ""
+"Lorsque précisé, mettre fin à l'exécution après le premier exemple "
+"défaillant et ne pas essayer d'exécuter les exemples restants. Ainsi, le "
+"nombre d'échecs rapporté sera au plus un (1). Cette option peut être utile "
+"durant le débogage, étant donné que les exemples suivant le premier échec ne "
+"produiront aucune sortie de débogage."
 
 #: library/doctest.rst:669
 msgid ""
 "The doctest command line accepts the option ``-f`` as a shorthand for ``-o "
 "FAIL_FAST``."
 msgstr ""
+"La ligne de commande de *doctest* accepte l'option ``-f`` comme un raccourci "
+"de ``-o FAIL_FAST``."
 
 #: library/doctest.rst:677
 msgid "A bitmask or'ing together all the reporting flags above."
 msgstr ""
+"Un masque binaire effectuant une composition avec le OU de toutes les "
+"options de signalement ci-dessus."
 
 #: library/doctest.rst:680
 msgid ""
 "There is also a way to register new option flag names, though this isn't "
 "useful unless you intend to extend :mod:`doctest` internals via subclassing:"
 msgstr ""
+"Il y a aussi une façon d'enregistrer des nouveaux noms d'option, quoique "
+"ceci n'est pas utile sauf dans le cas où vous devez faire une extension pour "
+"le code interne de :mod:`doctest` par le biais d'une sous-classe :"
 
 #: library/doctest.rst:686
 msgid ""
@@ -659,11 +982,17 @@ msgid ""
 "are supported by your subclasses.  :func:`register_optionflag` should always "
 "be called using the following idiom::"
 msgstr ""
+"Crée une nouvelle option avec un nom donné, et renvoie la valeur en nombre "
+"entier de la nouvelle option. La fonction :func:`register_optionflag` peut "
+"être utilisée lors de la création de sous-classes à partir de :class:"
+"`OutputChecker` ou :class:`DocTestRunner` pour créer de nouvelles options "
+"qui sont supportées par vos sous-classes. La fonction :func:"
+"`register_optionflag` devrait toujours être appelée par l'expression "
+"suivante ::"
 
 #: library/doctest.rst:702
-#, fuzzy
 msgid "Directives"
-msgstr "Directive"
+msgstr "Instructions"
 
 #: library/doctest.rst:704
 msgid ""
@@ -671,23 +1000,34 @@ msgid ""
 "options>` for an individual example.  Doctest directives are special Python "
 "comments following an example's source code:"
 msgstr ""
+"Les instructions *doctest* peuvent être utilisées afin de modifier les :ref:"
+"`options <doctest-options>` pour un exemple individuel. Les instructions "
+"*doctest* sont des commentaires Python spéciaux suivant le code source d'un "
+"exemple :"
 
 #: library/doctest.rst:715
+#, fuzzy
 msgid ""
 "Whitespace is not allowed between the ``+`` or ``-`` and the directive "
 "option name.  The directive option name can be any of the option flag names "
 "explained above."
 msgstr ""
+"Les caractères d'espacement ne sont pas permis entre les ``+`` ou les ``-`` "
+"et le nom de l'option d'instruction. Le nom de l'option d'instruction peut "
+"être n'importe lequel des noms d'options expliqués ci-dessus."
 
 #: library/doctest.rst:719
 msgid ""
 "An example's doctest directives modify doctest's behavior for that single "
 "example.  Use ``+`` to enable the named behavior, or ``-`` to disable it."
 msgstr ""
+"Les instructions d'un exemple *doctest* modifient le comportement de "
+"*doctest* et ce, seulement pour cet exemple. Utilisez ``+`` pour activer le "
+"comportement nommé, ou ``-`` pour le désactiver."
 
 #: library/doctest.rst:722
 msgid "For example, this test passes::"
-msgstr ""
+msgstr "Par exemple, ce test réussit ::"
 
 #: library/doctest.rst:728
 msgid ""
@@ -696,18 +1036,27 @@ msgid ""
 "actual output is on a single line.  This test also passes, and also requires "
 "a directive to do so::"
 msgstr ""
+"Sans l'instruction, ce serait un échec, et ce, à la fois parce que la sortie "
+"réelle n'a pas deux espaces vides avant les éléments de la liste formés d'un "
+"seul chiffre, et aussi parce que la sortie réelle est contenue sur une seule "
+"ligne. Ce test réussit aussi, et nécessite lui aussi une instruction pour ce "
+"faire ::"
 
 #: library/doctest.rst:736
 msgid ""
 "Multiple directives can be used on a single physical line, separated by "
 "commas::"
 msgstr ""
+"Plusieurs instructions sont utilisées sur une unique ligne physique, "
+"séparées par des virgules ::"
 
 #: library/doctest.rst:742
 msgid ""
 "If multiple directive comments are used for a single example, then they are "
 "combined::"
 msgstr ""
+"Si plusieurs commentaires d'instructions sont utilisés pour un exemple "
+"unique, alors ils sont combinés ::"
 
 #: library/doctest.rst:749
 msgid ""
@@ -715,6 +1064,10 @@ msgid ""
 "containing only directives.  This can be useful when an example is too long "
 "for a directive to comfortably fit on the same line::"
 msgstr ""
+"Comme l'exemple précédent le démontre, vous pouvez ajouter des lignes "
+"contenant des points de suspension ``...`` à votre exemple ne contenant que "
+"des instructions. Ceci peut être utile lorsqu'un exemple est trop long pour "
+"qu'une instruction puisse être écrite sur la même ligne ::"
 
 #: library/doctest.rst:757
 msgid ""
@@ -725,6 +1078,14 @@ msgid ""
 "defaults.  In such cases, disabling an option via ``-`` in a directive can "
 "be useful."
 msgstr ""
+"Prendre note que puisque toutes les options sont désactivées par défaut, et "
+"comme les instructions s'appliquent uniquement aux exemples dans lesquelles "
+"elles apparaissent, activer les options (par le biais de ``+`` dans une "
+"instruction) est habituellement le seul choix ayant du sens. Toutefois, les "
+"options peuvent aussi être passées aux fonctions qui exécutent les "
+"*doctests*, définissant de nouvelles valeurs par défaut. Dans de tels cas, "
+"désactiver une option par l'utilisation de ``-`` dans une instruction peut "
+"être utile."
 
 #: library/doctest.rst:767
 msgid "Warnings"
@@ -739,34 +1100,47 @@ msgid ""
 "doesn't guarantee that the element is printed in any particular order, so a "
 "test like ::"
 msgstr ""
+"Le module :mod:`doctest` est rigoureux pour ce qui est d'inclure des "
+"correspondances exactes dans la sortie attendue. Si un seul caractère ne "
+"correspond pas, le test échoue. Ceci vous surprendra probablement quelques "
+"fois, alors que vous apprenez exactement ce que Python garantit et ne "
+"garantit pas pour qui est des sorties. Par exemple, lorsqu'on affiche un "
+"ensemble (set), Python ne garantit pas que les éléments sont affichés dans "
+"un ordre particulier ; ainsi un test tel que ::"
 
 #: library/doctest.rst:778
 msgid "is vulnerable!  One workaround is to do ::"
-msgstr ""
+msgstr "est vulnérable ! Une alternative est de faire ::"
 
 #: library/doctest.rst:783
 msgid "instead.  Another is to do ::"
-msgstr ""
+msgstr "à la place. Une autre façon de faire est ::"
 
 #: library/doctest.rst:791
 msgid ""
 "Before Python 3.6, when printing a dict, Python did not guarantee that the "
 "key-value pairs was printed in any particular order."
 msgstr ""
+"Avant Python 3.6, lorsque Python affichait un *dict*, il ne garantissait pas "
+"que les paires clés-valeurs suivaient un ordre particulier."
 
 #: library/doctest.rst:794
 msgid "There are others, but you get the idea."
-msgstr ""
+msgstr "Il y en a d'autres, mais vous saisissez l'idée."
 
 #: library/doctest.rst:796
 msgid ""
 "Another bad idea is to print things that embed an object address, like ::"
 msgstr ""
+"Une autre mauvaise idée est d'afficher des choses intégrant l'adresse d'un "
+"objet, comme ceci ::"
 
 #: library/doctest.rst:804
 msgid ""
 "The :const:`ELLIPSIS` directive gives a nice approach for the last example::"
 msgstr ""
+"L'instruction :const:`ELLIPSIS` donne une approche sympathique pour le "
+"dernier exemple ::"
 
 #: library/doctest.rst:809
 msgid ""
@@ -774,22 +1148,33 @@ msgid ""
 "platforms, because Python defers to the platform C library for float "
 "formatting, and C libraries vary widely in quality here. ::"
 msgstr ""
+"Les nombres à virgule flottante sont aussi sujets à de petites variations à "
+"la sortie, tout dépendamment de la plateforme utilisée, étant donné que "
+"Python s'en remet à la bibliothèque de la plateforme C pour la mise-en-forme "
+"des *floats*, et les bibliothèques C varient grandement pour ce qui de leur "
+"qualité sur ce point. ::"
 
 #: library/doctest.rst:820
+#, fuzzy
 msgid ""
 "Numbers of the form ``I/2.**J`` are safe across all platforms, and I often "
 "contrive doctest examples to produce numbers of that form::"
 msgstr ""
+"Les nombres ayant la forme ``I/2.**J`` sont sécuritaires pour toutes les "
+"plateformes, et je restreins souvent les exemples *doctest* à produire des "
+"nombres ayant cette forme ::"
 
 #: library/doctest.rst:826
 msgid ""
 "Simple fractions are also easier for people to understand, and that makes "
 "for better documentation."
 msgstr ""
+"Les fractions simples sont aussi plus faciles à comprendre, et cela fait une "
+"meilleure documentation."
 
 #: library/doctest.rst:833
 msgid "Basic API"
-msgstr ""
+msgstr "API de base"
 
 #: library/doctest.rst:835
 msgid ""
@@ -798,24 +1183,35 @@ msgid ""
 "less formal introduction to these two functions, see sections :ref:`doctest-"
 "simple-testmod` and :ref:`doctest-simple-testfile`."
 msgstr ""
+"Les fonctions :func:`testmod` et :func:`testfile` fournissent une interface "
+"simple pour *doctest* qui est suffisante pour les cas d'usage les plus "
+"élémentaires. Pour une introduction moins formelle à ces deux fonctions, "
+"voir les sections :ref:`doctest-simple-testmod` et :ref:`doctest-simple-"
+"testfile`."
 
 #: library/doctest.rst:843
 msgid ""
 "All arguments except *filename* are optional, and should be specified in "
 "keyword form."
 msgstr ""
+"Tous les arguments sauf *filename* sont optionnels, et doivent être précisés "
+"sous forme lettrée."
 
 #: library/doctest.rst:846
 msgid ""
 "Test examples in the file named *filename*.  Return ``(failure_count, "
 "test_count)``."
 msgstr ""
+"Teste les exemples dans le fichier nommé *filename*. Renvoie "
+"``(failure_count, test_count)``."
 
 #: library/doctest.rst:849
 msgid ""
 "Optional argument *module_relative* specifies how the filename should be "
 "interpreted:"
 msgstr ""
+"L'argument optionnel *module_relative* précise comment le nom de fichier "
+"doit être interprété :"
 
 #: library/doctest.rst:852
 msgid ""
@@ -826,6 +1222,14 @@ msgid ""
 "should use ``/`` characters to separate path segments, and may not be an "
 "absolute path (i.e., it may not begin with ``/``)."
 msgstr ""
+"Si *module_relative* prend la valeur ``True`` (la valeur par défaut), alors "
+"*filename* précise un chemin relatif au module qui soit indépendant du "
+"système d'exploitation (*OS*). Par défaut, ce chemin est relatif au "
+"répertoire du module appelant ; mais si l'argument *package* est précisé, "
+"alors il est relatif à ce paquet. Pour garantir l'indépendance quant au "
+"système d'exploitation, *filename* doit utiliser des caractères ``/`` pour "
+"séparer chaque segment de chemin, et ne peut pas être un chemin absolu "
+"(c'est-à-dire qu'il ne peut pas commencer par ``/``)."
 
 #: library/doctest.rst:859
 msgid ""
@@ -833,12 +1237,17 @@ msgid ""
 "path.  The path may be absolute or relative; relative paths are resolved "
 "with respect to the current working directory."
 msgstr ""
+"Si *module_relative* prend la valeur ``False``, alors *filename* précise un "
+"chemin en fonction du système d'exploitation. Le chemin peut être absolu ou "
+"relatif ; les chemins relatifs sont résolus en rapport au répertoire actif."
 
 #: library/doctest.rst:863
 msgid ""
 "Optional argument *name* gives the name of the test; by default, or if "
 "``None``, ``os.path.basename(filename)`` is used."
 msgstr ""
+"L'option *name* désigne le nom du test ; par défaut, ou si ``None`` est "
+"passé en argument, ``os.path.basename(filename)`` est utilisé."
 
 #: library/doctest.rst:866
 msgid ""
@@ -848,6 +1257,12 @@ msgid ""
 "directory is used as the base directory for module-relative filenames.  It "
 "is an error to specify *package* if *module_relative* is ``False``."
 msgstr ""
+"L'option *package* est un paquet Python ou le nom d'un paquet Python dont le "
+"répertoire doit être utilisé comme le répertoire principal pour un nom de "
+"fichier lié à un module. Si aucun paquet n'est spécifié, le répertoire du "
+"module appelé à l'exécution est utilisé comme le répertoire principal pour "
+"les noms de fichiers liés au module. C'est une erreur que de spécifier "
+"*package* si *module_relative* a ``False`` comme valeur."
 
 #: library/doctest.rst:872
 msgid ""
@@ -856,6 +1271,10 @@ msgid ""
 "doctest, so its examples start with a clean slate. By default, or if "
 "``None``, a new empty dict is used."
 msgstr ""
+"L'option *globs* spécifie un *dict* à utiliser comme *globals* lorsque des "
+"exemples sont exécutés. Une copie superficielle de ce *dict* est créée pour "
+"le *doctest* ; ainsi, ces exemples commencent avec un état vide. Par défaut, "
+"ou si ``None`` est passé en argument, un nouveau *dict* vide est utilisé."
 
 #: library/doctest.rst:877
 msgid ""
@@ -869,6 +1288,16 @@ msgid ""
 "passing an *extraglobs* dict mapping the generic name to the subclass to be "
 "tested."
 msgstr ""
+"L'option *extraglobs* spécifie un *dict* intégré dans les variables globales "
+"utilisées pour exécuter l'exemple. Ceci fonctionne comme :meth:`dict."
+"update` : si *globs* et *extraglobs* ont une clé commune, la valeur associée "
+"à *extraglobs* apparaît dans le *dict* combiné. Par défaut, ou si ``None`` "
+"est passé en argument, aucune variable globale supplémentaire est utilisée. "
+"Ceci est une fonctionnalité avancée qui permet la configuration des "
+"*doctests*. Par exemple, un *doctest* peut être rédigé pour une classe de "
+"base, en utilisant un nom générique pour la classe, puis réutilisé afin de "
+"tester un nombre indéfini de sous-classes en passant un *dict* *extraglobs* "
+"reliant le nom générique à la sous-classe qui doit être testée."
 
 #: library/doctest.rst:886
 msgid ""
@@ -876,6 +1305,10 @@ msgid ""
 "failures if false; by default, or if ``None``, it's true if and only if ``'-"
 "v'`` is in ``sys.argv``."
 msgstr ""
+"L'option *verbose* affiche une grande quantité d'information si elle est "
+"vraie, et affiche uniquement les défaillances si elle est fausse ; par "
+"défaut, ou si ``None``, celle-ci est vraie si et seulement si ``-v`` est "
+"présent dans ``sys.argv``."
 
 #: library/doctest.rst:890
 msgid ""
@@ -883,12 +1316,18 @@ msgid ""
 "prints nothing at the end.  In verbose mode, the summary is detailed, else "
 "the summary is very brief (in fact, empty if all tests passed)."
 msgstr ""
+"L'option *report* affiche un résumé à la fin lorsque vraie ; sinon, rien "
+"n'est affiché à la fin. En mode *verbose*, le résumé est détaillé, sinon le "
+"résumé est très bref (en fait, vide si tous les tests ont réussi)."
 
 #: library/doctest.rst:894
 msgid ""
 "Optional argument *optionflags* (default value 0) takes the :ref:`bitwise OR "
 "<bitwise>` of option flags. See section :ref:`doctest-options`."
 msgstr ""
+"L'option *optionflags* (dont la valeur par défaut est de zéro) calcule la "
+"valeur :ref:`bitwise OR <bitwise>` des options de ligne de commande. Voir la "
+"section :ref:`doctest-options`."
 
 #: library/doctest.rst:898
 msgid ""
@@ -897,25 +1336,38 @@ msgid ""
 "This allows failures to be post-mortem debugged. Default behavior is to "
 "continue running examples."
 msgstr ""
+"L'option *raise_on_error* est fausse par défaut. Si elle est vraie, une "
+"exception est levée à la première défaillance ou à la première exception qui "
+"ne soit prévue dans l'exemple. Ceci permet aux défaillances d'être analysées "
+"lors d'un post-mortem. Le comportement par défaut est de poursuivre "
+"l'exécution des exemples."
 
-#: library/doctest.rst:1043
+#: library/doctest.rst:903 library/doctest.rst:1043
 msgid ""
 "Optional argument *parser* specifies a :class:`DocTestParser` (or subclass) "
 "that should be used to extract tests from the files.  It defaults to a "
 "normal parser (i.e., ``DocTestParser()``)."
 msgstr ""
+"L'option *parser* définit une classe ou une sous-classe :class:"
+"`DocTestParser` qui doit être utilisée pour extraire les tests des fichiers. "
+"Par défaut, on utilise un analyseur normal (c'est-à-dire, "
+"``DocTestParser()``)."
 
-#: library/doctest.rst:1047
+#: library/doctest.rst:907 library/doctest.rst:1047
 msgid ""
 "Optional argument *encoding* specifies an encoding that should be used to "
 "convert the file to unicode."
 msgstr ""
+"L'option *encoding* définit un encodage à utiliser pour convertir le fichier "
+"en format *unicode*."
 
 #: library/doctest.rst:913
 msgid ""
 "All arguments are optional, and all except for *m* should be specified in "
 "keyword form."
 msgstr ""
+"Toutes les options sont facultatives, et toutes sauf *m* doivent être "
+"définies en format lettré."
 
 #: library/doctest.rst:916
 msgid ""
@@ -923,6 +1375,9 @@ msgid ""
 "*m* (or module :mod:`__main__` if *m* is not supplied or is ``None``), "
 "starting with ``m.__doc__``."
 msgstr ""
+"Ceci teste les exemples en *docstrings* dans les fonctions et les classes "
+"accessibles depuis le module *m* (ou depuis le module :mod:`__main__` si *m* "
+"n'a pas été défini ou est ``None``), en commençant par ``m.__doc__``."
 
 #: library/doctest.rst:920
 msgid ""
@@ -931,21 +1386,31 @@ msgid ""
 "strings; function and class docstrings are searched for examples; strings "
 "are searched directly, as if they were docstrings."
 msgstr ""
+"Ceci teste aussi les exemples accessibles depuis le *dict* ``m.__test__``, "
+"si et seulement s'il existe et qu'il n'est pas ``None``.  Le *dict* ``m."
+"__test__`` associe des noms (chaînes de caractères) à des fonctions, des "
+"classes et des chaînes de caractères ; les *docstrings* de fonctions et de "
+"classes sont fouillées pour des exemples ; les chaînes de caractères sont "
+"fouillées directement, comme si elles étaient des *docstrings*."
 
 #: library/doctest.rst:925
 msgid ""
 "Only docstrings attached to objects belonging to module *m* are searched."
 msgstr ""
+"Seulement les *docstrings* attribuées à des objets appartenant au module *m* "
+"sont fouillées."
 
 #: library/doctest.rst:927
 msgid "Return ``(failure_count, test_count)``."
-msgstr ""
+msgstr "Renvoie ``(failure_count, test_count)``."
 
 #: library/doctest.rst:929
 msgid ""
 "Optional argument *name* gives the name of the module; by default, or if "
 "``None``, ``m.__name__`` is used."
 msgstr ""
+"L'option *name* donne le nom du module ; par défaut, ou si ``None``, ``m."
+"__name__`` est utilisé."
 
 #: library/doctest.rst:932
 msgid ""
@@ -956,6 +1421,14 @@ msgid ""
 "output for objects with no tests. The *exclude_empty* argument to the newer :"
 "class:`DocTestFinder` constructor defaults to true."
 msgstr ""
+"L'option *exclude_empty* prend la valeur faux par défaut. Si la valeur est "
+"vraie, les objets pour lesquels aucun *doctest* n'est trouvé ne sont pas "
+"pris en compte. Le défaut est un bricolage permettant la compatibilité à "
+"rebours, de façon à ce que le code qui utilise toujours :meth:`doctest."
+"master.summarize` en conjonction avec :func:`testmod` puisse continuer "
+"d'obtenir des sorties pour les objets n'ayant aucun test. L'option "
+"*exclude_empty* dans  le constructeur de la classe plus récente :class:"
+"`DocTestFinder` prend vrai comme valeur par défaut."
 
 #: library/doctest.rst:939
 msgid ""
@@ -963,24 +1436,33 @@ msgid ""
 "*raise_on_error*, and *globs* are the same as for function :func:`testfile` "
 "above, except that *globs* defaults to ``m.__dict__``."
 msgstr ""
+"Les options *extraglobs*, *verbose*, *report*, *optionflags*, "
+"*raise_on_error*, et *globs* sont les mêmes que pour la fonction :func:"
+"`testfile` ci-dessus, sauf pour *globs*, qui est ``m.__dict__`` par défaut."
 
 #: library/doctest.rst:946
 msgid ""
 "Test examples associated with object *f*; for example, *f* may be a string, "
 "a module, a function, or a class object."
 msgstr ""
+"Les exemples de test associés à l'objet *f* ; par exemple, *f* peut être une "
+"chaîne de caractères, un module, une fonction, ou un objet de classe."
 
 #: library/doctest.rst:949
 msgid ""
 "A shallow copy of dictionary argument *globs* is used for the execution "
 "context."
 msgstr ""
+"Une copie superficielle de l'argument-dictionnaire *globs* est utilisée pour "
+"le contexte d'exécution."
 
 #: library/doctest.rst:951
 msgid ""
 "Optional argument *name* is used in failure messages, and defaults to ``"
 "\"NoName\"``."
 msgstr ""
+"L'option *name* est utilisée pour les messages d'échec, et prend ``\"NoName"
+"\"`` comme valeur par défaut."
 
 #: library/doctest.rst:954
 msgid ""
@@ -988,6 +1470,9 @@ msgid ""
 "are no failures.  By default, output is generated only in case of an example "
 "failure."
 msgstr ""
+"Si l'option *verbose* est vraie, les sorties sont générées même s'il n'y a "
+"aucun échec. Par défaut, la sortie est générée seulement si un exemple "
+"échoue."
 
 #: library/doctest.rst:957
 msgid ""
@@ -996,15 +1481,21 @@ msgid ""
 "``None``, flags are deduced corresponding to the set of future features "
 "found in *globs*."
 msgstr ""
+"L'option *compileflags* donne l'ensemble des options qui doit être utilisée "
+"par le compilateur Python lorsqu'il exécute les exemples. Par défaut, ou si "
+"``None``, les options sont inférées à partir de l'ensemble des "
+"fonctionnalités futures trouvées dans *globs*."
 
 #: library/doctest.rst:961
 msgid ""
 "Optional argument *optionflags* works as for function :func:`testfile` above."
 msgstr ""
+"L'option *optionflags* fonctionne similairement à la fonction :func:"
+"`testfile` ci-dessus."
 
 #: library/doctest.rst:967
 msgid "Unittest API"
-msgstr ""
+msgstr "API de tests unitaires"
 
 #: library/doctest.rst:969
 msgid ""
@@ -1014,18 +1505,31 @@ msgid ""
 "files containing doctests.  To integrate with :mod:`unittest` test "
 "discovery, include a :func:`load_tests` function in your test module::"
 msgstr ""
+"Au fur et à mesure que la collection de modules testés avec *doctest* "
+"s'agrandira, vous allez souhaiter avoir une façon d'exécuter "
+"systématiquement tous les *doctests*. Le module :mod:`doctest` fournit deux "
+"fonctions qui peuvent être utilisées afin de créer des suites de tests "
+"unitaires :mod:`unittest` à partir des modules et des fichiers textes "
+"contenant des *doctests*. Afin d'intégrer la découverte fournie par :mod:"
+"`unittest`, il suffit d'ajouter une fonction :func:`load_tests` dans votre "
+"module de test ::"
 
 #: library/doctest.rst:983
 msgid ""
 "There are two main functions for creating :class:`unittest.TestSuite` "
 "instances from text files and modules with doctests:"
 msgstr ""
+"Il y a deux fonctions principales pour créer des instances de la classe :"
+"class:`unittest.TestSuite` à partir de fichiers textes et de modules ayant "
+"des *doctests* :"
 
 #: library/doctest.rst:989
 msgid ""
 "Convert doctest tests from one or more text files to a :class:`unittest."
 "TestSuite`."
 msgstr ""
+"Convertit des tests *doctest* à partir d'un ou plusieurs fichiers vers une "
+"classe :class:`unittest.TestSuite`."
 
 #: library/doctest.rst:992
 msgid ""
@@ -1035,20 +1539,30 @@ msgid ""
 "`failureException` exception is raised showing the name of the file "
 "containing the test and a (sometimes approximate) line number."
 msgstr ""
+"La classe renvoyée :class:`unittest.TestSuite` doit être exécutée dans le "
+"cadriciel de tests unitaires et exécute les exemples interactifs trouvés "
+"dans chaque fichier. Si un exemple de n'importe quel fichier échoue, alors "
+"le test unitaire de synthèse échoue aussi, et une exception :exc:"
+"`failureException` est levée, affichant le nom du fichier contenant le test "
+"et un numéro de ligne (celui-ci est parfois approximatif)."
 
 #: library/doctest.rst:998
 msgid "Pass one or more paths (as strings) to text files to be examined."
 msgstr ""
+"Passe un ou plusieurs chemins (sous forme de chaînes de caractères) à des "
+"fichiers textes afin d'être vérifiés."
 
 #: library/doctest.rst:1000
 msgid "Options may be provided as keyword arguments:"
-msgstr ""
+msgstr "Les options peuvent être fournies comme des options lettrées :"
 
 #: library/doctest.rst:1002
 msgid ""
 "Optional argument *module_relative* specifies how the filenames in *paths* "
 "should be interpreted:"
 msgstr ""
+"L'option *module_relative* précise comment les noms de fichiers dans *paths* "
+"doivent être interprétés :"
 
 #: library/doctest.rst:1005
 msgid ""
@@ -1060,6 +1574,14 @@ msgid ""
 "segments, and may not be an absolute path (i.e., it may not begin with ``/"
 "``)."
 msgstr ""
+"Si *module_relative* a ``True`` comme valeur (valeur par défaut), alors "
+"chaque nom de fichier dans *paths* précise un chemin relatif au module qui "
+"soit indépendant du système d'exploitation. Par défaut, ce chemin est "
+"relatif au répertoire du module appelant ; mais si l'option *package* est "
+"précisée, alors il est relatif à ce paquet. Afin de garantir l'indépendance "
+"face au système d'exploitation, chaque nom de fichier doit utiliser des "
+"caractères ``/`` afin de séparer les segments de chemin, et ne peut pas être "
+"un chemin absolu (c'est-à-dire, il ne peut pas commencer par ``/``)."
 
 #: library/doctest.rst:1013
 msgid ""
@@ -1067,6 +1589,9 @@ msgid ""
 "an OS-specific path.  The path may be absolute or relative; relative paths "
 "are resolved with respect to the current working directory."
 msgstr ""
+"Si *module_relative* prend la valeur ``False``, alors *filename* précise un "
+"chemin en fonction du système d'exploitation. Le chemin peut être absolu ou "
+"relatif ; les chemins relatifs sont résolus en rapport au répertoire actif."
 
 #: library/doctest.rst:1017
 msgid ""
@@ -1077,6 +1602,13 @@ msgid ""
 "filenames.  It is an error to specify *package* if *module_relative* is "
 "``False``."
 msgstr ""
+"L'option *package* est un paquet Python ou le nom d'un paquet Python dont le "
+"répertoire dont être utilisé comme le répertoire principal pour un nom de "
+"fichier dans *paths* qui soit lié à un module. Si aucun paquet n'est "
+"spécifié, le répertoire du module appelé à l'exécution est utilisé comme le "
+"répertoire principal pour les noms de fichiers liés au module. C'est une "
+"erreur que de spécifier *package* si *module_relative* a ``False`` comme "
+"valeur."
 
 #: library/doctest.rst:1024
 msgid ""
@@ -1085,6 +1617,11 @@ msgid ""
 "will be passed a :class:`DocTest` object.  The setUp function can access the "
 "test globals as the *globs* attribute of the test passed."
 msgstr ""
+"L'option *setUp* précise une fonction de mise-en-place pour la suite de "
+"tests. Ceci est appelé avant l'exécution des tests dans chaque fichier. La "
+"fonction *setUp* est passée à un objet :class:`DocTest`. La fonction *setUp* "
+"peut accéder aux valeurs globales du test par le biais de l'attribut *globs* "
+"du test passé."
 
 #: library/doctest.rst:1029
 msgid ""
@@ -1093,13 +1630,21 @@ msgid ""
 "function will be passed a :class:`DocTest` object.  The setUp function can "
 "access the test globals as the *globs* attribute of the test passed."
 msgstr ""
+"L'option *tearDown* précise une fonction de démolition pour la suite de "
+"tests. Celle-ci est appelée après avoir exécuté les tests dans chaque "
+"fichier. La fonction *tearDown* est passée à un objet :class:`DocTest`. La "
+"fonction *setUp* peut accéder aux valeurs globales du test par l'attribut "
+"*globs* du test passé."
 
-#: library/doctest.rst:1068
+#: library/doctest.rst:1034 library/doctest.rst:1068
 msgid ""
 "Optional argument *globs* is a dictionary containing the initial global "
 "variables for the tests.  A new copy of this dictionary is created for each "
 "test.  By default, *globs* is a new empty dictionary."
 msgstr ""
+"L'option *globs* est un dictionnaire contenant les variables globales "
+"initiales pour les tests. Une nouvelle copie de ce dictionnaire est créée "
+"pour chaque test. Par défaut, *globs* est un nouveau dictionnaire vide."
 
 #: library/doctest.rst:1038
 msgid ""
@@ -1108,16 +1653,26 @@ msgid ""
 "ref:`doctest-options`. See function :func:`set_unittest_reportflags` below "
 "for a better way to set reporting options."
 msgstr ""
+"Les options *optionflags* précisent les options par défaut de *doctest* pour "
+"les tests, créées en composant par un OU les différentes options "
+"individuelles. Voir la section :ref:`doctest-options`. Voir la fonction :"
+"func:`set_unittest_reportflags` ci-dessous pour une meilleure façon de "
+"préciser des options de rapport."
 
 #: library/doctest.rst:1050
 msgid ""
 "The global ``__file__`` is added to the globals provided to doctests loaded "
 "from a text file using :func:`DocFileSuite`."
 msgstr ""
+"La valeur globale ``__file__`` est ajoutée aux valeurs globales fournies par "
+"les *doctests*, ceux-ci étant téléchargés d'un fichier texte utilisant la "
+"fonction :func:`DocFileSuite`."
 
 #: library/doctest.rst:1056
 msgid "Convert doctest tests for a module to a :class:`unittest.TestSuite`."
 msgstr ""
+"Convertit les tests *doctest* pour un module donné à une classe :class:"
+"`unittest.TestSuite`."
 
 #: library/doctest.rst:1058
 msgid ""
@@ -1127,6 +1682,12 @@ msgid ""
 "exception is raised showing the name of the file containing the test and a "
 "(sometimes approximate) line number."
 msgstr ""
+"La classe renvoyée :class:`unittest.TestSuite` doit être exécutée par le "
+"cadriciel de test unitaire, afin d'exécuter chaque *doctest* dans le module. "
+"Si n'importe lequel des *doctests* échoue, alors le test unitaire de "
+"synthèse échoue, et une exception :exc:`failureException` est levée, "
+"affichant le nom du fichier contenant le test et un numéro de ligne pouvant "
+"être approximatif."
 
 #: library/doctest.rst:1064
 msgid ""
@@ -1134,34 +1695,49 @@ msgid ""
 "module object or a (possibly dotted) module name.  If not specified, the "
 "module calling this function is used."
 msgstr ""
+"L'option *module* fournit le module qui sera testé. Il peut prendre la forme "
+"d'un objet-module ou celle du nom d'un module (possiblement *dotted*). Si "
+"non-précisée, le module appelant cette fonction est utilisé."
 
 #: library/doctest.rst:1072
 msgid ""
 "Optional argument *extraglobs* specifies an extra set of global variables, "
 "which is merged into *globs*.  By default, no extra globals are used."
 msgstr ""
+"L'option *extraglobs* précise un ensemble supplémentaire de variables "
+"globales, à fusionner avec *globs*. Par défaut, aucune variable globale "
+"supplémentaire est utilisée."
 
 #: library/doctest.rst:1075
 msgid ""
 "Optional argument *test_finder* is the :class:`DocTestFinder` object (or a "
 "drop-in replacement) that is used to extract doctests from the module."
 msgstr ""
+"L'option *test_finder* est l'instance de :class:`DocTestFinder` (ou un "
+"remplacement *drop-in*) qui est utilisée pour extraire les *doctests* à "
+"partir du module."
 
 #: library/doctest.rst:1078
 msgid ""
 "Optional arguments *setUp*, *tearDown*, and *optionflags* are the same as "
 "for function :func:`DocFileSuite` above."
 msgstr ""
+"Les options *setUp*, *tearDown* et *optionflags* sont les mêmes que pour la "
+"fonction :func:`DocFileSuite` ci-dessus."
 
 #: library/doctest.rst:1081
 msgid "This function uses the same search technique as :func:`testmod`."
 msgstr ""
+"Cette fonction utilise la même technique de recherche que :func:`testmod`."
 
 #: library/doctest.rst:1083
 msgid ""
 ":func:`DocTestSuite` returns an empty :class:`unittest.TestSuite` if "
 "*module* contains no docstrings instead of raising :exc:`ValueError`."
 msgstr ""
+"La fonction :func:`DocTestSuite` renvoie une instance vide de la classe :"
+"class:`unittest.TestSuite` si *module* ne contient aucune *docstring*, et "
+"ce, au lieu de lever l'exception :exc:`ValueError`."
 
 #: library/doctest.rst:1088
 msgid ""
@@ -1171,6 +1747,12 @@ msgid ""
 "documented here (it's an internal detail), but studying its code can answer "
 "questions about the exact details of :mod:`unittest` integration."
 msgstr ""
+"Sous le capot, :func:`DocTestSuite` crée une classe :class:`unittest."
+"TestSuite` à partir d'instances de :class:`doctest.DocTestCase` ; de plus, :"
+"class:`DocTestCase` est une sous-classe de :class:`unittest.TestCase`. La "
+"classe :class:`DocTestCase` n'est pas documentée ici (c'est un détail "
+"interne), mais l'étude de son code peut répondre à des questions concernant "
+"les détails exacts de l'intégration du module :mod:`doctest`."
 
 #: library/doctest.rst:1094
 msgid ""
@@ -1178,6 +1760,9 @@ msgid ""
 "of :class:`doctest.DocFileCase` instances, and :class:`DocFileCase` is a "
 "subclass of :class:`DocTestCase`."
 msgstr ""
+"De la même façon, :func:`DocFileSuite` crée une classe :class:`unittest."
+"TestSuite` à partir des instances :class:`doctest.DocFileCase`, où :class:"
+"`DocFileCase` est une sous-classe de :class:`DocTestCase`."
 
 #: library/doctest.rst:1098
 msgid ""
@@ -1191,22 +1776,41 @@ msgid ""
 "specified by command line options), but there's no way to pass options "
 "through :mod:`unittest` to :mod:`doctest` test runners."
 msgstr ""
+"Ainsi, les deux façons de créer une :class:`unittest.TestSuite` utilisent "
+"des instances de la classe :class:`DocTestCase`. Ceci est important pour une "
+"raison subtile : lorsque vous exécutez par vous-même des fonctions :mod:"
+"`doctest`, vous pouvez contrôler les options :mod:`doctest` qui sont "
+"utilisées de façon directe, en passant des options aux fonctions :mod:"
+"`doctest`. Toutefois, si vous écrivez un cadriciel :mod:`unittest`, alors :"
+"mod:`unittest` a le contrôle final de quand et de comment les tests sont "
+"exécutés. La personne qui écrit le cadriciel souhaite habituellement "
+"contrôler les options de rapport de :mod:`doctest` (qui sont peut-être, par "
+"exemple, spécifiées en options de ligne de commande), sauf qu'il n'y a pas "
+"de moyen de spécifier des options à l'attention des exécuteurs de test de :"
+"mod:`doctest` à partir de :mod:`unittest`."
 
 #: library/doctest.rst:1108
 msgid ""
 "For this reason, :mod:`doctest` also supports a notion of :mod:`doctest` "
 "reporting flags specific to :mod:`unittest` support, via this function:"
 msgstr ""
+"Pour cette raison, :mod:`doctest` implémente le concept d'options de rapport "
+"de :mod:`doctest` qui soit spécifique à :mod:`unittest`, par le biais de "
+"cette fonction :"
 
 #: library/doctest.rst:1114
 msgid "Set the :mod:`doctest` reporting flags to use."
 msgstr ""
+"Voir les options de ligne de commandes de :mod:`doctest` pour l'utilisation."
 
 #: library/doctest.rst:1116
 msgid ""
 "Argument *flags* takes the :ref:`bitwise OR <bitwise>` of option flags.  See "
 "section :ref:`doctest-options`.  Only \"reporting flags\" can be used."
 msgstr ""
+"L'argument *flags* prend la :ref:`composition OU bit à bit <bitwise>` des "
+"arguments. Voir la section :ref:`doctest-options`. Ce sont uniquement les "
+"\"options de rapport\" qui peuvent être utilisées."
 
 #: library/doctest.rst:1119
 msgid ""
@@ -1221,16 +1825,30 @@ msgid ""
 "were specified when the :class:`DocTestCase` instance was constructed, :mod:"
 "`doctest`'s :mod:`unittest` reporting flags are ignored."
 msgstr ""
+"Ceci est un paramètre au niveau global du module, et affecte tous les futurs "
+"*doctests* exécutés par le module :mod:`unittest` : la méthode :meth:"
+"`runTest` de :class:`DocTestCase` prend en compte les options précisées pour "
+"le cas de test lorsque l'instance de la classe :class:`DocTestCase` a été "
+"construite. Si aucune option de rapport n'a été précisée (ce qui est le cas "
+"typique et attendu), les options de rapport du module :mod:`unitest` de :mod:"
+"`doctest` sont :ref:`<composés avec un OU <bitwise>` vers les options, et "
+"les options obtenues sont passées à l'instance de la classe :class:"
+"`DocTestRunner` créée pour exécuter le *doctest*. Si une seule option de "
+"rapport a été précisée lorsque l'instance de :class:`DocTestCase` a été "
+"construite, les options de rapport du module :mod:`unittest` de :mod:"
+"`doctest` sont ignorées."
 
 #: library/doctest.rst:1130
 msgid ""
 "The value of the :mod:`unittest` reporting flags in effect before the "
 "function was called is returned by the function."
 msgstr ""
+"La valeur prise par les options de rapport de :mod:`unittest` et ce, avant "
+"que la fonction n'ait été appelée, est renvoyée par la fonction."
 
 #: library/doctest.rst:1137
 msgid "Advanced API"
-msgstr ""
+msgstr "API avancé"
 
 #: library/doctest.rst:1139
 msgid ""
@@ -1251,12 +1869,16 @@ msgid ""
 ":class:`Example`: A single Python :term:`statement`, paired with its "
 "expected output."
 msgstr ""
+":class:`Example` : Un unique :term:`statement` Python, pris conjointement "
+"avec sa sortie attendue."
 
 #: library/doctest.rst:1150
 msgid ""
 ":class:`DocTest`: A collection of :class:`Example`\\ s, typically extracted "
 "from a single docstring or text file."
 msgstr ""
+":class:`DocTest` : Une collection de :class:`Example`, habituellement "
+"extraits d'une seule *docstring* ou fichier texte."
 
 #: library/doctest.rst:1153
 msgid ""
@@ -1297,7 +1919,7 @@ msgstr ""
 
 #: library/doctest.rst:1185
 msgid "DocTest Objects"
-msgstr ""
+msgstr "Objets *doctest*"
 
 #: library/doctest.rst:1190
 msgid ""
@@ -1311,6 +1933,8 @@ msgid ""
 ":class:`DocTest` defines the following attributes.  They are initialized by "
 "the constructor, and should not be modified directly."
 msgstr ""
+":class:`DocTest` définit les attributs suivants. Ils sont initialisés par le "
+"constructeur, et ne doivent pas être modifiés directement."
 
 #: library/doctest.rst:1200
 msgid ""
@@ -1354,7 +1978,7 @@ msgstr ""
 
 #: library/doctest.rst:1241
 msgid "Example Objects"
-msgstr ""
+msgstr "Exemples d'objets"
 
 #: library/doctest.rst:1246
 msgid ""
@@ -1417,7 +2041,7 @@ msgstr ""
 
 #: library/doctest.rst:1303
 msgid "DocTestFinder objects"
-msgstr ""
+msgstr "Objets *DocTestFinder*"
 
 #: library/doctest.rst:1308
 msgid ""
@@ -1453,7 +2077,7 @@ msgstr ""
 
 #: library/doctest.rst:1326
 msgid ":class:`DocTestFinder` defines the following method:"
-msgstr ""
+msgstr "La classe :class:`DocTestFinder` définit la méthode suivante :"
 
 #: library/doctest.rst:1331
 msgid ""
@@ -1489,7 +2113,7 @@ msgstr ""
 
 #: library/doctest.rst:1348
 msgid "To find the name of the file containing the object."
-msgstr ""
+msgstr "Afin de trouver le nom du fichier contenant l'objet."
 
 #: library/doctest.rst:1350
 msgid "To help find the line number of the object within its file."
@@ -1516,7 +2140,7 @@ msgstr ""
 
 #: library/doctest.rst:1369
 msgid "DocTestParser objects"
-msgstr ""
+msgstr "Objets *DocTestParser*"
 
 #: library/doctest.rst:1374
 msgid ""
@@ -1524,15 +2148,17 @@ msgid ""
 "use them to create a :class:`DocTest` object."
 msgstr ""
 
-#: library/doctest.rst:1446
+#: library/doctest.rst:1378 library/doctest.rst:1446
 msgid ":class:`DocTestParser` defines the following methods:"
-msgstr ""
+msgstr "La classe :class:`DocTestFinder` définit les méthodes suivantes :"
 
 #: library/doctest.rst:1383
 msgid ""
 "Extract all doctest examples from the given string, and collect them into a :"
 "class:`DocTest` object."
 msgstr ""
+"Extrait tous les exemples de *doctests* à partir de la chaîne de caractère "
+"donnée, et les réunit dans un objet :class:`DocTest`."
 
 #: library/doctest.rst:1386
 msgid ""
@@ -1540,6 +2166,9 @@ msgid ""
 "`DocTest` object.  See the documentation for :class:`DocTest` for more "
 "information."
 msgstr ""
+"Notez que *globs*, *name*, *filname* et *lineno* sont des attributs pour le "
+"nouvel objet :class:`DocTest`. Voir la documentation pour :class:`DocTest` "
+"pour plus d'information."
 
 #: library/doctest.rst:1393
 msgid ""
@@ -1559,7 +2188,7 @@ msgstr ""
 
 #: library/doctest.rst:1409
 msgid "DocTestRunner objects"
-msgstr ""
+msgstr "Objets *DocTestRunner*"
 
 #: library/doctest.rst:1414
 msgid ""
@@ -1632,7 +2261,7 @@ msgid ""
 "should not be called directly."
 msgstr ""
 
-#: library/doctest.rst:1477
+#: library/doctest.rst:1466 library/doctest.rst:1477
 msgid ""
 "*example* is the example about to be processed.  *got* is the actual output "
 "from the example.  *test* is the test containing *example*.  *out* is the "
@@ -1705,7 +2334,7 @@ msgstr ""
 
 #: library/doctest.rst:1525
 msgid "OutputChecker objects"
-msgstr ""
+msgstr "Objets *OutputChecker*"
 
 #: library/doctest.rst:1530
 msgid ""
@@ -1718,7 +2347,7 @@ msgstr ""
 
 #: library/doctest.rst:1537
 msgid ":class:`OutputChecker` defines the following methods:"
-msgstr ""
+msgstr "La classe :class:`OutputChecker` définit les méthodes suivantes :"
 
 #: library/doctest.rst:1541
 msgid ""
@@ -1738,17 +2367,20 @@ msgstr ""
 
 #: library/doctest.rst:1558
 msgid "Debugging"
-msgstr ""
+msgstr "Débogage"
 
 #: library/doctest.rst:1560
 msgid "Doctest provides several mechanisms for debugging doctest examples:"
 msgstr ""
+"*Doctest* fournit plusieurs mécanismes pour déboguer des exemples *doctest* :"
 
 #: library/doctest.rst:1562
 msgid ""
 "Several functions convert doctests to executable Python programs, which can "
 "be run under the Python debugger, :mod:`pdb`."
 msgstr ""
+"Plusieurs fonctions convertissent les *doctests* en programmes Python "
+"exécutables, qui peuvent être exécutés grâce au débogueur Python, :mod:`pdb`."
 
 #: library/doctest.rst:1565
 msgid ""
@@ -1774,7 +2406,7 @@ msgstr ""
 
 #: library/doctest.rst:1588
 msgid "Then an interactive Python session may look like this::"
-msgstr ""
+msgstr "Alors une séance interactive de Python peut ressembler à ceci ::"
 
 #: library/doctest.rst:1621
 msgid ""
@@ -1784,7 +2416,7 @@ msgstr ""
 
 #: library/doctest.rst:1627
 msgid "Convert text with examples to a script."
-msgstr ""
+msgstr "Convertit du texte contenant des exemples en un script."
 
 #: library/doctest.rst:1629
 msgid ""
@@ -1795,8 +2427,8 @@ msgid ""
 msgstr ""
 
 #: library/doctest.rst:1644
-msgid "displays::"
-msgstr ""
+msgid "displays ::"
+msgstr "affiche ::"
 
 #: library/doctest.rst:1654
 msgid ""
@@ -1804,10 +2436,13 @@ msgid ""
 "also be useful when you want to transform an interactive Python session into "
 "a Python script."
 msgstr ""
+"Cette fonction est utilisée à l'interne par d'autres fonctions (voir ci-"
+"bas), mais peut aussi être utile lorsque l'on souhaite transformer une "
+"séance interactive de Python en script Python."
 
 #: library/doctest.rst:1661
 msgid "Convert the doctest for an object to a script."
-msgstr ""
+msgstr "Convertit en script l'objet *doctest*."
 
 #: library/doctest.rst:1663
 msgid ""
@@ -1824,10 +2459,12 @@ msgid ""
 "prints a script version of function :func:`f`'s docstring, with doctests "
 "converted to code, and the rest placed in comments."
 msgstr ""
+"affiche une version script de la *docstring* de la fonction :func:`f`, avec "
+"des *doctests* convertis en code, et le reste dans les commentaires."
 
 #: library/doctest.rst:1679
 msgid "Debug the doctests for an object."
-msgstr ""
+msgstr "Débogue les *doctests* pour un objet."
 
 #: library/doctest.rst:1681
 msgid ""
@@ -1842,6 +2479,8 @@ msgid ""
 "A shallow copy of ``module.__dict__`` is used for both local and global "
 "execution context."
 msgstr ""
+"Une copie superficielle de ``module.__dict__`` est utilisée à la fois pour "
+"les contextes d'exécution locaux et globaux."
 
 #: library/doctest.rst:1689
 msgid ""
@@ -1857,19 +2496,24 @@ msgstr ""
 
 #: library/doctest.rst:1700
 msgid "Debug the doctests in a string."
-msgstr ""
+msgstr "Débogue les *doctests* dans une chaîne de caractères."
 
 #: library/doctest.rst:1702
 msgid ""
 "This is like function :func:`debug` above, except that a string containing "
 "doctest examples is specified directly, via the *src* argument."
 msgstr ""
+"Ceci est similaire à la fonction :func:`debug` décrite ci-haut, mis-à-part "
+"qu'une chaîne de caractères contenant des exemples *doctest* est définie "
+"directement, par l'option *src*."
 
 #: library/doctest.rst:1705
 msgid ""
 "Optional argument *pm* has the same meaning as in function :func:`debug` "
 "above."
 msgstr ""
+"L'option *pm* a la même définition que dans la fonction :func:`debug` ci-"
+"haut."
 
 #: library/doctest.rst:1707
 msgid ""
@@ -1877,6 +2521,10 @@ msgid ""
 "execution context.  If not specified, or ``None``, an empty dictionary is "
 "used. If specified, a shallow copy of the dictionary is used."
 msgstr ""
+"L'option *globs* définit un dictionnaire à utiliser comme contexte "
+"d'exécution global et local. Si elle n'est pas définie, ou si ``None``, un "
+"dictionnaire vide est utilisé. Si définie, une copie superficielle du "
+"dictionnaire est utilisée."
 
 #: library/doctest.rst:1712
 msgid ""
@@ -1902,12 +2550,17 @@ msgid ""
 "documentation for :class:`DocTestRunner` in section :ref:`doctest-advanced-"
 "api`."
 msgstr ""
+"Pour de l'information sur les paramètres et méthodes du constructeur, voir "
+"la documentation pour la classe :class:`DocTestrunner` dans la section :reF:"
+"`doctest-advanced-api`."
 
 #: library/doctest.rst:1730
 msgid ""
 "There are two exceptions that may be raised by :class:`DebugRunner` "
 "instances:"
 msgstr ""
+"Il y a deux exceptions qui peuvent être levées par des instances :class:"
+"`DebugRunner` :"
 
 #: library/doctest.rst:1735
 msgid ""
@@ -1915,22 +2568,28 @@ msgid ""
 "example's actual output did not match its expected output. The constructor "
 "arguments are used to initialize the attributes of the same names."
 msgstr ""
+"Une exception levée par :class:`DocTestRunner` pour signaler que la sortie "
+"obtenue suite à un exemple *doctest* ne correspond pas à la sortie attendue. "
+"Les arguments du constructeur sont utilisés pour initialiser les attributs "
+"des mêmes noms."
 
 #: library/doctest.rst:1739
 msgid ":exc:`DocTestFailure` defines the following attributes:"
-msgstr ""
+msgstr ":exc:`DocTestFailure` définit les attributs suivants :"
 
-#: library/doctest.rst:1768
+#: library/doctest.rst:1744 library/doctest.rst:1768
 msgid "The :class:`DocTest` object that was being run when the example failed."
 msgstr ""
+"L'objet issu de la classe :class:`DocTest` qui était en cours d'exécution "
+"lorsque l'exemple a échoué."
 
-#: library/doctest.rst:1773
+#: library/doctest.rst:1749 library/doctest.rst:1773
 msgid "The :class:`Example` that failed."
-msgstr ""
+msgstr "L'exemple :class:`Example` qui a échoué."
 
 #: library/doctest.rst:1754
 msgid "The example's actual output."
-msgstr ""
+msgstr "La sortie obtenue par l'exécution de l'exemple."
 
 #: library/doctest.rst:1759
 msgid ""
@@ -1938,38 +2597,45 @@ msgid ""
 "example raised an unexpected exception.  The constructor arguments are used "
 "to initialize the attributes of the same names."
 msgstr ""
+"Une exception levée par :class:`DocTestRunner` afin de signaler qu'un "
+"exemple *doctest* a levé une exception inattendue. Les arguments du "
+"constructeur sont utilisés pour initialiser les attributs des mêmes noms."
 
 #: library/doctest.rst:1763
 msgid ":exc:`UnexpectedException` defines the following attributes:"
-msgstr ""
+msgstr ":exc:`UnexpectedException` définit les attributs suivants :"
 
 #: library/doctest.rst:1778
 msgid ""
 "A tuple containing information about the unexpected exception, as returned "
 "by :func:`sys.exc_info`."
 msgstr ""
+"Un n-uplet contenant l'information au sujet de l'exception inattendue, telle "
+"que retourné par :func:`sys.exc_info`."
 
 #: library/doctest.rst:1785
 msgid "Soapbox"
-msgstr ""
+msgstr "Éditorial"
 
 #: library/doctest.rst:1787
 msgid ""
 "As mentioned in the introduction, :mod:`doctest` has grown to have three "
 "primary uses:"
 msgstr ""
+"Comme mentionné dans l'introduction, :mod:`doctest` a présentement trois "
+"usages principaux :"
 
 #: library/doctest.rst:1790
 msgid "Checking examples in docstrings."
-msgstr ""
+msgstr "Vérifier les exemples dans les *docstrings*."
 
 #: library/doctest.rst:1792
 msgid "Regression testing."
-msgstr ""
+msgstr "Test de régression."
 
 #: library/doctest.rst:1794
 msgid "Executable documentation / literate testing."
-msgstr ""
+msgstr "De la documentation exécutable / des tests littéraires."
 
 #: library/doctest.rst:1796
 msgid ""
@@ -2046,6 +2712,11 @@ msgid ""
 "run only the failing doctest while you debug the problem.  Here is a minimal "
 "example of such a test runner::"
 msgstr ""
+"Lorsque vous placez vos tests dans un module, le module lui-même peut être "
+"l'exécuteur de tests. Lorsqu'un test échoue, vous pouvez signifier à votre "
+"exécuteur de tests de rouler une seconde fois uniquement les tests qui "
+"échouent et ce, tant que vous travaillez sur le problème. Voici un exemple "
+"minimal d'un test exécuteur de tests ::"
 
 #: library/doctest.rst:1863
 msgid "Footnotes"
@@ -2057,3 +2728,7 @@ msgid ""
 "Trying to guess where one ends and the other begins is too error-prone, and "
 "that also makes for a confusing test."
 msgstr ""
+"Les exemples contenant à la fois la sortie attendue et une exception ne sont "
+"pas supportés. Tenter de deviner où finit l'un et où commence l'autre peut "
+"mener à plusieurs erreurs, en plus d'être un test qui soit source de "
+"confusion."